Very cool :) I hadn't seen C2 used in anger before, and the flexibility
allowed by the sitemap is impressive. Imagine if this were idiot-proofed and
presented to the world as a spinoff project, how much exposure Cocoon would
get.. ;)
Btw, it would be nice if the build system allowed the user to override
the location of tools.jar in .ant.properties, like Cocoon 2's build.xml
does. Currently, build.xml makes the assumption that $JRE_HOME ==
$JAVA_HOME/jre. This is not true on my Debian system (IBM JDK1.3 debs).
The patch attached allows this, and is documented in ant.properties.sample. Now
I'm off to steal this doc system for my own project ;)
--Jeff
PS: C2's build.xml wrongly assumes System.getProperty("java.home") ==
$JAVA_HOME. I think it's my fault too ;) will patch tomorrow.
On Mon, Jul 23, 2001 at 12:52:21PM -0400, Berin Loritsch wrote:
> The StyleBook is now removed, and all documentation is upgraded
> to the new build process. Also, any subproject that has an entry
> in the ${tools.dir}/lib directory (namely Excalibur, Framework,
> LogKit, and Testlet), the build scripts were altered to copy the
> new version into the tools directory when we build distributions.
>
> Also, has anyone given thought to my proposal to make build "site"
> tags copy the results to the root www directory? It makes running
> cvs update a lot simpler on the server side.
>
> Please cross check all the commits--I have everything working
> locally, but want to make sure I didn't forget to check something
> in.
>
> Lastly, I will eventually automatically generate the new ".uris"
> files, but at this point my time is needed elsewhere.
Index: ant.properties.sample
===================================================================
RCS file: /home/cvspublic/jakarta-avalon/ant.properties.sample,v
retrieving revision 1.1
diff -u -r1.1 ant.properties.sample
--- ant.properties.sample 2001/06/10 03:37:31 1.1
+++ ant.properties.sample 2001/07/24 11:10:10
@@ -1,9 +1,15 @@
-# This file is a sample .ant.properties file used for building ant.
+# 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.
+#
# Modify it for your own needs and copy it to .ant.properties
#
# <-- starts a comment
-# If you want to use the better than average jikes compiler, uncomment the next line
+# If you want to use the better than average jikes compiler, uncomment the next
+# line
#build.compiler=jikes
# To link to local documentation, run the "dist" target for each project and
@@ -13,3 +19,10 @@
#logkit.base=${basedir}/../jakarta-avalon-logkit/dist/docs
#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
Index: build.xml
===================================================================
RCS file: /home/cvspublic/jakarta-avalon/build.xml,v
retrieving revision 1.68
diff -u -r1.68 build.xml
--- build.xml 2001/07/24 10:05:03 1.68
+++ build.xml 2001/07/24 11:10:11
@@ -80,6 +80,8 @@
<property name="dist.name" value="${Name}-${version}"/>
<property name="dist.base" value="distributions"/>
+ <property name="tools.jar" value="${java.home}/../lib/tools.jar"/>
+
<property name="logkit.jar" value="${lib.dir}/logkit-1.0b2.jar"/>
<property name="xerces.jar" value="${tools.dir}/lib/xerces.jar"/>
<property name="xalan.jar" value="${tools.dir}/lib/xalan-2.1.0.jar"/>
@@ -107,7 +109,7 @@
<path id="tools.class.path">
<pathelement location="${xerces.jar}"/>
<pathelement location="${testlet.jar}"/>
- <pathelement location="${java.home}/../lib/tools.jar"/>
+ <pathelement location="${tools.jar}"/>
<fileset dir="${tools.dir}/lib">
<include name="*.jar" />
<exclude name="testlet.jar"/>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
