--- jsr166/build.xml	2013/01/15 01:15:02	1.97
+++ jsr166/build.xml	2013/01/19 17:15:44	1.100
@@ -8,6 +8,20 @@
 
   User-specific settings are read from user.properties.
   See user.properties.sample for an explanation of some useful settings.
+
+  The repository contains all dependencies except for ant and the JDK
+  itself.  Because the JDK version matters and because different
+  targets require different JDKs, we assume that users have created a
+  hierarchy containing:
+  $HOME/jdk/jdk6
+  $HOME/jdk/jdk7
+  $HOME/jdk/jdk8
+  where each of the above is a JDK or a symlink to same, and
+  $HOME/jdk/src/jdk6
+  $HOME/jdk/src/jdk7
+  $HOME/jdk/src/jdk8
+  where each of the above is a complete JDK source tree
+  (e.g. mercurial forest) or a symlink to same.
 ------------------------------------------------------------------------------
   </description>
 
@@ -35,11 +49,11 @@
   <property name="build.javadocs.dir"          location="${build.dir}/javadocs"/>
   <property name="build.reports.dir"           location="${build.dir}/reports"/>
 
-  <property name="build.jdk7.dir"              location="${build.dir}/jdk7"/>
-  <property name="build.jdk7.lib.dir"          location="${build.jdk7.dir}"/>
-  <property name="build.jdk7.classes.dir"      location="${build.jdk7.dir}/classes"/>
-  <property name="build.jdk7.tck.classes.dir"  location="${build.jdk7.dir}/tck/classes"/>
-  <property name="build.jdk7.docs.dir"         location="${build.jdk7.dir}/docs"/>
+  <property name="build.4jdk7.dir"              location="${build.dir}/4jdk7"/>
+  <property name="build.4jdk7.lib.dir"          location="${build.4jdk7.dir}"/>
+  <property name="build.4jdk7.classes.dir"      location="${build.4jdk7.dir}/classes"/>
+  <property name="build.4jdk7.tck.classes.dir"  location="${build.4jdk7.dir}/tck/classes"/>
+  <property name="build.4jdk7.docs.dir"         location="${build.4jdk7.dir}/docs"/>
 
   <property name="build.jsr166x.dir"           location="${build.dir}/jsr166x"/>
   <property name="build.jsr166xlib.dir"        location="${build.dir}/jsr166xlib"/>
@@ -63,11 +77,12 @@
   <macrodef name="defjdklocations">
     <attribute name="v"/>
     <sequential>
-    <property name="jdk@{v}.home"  location="${jdks.home}/jdk@{v}"/>
-    <property name="java@{v}"      location="${jdk@{v}.home}/bin/java"/>
-    <property name="javac@{v}"     location="${jdk@{v}.home}/bin/javac"/>
-    <property name="javadoc@{v}"   location="${jdk@{v}.home}/bin/javadoc"/>
-    <property name="bootdir@{v}"   location="${jdk@{v}.home}/jre/lib"/>
+    <property name="jdk@{v}.home"   location="${jdks.home}/jdk@{v}"/>
+    <property name="java@{v}"       location="${jdk@{v}.home}/bin/java"/>
+    <property name="javac@{v}"      location="${jdk@{v}.home}/bin/javac"/>
+    <property name="javadoc@{v}"    location="${jdk@{v}.home}/bin/javadoc"/>
+    <property name="bootdir@{v}"    location="${jdk@{v}.home}/jre/lib"/>
+    <property name="jdk@{v}src.dir" location="${jdks.home}/src/jdk@{v}/jdk/src/share/classes"/>
     <property name="bootclasspath@{v}"
      value="${bootdir@{v}}/resources.jar:${bootdir@{v}}/rt.jar:${bootdir@{v}}/jsse.jar:${bootdir@{v}}/jce.jar:${bootdir@{v}}/:${bootdir@{v}}/charsets.jar"/>
     </sequential>
@@ -104,7 +119,7 @@
   <property name="lib.dir"              location="${basedir}/lib"/>
   <property name="dist.dir"             location="${basedir}/dist"/>
   <property name="topsrc.dir"           location="${basedir}/src"/>
-  <property name="jdk7src.dir"          location="${topsrc.dir}/jdk7"/>
+  <property name="4jdk7src.dir"         location="${topsrc.dir}/jdk7"/>
   <property name="jsr166xsrc.dir"       location="${topsrc.dir}/jsr166x"/>
   <property name="jsr166ysrc.dir"       location="${topsrc.dir}/jsr166y"/>
   <property name="jsr166esrc.dir"       location="${topsrc.dir}/jsr166e"/>
