I just finished converting all of Aaron's JCS documents to xdoc format. While doing this, I also created the start of a stratum xdoc hierarchy. This includes Jason's description of stratum from last week's status update, and all of the JCS documentation that I converted.
Attached to this email is a tarball of the xdoc directory I built and patches for build.xml, deps.list, and default.properties. The patch to build.xml adds the 'docs' target which has the DVSL task that generates the docs and copy task to copy all images over to the output directory. The default.properties patch adds dvsl and velocity jars. I used the latest version of DVSL (0.40) so I could use the 'force' attribute in the DVSL task which forces all of the docs to be built all of the time. Unlike, Anakia, if you modify the project.xml file, the other pages are not automatically regenerated. The patch for deps.list adds dvsl and velocity to the list of dependencies. If someone could update the dvsl jar on the turbine site, that would be appreciated. Finally, if someone wants to preview the stratum documentation, you can check it out on my home site at: http://www.kazmier.com/~kaz/stratum Thanks! Pete
Index: build.xml
===================================================================
RCS file: /home/cvspublic/jakarta-turbine-stratum/build.xml,v
retrieving revision 1.20
diff -u -r1.20 build.xml
--- build.xml 14 Feb 2002 20:42:44 -0000 1.20
+++ build.xml 16 Feb 2002 05:37:07 -0000
@@ -34,6 +34,8 @@
<pathelement location="${jaxp.jar}"/>
<pathelement location="${crimson.jar}"/>
<pathelement location="${xmlrpc.jar}"/>
+ <pathelement location="${dvsl.jar}"/>
+ <pathelement location="${velocity.jar}"/>
<pathelement location="${build.dest}"/>
<!-- AspectJ Jars for non-invasive use of aspects
@@ -275,6 +277,40 @@
description="==> ">
</target>
+ <!-- ================================================================== -->
+ <!-- D V S L D O C U M E N T A T I O N -->
+ <!-- ================================================================== -->
+
+ <target
+ name="docs">
+
+ <taskdef name="dvsl" classname="org.apache.tools.dvsl.DVSLTask">
+ <classpath>
+ <path refid="classpath"/>
+ </classpath>
+ </taskdef>
+
+ <!-- Make sure the target directory -->
+ <mkdir dir="${docs.dest}"/>
+ <dvsl
+ basedir="${docs.src}"
+ destdir="${docs.dest}/"
+ force="true"
+ extension=".html"
+ toolboxfile="${docs.src}/toolbox.props"
+ style="${docs.src}/stylesheets/site.dvsl"
+ excludes="**/project.xml,**/template.xml"
+ includes="**/*.xml"
+ />
+
+ <copy todir="${docs.dest}/images" filtering="no">
+ <fileset dir="${docs.src}/images">
+ <include name="**/*.gif"/>
+ <include name="**/*.jpeg"/>
+ <include name="**/*.jpg"/>
+ </fileset>
+ </copy>
+ </target>
<!-- ================================================================== -->
<!-- J A V A D O C S -->
Index: default.properties
===================================================================
RCS file: /home/cvspublic/jakarta-turbine-stratum/default.properties,v
retrieving revision 1.18
diff -u -r1.18 default.properties
--- default.properties 14 Feb 2002 20:42:44 -0000 1.18
+++ default.properties 16 Feb 2002 05:37:32 -0000
@@ -49,6 +49,8 @@
concurrent.jar = ${lib.repo}/concurrent.jar
dom4j.jar = ${lib.repo}/dom4j-1.1.jar
junit.jar = ${lib.repo}/junit-3.7.jar
+dvsl.jar = ${lib.repo}/velocity-dvsl-0.40.jar
+velocity.jar = ${lib.repo}/velocity-1.3-dev.jar
# These are required by jcs
jgl.jar = ${lib.repo}/jgl3.1.0.jar
stratum-xdoc.tgz
Description: GNU Zip compressed data
Index: deps.list =================================================================== RCS file: /home/cvspublic/jakarta-turbine-stratum/deps.list,v retrieving revision 1.7 diff -u -r1.7 deps.list --- deps.list 13 Feb 2002 19:13:59 -0000 1.7 +++ deps.list 16 Feb 2002 06:04:18 -0000 @@ -18,3 +18,5 @@ jisp_1_0_2.jar hsqldb.jar xmlrpc.jar +velocity-1.3-dev.jar +velocity-dvsl-0.40.jar
-- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
