--- jsr166/build.xml	2002/12/12 23:50:31	1.15
+++ jsr166/build.xml	2003/03/14 04:14:07	1.21
@@ -1,16 +1,33 @@
-<project name="jsr166" default="jar">
+<project name="jsr166" default="usage">
 
   <description>
-
     Build file for JSR-166
 
-    Note that junit.jar must be in ${ant.home}/lib for the
-    test target to work. [FIXME: This should be automatically
-    enforced by this build file by failing with a message if
-    junit.jar is not in the right place.]
-
+    JUnit 1.8 must be in ${ant.home}/lib for the test target to work.
   </description>
 
+
+  <target name="usage" description="Prints this message">
+    <echo>
+ant [target], where target is one of:
+
+ usage       (default) Prints this message
+ compile     Compiles all sources to build folder
+ jar         Builds library jar from compiled sources
+ test        Runs all tests (requires JUnit 1.8 in ${ant.home}/lib)
+ docs        Builds javadocs with custom tags to build folder
+ dist-docs   Builds javadocs without custom tags to dist folder
+ dist        Puts all distributable products in single hierarchy
+
+ clean       Removes all build products
+ dist-clean  Removes all build and distribution products
+
+ checkstyle  Reports on style errors in Java source (verbose, mostly chaff)
+ doccheck    Reports on javadoc style errors (not working yet)
+    </echo>
+  </target>
+
+
   <!-- Compilation options -->
   <property name="build.sourcelevel"    value="1.5"/>
   <property name="build.debug"          value="true"/>
@@ -27,7 +44,9 @@
   <property name="build.lib.dir"        location="${build.dir}/lib"/>
   <property name="build.ant.dir"        location="${build.dir}/ant"/>
   <property name="build.javadocs.dir"   location="${build.dir}/javadocs"/>
+  <property name="build.stripped.dir"   location="${build.dir}/stripped"/>
   <property name="build.reports.dir"    location="${build.dir}/reports"/>
+  <property name="build.doccheck.dir"   location="${build.dir}/doccheck"/>
   <property name="build.filter.src.dir" location="${build.dir}/filtersrc"/>
 
   <!-- Source locations -->
@@ -92,20 +111,37 @@
   </target>
 
 
-  <target name="test" depends="init, report-tests"
-          description="Runs all tests"/>
+  <target name="test" depends="init, check-junit, report-tests"
+          description="Runs all tests (requires JUnit 1.8 in ${ant.home}/lib)"/>
 
 
-  <target name="checkstyle" depends="init, clean-filtered-src, filter-src">
+  <target name="checkstyle" depends="filter-src"
+          description="Reports on style errors in Java source (verbose, mostly chaff)">
     <taskdef resource="checkstyletask.properties"
             classpath="${lib.dir}/checkstyle-all-2.4.jar"/>
 
     <checkstyle>
+      <formatter type="plain"/>  <!-- also available: type="xml" -->
       <fileset dir="${build.filter.src.dir}" includes="**/*.java"/>
     </checkstyle>
   </target>
 
-  <target name="docs" depends="init, clean-filtered-src, filter-src"
+
+  <target name="doccheck" depends="filter-src"
+          description="Reports on javadoc style errors (not working yet)">
+    <delete dir="${build.doccheck.dir}"/>
+    <mkdir dir="${build.doccheck.dir}"/>
+    <javadoc doclet="com.sun.tools.doclets.doccheck.DocCheck"
+         docletpath="${lib.dir}/doccheck.jar"
+            destdir="${build.doccheck.dir}">
+      <packageset dir="${build.filter.src.dir}">
+        <include name="java/**"/>
+      </packageset>
+    </javadoc>
+  </target>
+
+
+  <target name="docs" depends="filter-src"
           description="Builds javadocs with custom tags to build folder">
     <delete dir="${build.javadocs.dir}"/>
     <mkdir dir="${build.javadocs.dir}"/>
@@ -126,7 +162,28 @@
   </target>
 
 
