Jon Stevens wrote:

> > btw. why do we not use the ant -projecthelp feature instead of having a usage
> > task?
>
> probably because at the time Ant didn't have that feature. submit a patch.

ok, here it is ... i can commit it if ther is no -1?

martin


Index: ./build/build-turbine.xml
===================================================================
RCS file: /products/cvs/turbine/turbine/build/build-turbine.xml,v
retrieving revision 1.60
diff -u -r1.60 build-turbine.xml
--- ./build/build-turbine.xml 2001/01/08 23:59:02 1.60
+++ ./build/build-turbine.xml 2001/01/15 21:54:09
@@ -57,24 +57,7 @@
     <!-- Help on usage                                                      -->
     <!-- ================================================================== -->
     <target name="usage">
-        <echo message=""/>
-        <echo message="Turbine build file"/>
-        <echo
message="-------------------------------------------------------------"/>
-        <echo message=""/>
-        <echo message=" available targets are:"/>
-        <echo message=""/>
-        <echo message="   compile      --> compiles the source code"/>
-        <echo message="   jar          --> generates the turbine.jar file
(default)"/>
-        <echo message="   jarsrc       --> generates the turbine.src.jar file
containing source only"/>
-        <echo message="   pool         --> generates the turbine-pool.jar file for
connection pools"/>
-        <echo message="   docs         --> generates the HTML documentation"/>
-        <echo message="   javadocs     --> generates the API documentation"/>
-        <echo message="   package-zip  --> generates the Turbine distribution as
.zip"/>
-        <echo message="   package-tgz  --> generates the Turbine distribution as
.tar.gz"/>
-        <echo message="   run-tests    --> runs all available testcases"/>
-        <echo message="   torque       --> generates the torque distribution"/>
-        <echo message="   clean        --> cleans up the build directory"/>
-        <echo message=""/>
+        <echo message="use -projecthelp to see the available targets"/>
     </target>

     <!-- ================================================================== -->
@@ -173,7 +156,9 @@
     <!-- ================================================================== -->
     <!-- Compiles the source directory                                      -->
     <!-- ================================================================== -->
-    <target name="compile" depends="prepare, prepare-jsp, prepare-freemarker">
+    <target name="compile"
+            depends="prepare, prepare-jsp, prepare-freemarker"
+            description="--> compiles the source code">
         <javac srcdir="${build.src}"
             destdir="${build.dest}"
             excludes="**/package.html"
@@ -192,7 +177,9 @@
     <!-- ================================================================== -->
     <!-- Compiles the source directory and creates a .jar file              -->
     <!-- ================================================================== -->
-    <target name="jar" depends="compile">
+    <target name="jar"
+            depends="compile"
+            description="--> generates the turbine.jar file (default)">
         <jar jarfile="${build.dir}/${final.name}.jar"
             basedir="${build.dest}"
             excludes="**/package.html"/>
@@ -201,7 +188,9 @@
     <!-- ================================================================== -->
     <!-- jars the source directory                                          -->
     <!-- ================================================================== -->
-    <target name="jarsrc" depends="prepare">
+    <target name="jarsrc"
+            depends="prepare"
+            description="--> generates the turbine.src.jar file containing source
only">
         <jar jarfile="${build.dir}/${final.name}.src.jar"
             basedir="${build.src}"
             excludes="**/package.html"/>
@@ -210,7 +199,9 @@
     <!-- ================================================================== -->
     <!-- Creates the API documentation                                      -->
     <!-- ================================================================== -->
-    <target name="javadocs" depends="prepare">
+    <target name="javadocs"
+            depends="prepare"
+            description="--> generates the API documentation">
         <mkdir dir="${javadoc.destdir}"/>
         <javadoc
             sourcepath="${build.src}"
@@ -259,7 +250,9 @@
     <!-- ================================================================== -->
     <!-- Packages the distribution with ZIP                                 -->
     <!-- ================================================================== -->