@@ -113,7 +128,7 @@
 
   <!-- Distribution locations -->
   <property name="dist.javadocs.dir"           location="${dist.dir}/docs"/>
-  <property name="dist.jdk7.docs.dir"          location="${dist.dir}/jsr166-jdk7docs"/>
+  <property name="dist.4jdk7.docs.dir"         location="${dist.dir}/jsr166-4jdk7docs"/>
   <property name="dist.jsr166xjavadocs.dir"    location="${dist.dir}/jsr166xdocs"/>
   <property name="dist.jsr166yjavadocs.dir"    location="${dist.dir}/jsr166ydocs"/>
   <property name="dist.jsr166ejavadocs.dir"    location="${dist.dir}/jsr166edocs"/>
@@ -121,7 +136,7 @@
 
   <!-- Jar locations -->
   <property name="product.jar"          location="${build.lib.dir}/jsr166.jar"/>
-  <property name="jdk7product.jar"      location="${build.jdk7.lib.dir}/jsr166-jdk7.jar"/>
+  <property name="4jdk7product.jar"     location="${build.4jdk7.lib.dir}/jsr166-4jdk7.jar"/>
   <property name="jsr166xproduct.jar"   location="${build.jsr166xlib.dir}/jsr166x.jar"/>
   <property name="jsr166yproduct.jar"   location="${build.jsr166ylib.dir}/jsr166y.jar"/>
   <property name="jsr166eproduct.jar"   location="${build.jsr166elib.dir}/jsr166e.jar"/>
@@ -152,6 +167,11 @@
     <pathelement location="${build.loops.dir}"/>
   </path>
 
+  <!-- Support @jls tag, used in jdk8+ javadoc -->
+  <!-- TODO: How do we get &trade to work? -->
+  <!--   property name="javadoc.jls.cite" value="The Java&trade; Language Specification" -->
+  <property name="javadoc.jls.cite" value="The Java Language Specification"/>
+  <property name="javadoc.jls.option" value="jls:a:See &lt;cite&gt;${javadoc.jls.cite}&lt;/cite&gt;:"/>
 
   <!-- Main targets -->
 
@@ -160,21 +180,26 @@
           description="Builds all public jars and docs"/>
 
   <target name="compile"
-          depends="init, configure-compiler"
-          description="Compiles main sources to build folder">
+          depends="configure-compiler"
+          description="Compiles src/main sources to build folder">
 
     <mkdir dir="${build.classes.dir}"/>
 
     <javac srcdir="${src.dir}"
-          destdir="${build.classes.dir}"
-            debug="${build.debug}"
-       debuglevel="${build.debuglevel}"
-      deprecation="${build.deprecation}"
-           source="${build.sourcelevel}"
-             fork="true">
+           destdir="${build.classes.dir}"
+           debug="${build.debug}"
+           debuglevel="${build.debuglevel}"
+           deprecation="${build.deprecation}"
+           classpath=""
+           includeAntRuntime="false"
+           includeJavaRuntime="false"
+           executable="${javac8}"
+           fork="true">
 
       <include name="**/*.java"/>
+      <compilerarg line="${build.args}"/>
       <compilerarg value="-XDignore.symbol.file=true"/>
+      <compilerarg value="-Xlint:all"/>
 
 <!--
       <exclude name="java/lang/**"/>
@@ -209,20 +234,24 @@
 
 
   <target name="docs"
-          description="Builds javadocs with custom tags to build folder">
+          description="Builds javadocs for src/main">
 
-    <delete dir="${build.javadocs.dir}"/>
-    <mkdir dir="${build.javadocs.dir}"/>
+    <delete dir="${dist.javadocs.dir}"/>
+    <mkdir dir="${dist.javadocs.dir}"/>
 
     <!-- the packagenames="none" hack below prevents scanning the -->
     <!-- sourcepath for packages -->
 
-    <javadoc destdir="${build.javadocs.dir}"
+    <javadoc destdir="${dist.javadocs.dir}"
              packagenames="none"
-             link="${jdkapidocs.url}"
+             link="${jdkapi8docs.url}"
              overview="${src.dir}/intro.html"
-             sourcepath="${src.dir}:${jdksrc.dir}"
-             additionalparam="-XDignore.symbol.file=true" >
+             sourcepath="${src.dir}:${jdk8src.dir}"
+             classpath=""
+             executable="${javadoc8}">
+      <arg value="-XDignore.symbol.file=true"/>
+      <arg value="-tag"/>
+      <arg value="${javadoc.jls.option}"/>
       <fileset dir="${src.dir}" defaultexcludes="yes">
         <include name="**/*.java"/>
       </fileset>
@@ -233,7 +262,7 @@
 
 
   <target name="dist"