-  <target name="dist" depends="init, dist-clean, dist-jar, dist-docs"/>
+  <target name="strip" depends="init">
+    <mkdir dir="${build.stripped.dir}"/>
+    <javac srcdir="${src.dir}"
+          destdir="${build.stripped.dir}"
+            debug="${build.debug}"
+       debuglevel="${build.debuglevel}"
+      deprecation="${build.deprecation}"
+           source="${build.sourcelevel}"
+             fork="true">
+
+      <bootclasspath refid="javac.bootclasspath"/>
+      <compilerarg line="${javac.args} ${build.warnings.option} -s"/>
+
+      <!-- need this because srcdir is basedir! -->
+      <include name="java/**/*.java"/>
+
+    </javac>
+  </target>
+
+
+  <target name="dist" depends="init, dist-clean, dist-jar, dist-docs"
+          description="Puts all distributable products in single hierarchy"/>
 
 
   <target name="clean"
@@ -146,8 +203,7 @@
   <!-- Anthill targets -->
 
   <!-- Should really run the tests instead of just the jar target -->
-  <target name="anthill-build" depends="jar, docs, dist-docs"
-          description="Build the jar and both the external and internal docs"/>
+  <target name="anthill-build" depends="jar, docs, dist-docs"/>
 
   <target name="anthill-publish">
     <copy todir="${deployDir}/docs/private">
@@ -156,6 +212,11 @@
     <copy todir="${deployDir}/docs/public">
       <fileset dir="${dist.javadocs.dir}"/>
     </copy>
+    <copy tofile="${deployDir}/index.html"
+          file="${basedir}/etc/anthill-index.html"/>
+    <copy todir="${deployDir}/notes">
+      <fileset dir="${basedir}/etc/notes"/>
+    </copy>
   </target>
 
 
@@ -165,10 +226,12 @@
     <property name="build.warnings.option" value="-warnunchecked"/>
   </target>
 
+
   <target name="set-warnings-unless" unless="build.warnings">
     <property name="build.warnings.option" value=""/>
   </target>
 
+
   <target name="init" depends="set-warnings-if, set-warnings-unless">
     <!-- Version is kept in a separate file -->
     <loadfile property="version" srcFile="version.properties"/>
@@ -176,17 +239,12 @@
   </target>
 
 
-  <target name="clean-filtered-src">
-    <delete dir="${build.filter.src.dir}"/>
-  </target>
-
-
   <target name="dist-jar" depends="clean, jar">
     <copy file="${product.jar}" todir="${dist.dir}"/>
   </target>
 
 
-  <target name="dist-docs" depends="clean-filtered-src, filter-src"
+  <target name="dist-docs" depends="filter-src"
           description="Builds javadocs without custom tags to dist folder">
     <delete dir="${dist.javadocs.dir}"/>
     <mkdir dir="${dist.javadocs.dir}"/>
@@ -203,7 +261,7 @@
   </target>
 
 
-  <target name="compile-ant-filter">
+  <target name="compile-ant-filter" depends="init">
     <mkdir dir="${build.ant.dir}"/>
     <javac srcdir="${ant.src.dir}"
           destdir="${build.ant.dir}"
@@ -266,7 +324,6 @@
       <bootclasspath refid="javac.bootclasspath"/>
       <compilerarg line="${javac.args} ${build.warnings.option}"/>
       <classpath refid="test.classpath"/>
-      <include name="**/*Test.java"/>
 
     </javac>
   </target>
@@ -281,12 +338,11 @@
                     dir="${build.reports.dir}"
                    fork="true">
 
-      <jvmarg value="-Xbootclasspath/p:${product.jar}"/>
-
-      <classpath>
-        <!-- <path refid="test.classpath"/> -->
-        <pathelement location="${build.testcases.dir}"/>
-      </classpath>
+      <!--
+       ! This nastiness is so JUnit can test classes we are inserting
+       ! into the java.* packages.
+       -->
+      <jvmarg value="-Xbootclasspath/p:${product.jar};${build.testcases.dir};${junit.jar}"/>
 
       <formatter type="xml"/>
 
@@ -323,4 +379,12 @@
   </target>
 
 
+  <target name="check-junit">
+    <!-- FIXME: this test isn't specific enough -->
+    <available property="junit.available"
+               classname="junit.framework.TestCase"/>
+    <fail message="Need JUnit 3.8 to run tests" unless="junit.available"/>
+  </target>
+
+
 </project>