-    <target name="package-zip" depends="package">
+    <target name="package-zip"
+            depends="package"
+            description="--> generates the Turbine distribution as .zip">
         <delete file="../${Name}-${version}.zip"/>
         <zip zipfile="../${Name}-${version}.zip" basedir="../"
includes="**/${final.name}/**"/>
     </target>
@@ -267,7 +260,9 @@
     <!-- ================================================================== -->
     <!-- Packages the distribution with TAR-GZIP                            -->
     <!-- ================================================================== -->
-    <target name="package-tgz" depends="package">
+    <target name="package-tgz"
+            depends="package"
+            description="--> generates the Turbine distribution as .tar.gz">
         <delete file="../${Name}-${version}.tar"/>
         <delete file="../${Name}-${version}.tar.gz"/>
         <tar tarfile="../${Name}-${version}.tar" basedir="../"
includes="**/${final.name}/**"/>
@@ -277,7 +272,9 @@
     <!-- ================================================================== -->
     <!-- Packages the distribution with ZIP and TAG-GZIP                    -->
     <!-- ================================================================== -->
-    <target name="package-all" depends="package-zip, package-tgz">
+    <target name="package-all"
+            depends="package-zip, package-tgz"
+            description="--> generates the .tar.gz and .zip distributions">
     </target>

     <!-- ================================================================== -->
@@ -289,7 +286,7 @@
     <!-- ================================================================== -->
     <!-- Cleans up the build directory                                      -->
     <!-- ================================================================== -->
-    <target name="clean">
+    <target name="clean" description="--> cleans up the build directory">
         <delete dir="${build.dir}"/>
     </target>

@@ -298,7 +295,9 @@
     <!-- ================================================================== -->
     <!-- Creates a turbine-pool.jar file for connection pools               -->
     <!-- ================================================================== -->
-    <target name="pool" depends="compile">
+    <target name="pool"
+            depends="compile"
+            description="--> generates the turbine-pool.jar file for connection
pools">
         <ant antfile="build-turbine-pool.xml">
             <property name="build.dir" value="${build.dir}"/>
             <property name="build.dest" value="${build.dest}"/>
@@ -309,7 +308,9 @@
     <!-- ================================================================== -->
     <!-- Make Turbine documentation                                         -->
     <!-- ================================================================== -->
-    <target name="docs" depends="env">
+    <target name="docs"
+            depends="env"
+            description="--> generates the HTML documentation">
         <java classname="${doc.generator}" fork="yes">
             <arg line="targetDirectory=${turbine.docs}
${turbine.xdocs}/site-book.xml ${turbine.skin}"/>
             <classpath refid="classpath"/>
@@ -324,7 +325,8 @@
     <!-- ================================================================== -->
     <!-- Run testcases                                                      -->
     <!-- ================================================================== -->
-    <target name="run-tests" depends="compile-tests" if="junit.present">
+    <target name="run-tests" depends="compile-tests" if="junit.present"
+            description="--> runs all available testcases">
         <junit printsummary="no" haltonfailure="yes">
             <classpath>
                 <pathelement location="${build.dest}"/>
@@ -362,8 +364,10 @@
     <!-- ================================================================== -->
     <!-- Create torque.jar for stand-alone use outside the context          -->
     <!-- of the TDK.                                                        -->
-    <!-- ================================================================== -->
-    <target name="torque" depends="compile">
+    <!-- ================================================================== -->
+    <target name="torque"
+            depends="compile"
+            description="--> generates the torque distribution">
         <ant antfile="build-torque.xml">
           <property name="build.dir" value="${build.dir}"/>
         </ant>

The command completed successfully.



------------------------------------------------------------
To subscribe:        [EMAIL PROTECTED]
To unsubscribe:      [EMAIL PROTECTED]
Search: <http://www.mail-archive.com/turbine%40list.working-dogs.com/>
Problems?:           [EMAIL PROTECTED]

Reply via email to