-          depends="init, dist-clean, dist-jar, dist-docs"
+          depends="init, dist-clean, dist-jar, docs"
           description="Puts all distributable products in single hierarchy"/>
 
 
@@ -277,30 +306,6 @@
 
 
 
-  <target name="dist-docs"
-          description="Builds javadocs without custom tags to dist folder">
-
-    <delete dir="${dist.javadocs.dir}"/>
-    <mkdir dir="${dist.javadocs.dir}"/>
-
-    <!-- the packagenames="none" hack below prevents scanning the -->
-    <!-- sourcepath for packages -->
-
-    <javadoc destdir="${dist.javadocs.dir}"
-             packagenames="none"
-             link="${jdkapidocs.url}"
-             overview="${src.dir}/intro.html"
-             sourcepath="${src.dir}:${jdksrc.dir}"
-             additionalparam="-XDignore.symbol.file=true" >
-      <fileset dir="${src.dir}" defaultexcludes="yes">
-        <include name="**/*.java"/>
-      </fileset>
-    </javadoc>
-
-  </target>
-
-
-
   <!-- Internal targets -->
 
 
@@ -524,17 +529,17 @@
   </target>
 
 
-  <!-- jdk7 -->
+  <!-- jsr166 4jdk7 -->
 
 
-  <target name="jdk7compile"
+  <target name="4jdk7compile"
           depends="configure-compiler"
-          description="Compiles src/jdk7 sources">
+          description="Compiles src/jdk7 sources, targeting jdk7">
 
-    <mkdir dir="${build.jdk7.classes.dir}"/>
+    <mkdir dir="${build.4jdk7.classes.dir}"/>
 
-    <javac srcdir="${jdk7src.dir}"
-           destdir="${build.jdk7.classes.dir}"
+    <javac srcdir="${4jdk7src.dir}"
+           destdir="${build.4jdk7.classes.dir}"
            debug="${build.debug}"
            debuglevel="${build.debuglevel}"
            deprecation="${build.deprecation}"
@@ -553,22 +558,22 @@
 
     </javac>
 
-    <mkdir dir="${build.jdk7.lib.dir}"/>
+    <mkdir dir="${build.4jdk7.lib.dir}"/>
 
-    <jar destfile="${jdk7product.jar}" index="true">
-      <fileset dir="${build.jdk7.classes.dir}"/>
+    <jar destfile="${4jdk7product.jar}" index="true">
+      <fileset dir="${build.4jdk7.classes.dir}"/>
     </jar>
 
-    <mkdir dir="${build.jdk7.tck.classes.dir}"/>
+    <mkdir dir="${build.4jdk7.tck.classes.dir}"/>
 
     <javac srcdir="${tck.src.dir}"
-           destdir="${build.jdk7.tck.classes.dir}"
+           destdir="${build.4jdk7.tck.classes.dir}"
            debug="${build.debug}"
            debuglevel="${build.debuglevel}"
            deprecation="${build.deprecation}"
            source="1.6"
            classpath="${junit.jar}"
-           bootclasspath="${jdk7product.jar}:${bootclasspath6}"
+           bootclasspath="${4jdk7product.jar}:${bootclasspath6}"
            includeAntRuntime="false"
            includeJavaRuntime="false"
            executable="${javac7}"
@@ -584,18 +589,19 @@
   </target>
 
 
-  <target name="run-jdk7-tck-tests"
-	  depends="jdk7compile"
-          description="Runs tck tests for jsr166-jdk7 directly">
+  <target name="4jdk7-test-tck"
+	  depends="4jdk7compile"
+          description="Runs tck tests for jsr166-4jdk7 directly">
     <run-tck-tests
       jvm="${java7}"
-      tck.classes="${build.jdk7.tck.classes.dir}"
-      product.jar="${jdk7product.jar}"/>
+      tck.classes="${build.4jdk7.tck.classes.dir}"
+      product.jar="${4jdk7product.jar}"/>
   </target>
 
 
-  <target name="run-jdk7-tck-tests-via-junit-task"
-          depends="jdk7compile">
+  <target name="4jdk7-test-tck-junit"
+          depends="4jdk7compile"
+          description="Runs tck tests for jsr166-4jdk7 via junit task (experimental)">
 
     <junit printsummary="true"
            showoutput="true"
@@ -605,12 +611,12 @@
            jvm="${java7}"
            fork="true">
 
-      <jvmarg value="-Xbootclasspath/p:${jdk7product.jar}"/>
+      <jvmarg value="-Xbootclasspath/p:${4jdk7product.jar}"/>
       <jvmarg value="-server"/>
 
       <classpath>
         <pathelement location="${junit.jar}"/>
