You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@avalon.apache.org by do...@apache.org on 2001/11/24 13:36:43 UTC
cvs commit: jakarta-avalon-phoenix ant.properties.sample BUILDING.txt
donaldp 01/11/24 04:36:43
Modified: . ant.properties.sample BUILDING.txt
Log:
Update docs re how-to build phoenix.
Revision Changes Path
1.4 +38 -24 jakarta-avalon-phoenix/ant.properties.sample
Index: ant.properties.sample
===================================================================
RCS file: /home/cvs/jakarta-avalon-phoenix/ant.properties.sample,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ant.properties.sample 2001/11/11 00:38:10 1.3
+++ ant.properties.sample 2001/11/24 12:36:43 1.4
@@ -1,17 +1,45 @@
-# This file is a sample .ant.properties file used for building Avalon. It
-# allows variables defined in build.xml to be overridden according to users'
-# specific needs. As build.xml has sensible defaults, this file's use is only
-# required for those with unusual systems. However it also allows some nice
-# documentation tweaks, so is worth reviewing.
+# -----------------------------------------------------------------------------
+# ant.properties.sample
#
-# Modify it for your own needs and copy it to .ant.properties
+# This is an example ".ant.properties" file, used to customize building Phoenix
+# for your local environment. It defines the location of all external
+# modules that Phoenix depends on. Copy this file to ".ant.properties"
+# in the top-level source directory, and customize it as needed.
#
-# <-- starts a comment
+# $Id: ant.properties.sample,v 1.4 2001/11/24 12:36:43 donaldp Exp $
+# -----------------------------------------------------------------------------
-# If you want to use the better than average jikes compiler, uncomment the next
-# line
-#build.compiler=jikes
+# ----- Compile Environment Flags -----
+#build.compiler=jikes #uncomment to use the jikes compiler
+# ----- Compile Control Flags -----
+build.debug=on
+build.deprecation=off
+build.optimize=on
+
+# ----- Default Base Path for Dependent Packages -----
+base.path=/usr/local
+
+# ----- Xerces XML Parser, version 1.4.3 or later -----
+#xerces.home=${base.path}/xerces-1_4_3
+#xerces.lib=${xerces.home}
+#xerces.jar=${xerces.lib}/xerces.jar
+
+# ----- Java Management Extensions (JMX) RI, version 1.0.1 or later -----
+jmx.home=${base.path}/jmx-ri_1.0.1/jmx
+jmx.lib=${jmx.home}/lib
+jmxri.jar=${jmx.lib}/jmxri.jar
+jmxtools.jar=${jmx.lib}/jmxtools.jar
+
+# ----- Javac tools.jar -----
+# The path to tools.jar, required for building the docs. Most people won't need
+# to set this, unless $JRE_HOME is not equal to $JAVA_HOME/jre. For example, on
+# Debian, IBM's j2sdk1.3 .deb puts the JRE in /usr/lib/j2sdk1.3, # and the JDK
+# in /usr/lib/j2re1.3, requiring the variable to be set. Note: ${java.home} is
+# the JRE home, not $JAVA_HOME.
+tools.jar=${java.home}/../j2sdk1.3/lib/tools.jar
+
+# ----- Javac tools.jar -----
# To link to local documentation, run the "dist" target for each project and
# uncomment and customize the following variables.
#avalon.base=${basedir}/dist/docs
@@ -21,17 +49,3 @@
#cornerstone.base=${basedir}/../jakarta-avalon-cornerstone/dist/docs
#testlet.base=${basedir}/../jakarta-avalon-testlet/dist/docs
-# The path to tools.jar, required for building the docs. Most people won't need
-# to set this, unless $JRE_HOME is not equal to $JAVA_HOME/jre. For example, on
-# Debian, IBM's j2sdk1.3 .deb puts the JRE in /usr/lib/j2sdk1.3, # and the JDK
-# in /usr/lib/j2re1.3, requiring the variable to be set. Note: ${java.home} is
-# the JRE home, not $JAVA_HOME.
-#tools.jar=${java.home}/../j2sdk1.3/lib/tools.jar
-
-#tools.jar=../jakarta-avalon/tools
-
-# The directory containing the xerces.jar file
-#xerces.dir=${tools.dir}/lib
-
-# The xerces.jar filename
-#xerces.file=xerces.jar
1.3 +24 -1 jakarta-avalon-phoenix/BUILDING.txt
Index: BUILDING.txt
===================================================================
RCS file: /home/cvs/jakarta-avalon-phoenix/BUILDING.txt,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- BUILDING.txt 2001/11/10 10:29:46 1.2
+++ BUILDING.txt 2001/11/24 12:36:43 1.3
@@ -64,7 +64,30 @@
* Unpack the reference implementation into a convenient location so that
it resides in its own subdirectory.
-(3) Build A Binary Distribution
+(3) Customize Build Properties For This Subproject
+
+Most Jakarta subprojects allow you to customize Ant properties (with default
+values defined in the "build.xml" file. This is done by creating a text file
+named ".ant.properties" in the source distribution directory (for property
+definitions local to this subproject) and/or your user home directory (for
+property definitions shared across subprojects). You can use the included
+"ant.properties.sample" file as a starting point for this.
+
+Phoenix has a few external dependencies that are satisfied by configuring
+appropriate values in your <code>.ant.properties</code> file. The easiest
+way to satisfy these dependencies is to copy the "ant.properties.sample"
+file (in the top-level Phoenix source directory) to ".ant.properties", and
+then edit it to suit your environment. On Unix, this would be done as:
+
+ cd ${tomcat.source}
+ cp ant.properties.sample .ant.properties
+ emacs .ant.properties
+
+NOTE: Be *sure* that you do not check "ant.properties" in to the CVS
+repository. This file is local to your own development environment, and
+each developer will have their own version.
+
+(4) Build A Binary Distribution
Open a command line shell, and issue the following commands:
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>