-        <pathelement location="${build.jdk7.tck.classes.dir}"/>
+        <pathelement location="${build.4jdk7.tck.classes.dir}"/>
       </classpath>
 
       <formatter type="brief"/>
@@ -622,23 +628,21 @@
   </target>
 
 
-  <target name="jdk7docs"
+  <target name="4jdk7docs"
           description="Builds javadocs with custom tags to build folder">
 
-    <delete dir="${build.jdk7.docs.dir}"/>
-    <mkdir dir="${build.jdk7.docs.dir}"/>
+    <delete dir="${build.4jdk7.docs.dir}"/>
+    <mkdir dir="${build.4jdk7.docs.dir}"/>
 
-    <javadoc destdir="${build.jdk7.docs.dir}"
+    <javadoc destdir="${build.4jdk7.docs.dir}"
              packagenames="none"
              link="${jdkapi7docs.url}"
-             overview="${jdk7src.dir}/intro.html"
-             sourcepath="${jdk7src.dir}"
-             bootclasspath="${bootclasspath6}"
+             overview="${4jdk7src.dir}/intro.html"
+             sourcepath="${4jdk7src.dir}:${jdk7src.dir}"
              classpath=""
-             source="1.6"
-             executable="${javadoc7}"
-             additionalparam="-XDignore.symbol.file=true" >
-      <fileset dir="${jdk7src.dir}" defaultexcludes="yes">
+             executable="${javadoc7}">
+      <arg value="-XDignore.symbol.file=true"/>
+      <fileset dir="${4jdk7src.dir}" defaultexcludes="yes">
         <include name="**/*.java"/>
       </fileset>
     </javadoc>
@@ -646,53 +650,51 @@
   </target>
 
 
-  <target name="jdk7dist"
-          depends="jdk7dist-clean, jdk7dist-jar, jdk7dist-docs"
+  <target name="4jdk7dist"
+          depends="4jdk7dist-clean, 4jdk7dist-jar, 4jdk7dist-docs"
           description="Puts all distributable products in single hierarchy"/>
 
 
 
-  <target name="jdk7clean"
+  <target name="4jdk7clean"
           description="Removes all build products">
 
-    <delete dir="${build.jdk7.dir}"/>
+    <delete dir="${build.4jdk7.dir}"/>
 
   </target>
 
 
 
-  <target name="jdk7dist-clean"
+  <target name="4jdk7dist-clean"
           description="Removes all build and distribution products">
 
   </target>
 
-  <target name="jdk7dist-docs"
+  <target name="4jdk7dist-docs"
           description="Builds javadocs without custom tags to dist folder">
 
-    <delete dir="${dist.jdk7.docs.dir}"/>
-    <mkdir dir="${dist.jdk7.docs.dir}"/>
+    <delete dir="${dist.4jdk7.docs.dir}"/>
+    <mkdir dir="${dist.4jdk7.docs.dir}"/>
 
-    <javadoc destdir="${dist.jdk7.docs.dir}"
+    <javadoc destdir="${dist.4jdk7.docs.dir}"
              packagenames="none"
              link="${jdkapi7docs.url}"
-             overview="${jdk7src.dir}/intro.html"
-             sourcepath="${jdk7src.dir}"
+             overview="${4jdk7src.dir}/intro.html"
+             sourcepath="${4jdk7src.dir}:${jdk7src.dir}"
              classpath=""
-             executable="${javadoc7}"
-             bootclasspath="${bootclasspath6}"
-             source="1.6">
+             executable="${javadoc7}">
       <arg value="-XDignore.symbol.file=true"/>
-      <fileset dir="${jdk7src.dir}" defaultexcludes="yes">
+      <fileset dir="${4jdk7src.dir}" defaultexcludes="yes">
         <include name="**/*.java"/>
       </fileset>
     </javadoc>
 
   </target>
 
-  <target name="jdk7dist-jar"
-          depends="jdk7clean, jdk7compile">
+  <target name="4jdk7dist-jar"
+          depends="4jdk7clean, 4jdk7compile">
 
-    <copy file="${jdk7product.jar}" todir="${dist.dir}"/>
+    <copy file="${4jdk7product.jar}" todir="${dist.dir}"/>
 
   </target>
 
@@ -1061,7 +1063,7 @@
              packagenames="jsr166e,jsr166e.extra"
              link="${jdkapi7docs.url}"
              source="1.7"
-             sourcepath="${topsrc.dir}:${jdk7src.dir}:${jdksrc.dir}"
+             sourcepath="${topsrc.dir}:${jdk7src.dir}"
              executable="${javadoc7}"
              additionalparam="-XDignore.symbol.file=true" >
       <fileset dir="${topsrc.dir}" defaultexcludes="yes">