--- jsr166/build.xml	2013/07/20 18:26:16	1.148
+++ jsr166/build.xml	2014/06/25 08:29:01	1.156
@@ -16,13 +16,14 @@
   $HOME/jdk/jdk6
   $HOME/jdk/jdk7
   $HOME/jdk/jdk8
+  $HOME/jdk/jdk9
   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
+  $HOME/jdk/src/jdk9
   where each of the above is a complete JDK source tree
   (e.g. mercurial forest) or a symlink to same.
-As of 2013-02, the very latest lambda 8 jdk is needed for jdk8.
 ------------------------------------------------------------------------------
   </description>
 
@@ -45,13 +46,18 @@ As of 2013-02, the very latest lambda 8
   <property name="build.deprecation"    value="false"/>
   <property name="build.javadoc.access" value="protected"/>
 
-  <!-- Tck options; see JSR166TestCase.java -->
-  <!-- ant -Djsr166.profileTests=true -Djsr166.runsPerTest=100 test-tck -->
+  <!-- Tck options; see JSR166TestCase.java
+   Profiling a tck test class:
+   ant -Djsr166.profileTests=true -Djsr166.profileThreshold=100 -Djsr166.tckTestClass=CompletableFutureTest test-tck
+   Stress test a tck test class:
+   ant -Djsr166.tckTestClass=CountedCompleterTest -Djsr166.runsPerTest=100 test-tck
+  -->
   <property name="jsr166.profileTests"     value="false"/>
   <property name="jsr166.profileThreshold" value="100"/>
   <property name="jsr166.runsPerTest"      value="1"/>
-  <!-- Allow running an individual tck test class -->
-  <!-- ant -Djsr166.tckTestClass=CountedCompleterTest -Djsr166.runsPerTest=100 test-tck -->
+  <!-- Stress test an individual tck test class:
+  ant -Djsr166.tckTestClass=CountedCompleterTest -Djsr166.runsPerTest=100 test-tck
+  -->
   <property name="jsr166.tckTestClass"     value="JSR166TestCase"/>
 
   <!-- Build locations -->
@@ -115,6 +121,7 @@ As of 2013-02, the very latest lambda 8
   <defjdklocations v="6"/>
   <defjdklocations v="7"/>
   <defjdklocations v="8"/>
+  <defjdklocations v="9"/>
 
   <!-- Source locations -->
   <property name="src.dir"              location="${basedir}/src/main"/>
@@ -155,17 +162,26 @@ As of 2013-02, the very latest lambda 8
   <property name="extra166y.jar"    location="${build.extra166y.dir}/extra166y.jar"/>
   <property name="junit.jar"        location="${lib.dir}/junit.jar"/>
 
-  <!-- Canonical location of jdk API docs, to use with javadoc link attribute -->
-  <property name="jdkapi5docs.url"      value="http://docs.oracle.com/javase/1.5.0/docs/api/"/>
-  <property name="jdkapi6docs.url"      value="http://docs.oracle.com/javase/6/docs/api/"/>
-  <property name="jdkapi7docs.url"      value="http://docs.oracle.com/javase/7/docs/api/"/>
-
-  <property name="jdkapi8docs.url"      value="http://download.java.net/jdk8/docs/api/"/>
-  <!-- The below does not yet exist as of 2013-01 -->
-  <!-- <property name="jdkapi8docs.url" value="http://docs.oracle.com/javase/8/docs/api/"/> -->
+  <!-- Canonical location of jdk docs root, to use with javadoc -Xdocrootparent flag -->
+  <property name="java5.docroot.url"      value="http://docs.oracle.com/javase/1.5.0/docs"/>
+  <property name="java6.docroot.url"      value="http://docs.oracle.com/javase/6/docs"/>
+  <property name="java7.docroot.url"      value="http://docs.oracle.com/javase/7/docs"/>
+  <!-- The expected canonical location does not yet exist as of 2014-02 -->
+  <!-- <property name="java8.docroot.url" value="http://docs.oracle.com/javase/8/docs"/> -->
+  <property name="java8.docroot.url"      value="http://download.java.net/jdk8/docs"/>
+  <!-- No published jdk9 docs exist as of 2014-02 -->
+  <!-- <property name="java9.docroot.url" value="http://docs.oracle.com/javase/9/docs"/> -->
+  <property name="java9.docroot.url"      value="${java8.docroot.url}"/>
+  <!-- Default jdk doc location (latest stable release seems best) -->
+  <property name="java.docroot.url"       value="${java7.docroot.url}"/>
 
-  <!-- Default jdk api doc location (latest stable release seems best) -->
-  <property name="jdkapidocs.url"       value="${jdkapi7docs.url}"/>
+  <!-- Canonical location of jdk API docs, to use with javadoc link attribute -->
+  <property name="java5.api.url"      value="${java5.docroot.url}/api/"/>
+  <property name="java6.api.url"      value="${java6.docroot.url}/api/"/>
+  <property name="java7.api.url"      value="${java7.docroot.url}/api/"/>
+  <property name="java8.api.url"      value="${java8.docroot.url}/api/"/>
+  <property name="java9.api.url"      value="${java9.docroot.url}/api/"/>
+  <property name="java.api.url"       value="${java.docroot.url}/api/"/>
 
   <!-- Define the "jtreg" task -->
   <!-- See the docs in "jtreg -onlineHelp" -->
@@ -184,7 +200,7 @@ As of 2013-02, the very latest lambda 8
     <attribute name="compile-target" default="@{target}"/>
     <attribute name="workdir"/>
     <attribute name="classes"/>
-    <attribute name="jvmflags" default=""/>
+    <attribute name="jvmflags" default="-ea -esa -Djsr166.testImplementationDetails=true"/>
     <element name="javac-elements" optional="true"/>
     <sequential>
 
@@ -231,6 +247,7 @@ As of 2013-02, the very latest lambda 8
   </macrodef>
 
   <macrodef name="run-jtreg-tests">
+    <!-- ant -Djtreg.src.dir=src/test/jtreg/util/concurrent/CompletableFuture test-jtreg -->
     <attribute name="jtreg.src.dir" default="${jtreg.src.dir}"/>
     <attribute name="source" default="7"/>
     <attribute name="target"/>
@@ -269,6 +286,9 @@ As of 2013-02, the very latest lambda 8
 
   <!-- Main targets -->
 
+  <property name="build.main.java.version" value="9"/>
+  <property name="build.main.javac" value="${javac9}"/>
+
   <target name="dists"
           depends="dist, 4jdk7dist, jsr166edist, jsr166ydist, extra166ydist, jsr166xdist"
           description="Builds all public jars and docs"/>
@@ -287,7 +307,7 @@ As of 2013-02, the very latest lambda 8
            classpath=""
            includeAntRuntime="false"
            includeJavaRuntime="false"
-           executable="${javac8}"
+           executable="${build.main.javac}"
            fork="true">
 
       <include name="**/*.java"/>
@@ -323,15 +343,16 @@ As of 2013-02, the very latest lambda 8
 
     <javadoc destdir="${docs.dir}"
              packagenames="none"
-             link="${jdkapi8docs.url}"
+             link="${java9.api.url}"
              overview="${src.dir}/intro.html"
              access="${build.javadoc.access}"
-             sourcepath="${src.dir}:${jdk8src.dir}"
+             sourcepath="${src.dir}:${jdk9src.dir}"
              classpath=""
-             executable="${javadoc8}">
+             executable="${javadoc9}">
       <fileset dir="${src.dir}" defaultexcludes="yes">
         <include name="**/*.java"/>
       </fileset>
+      <arg line="-Xdocrootparent ${java9.docroot.url}"/>
       <arg line="-Xmaxerrs 1000 -Xmaxwarns 1000"/>
       <arg value="-XDignore.symbol.file=true"/>
       <arg value="-tag"/>
@@ -402,7 +423,7 @@ As of 2013-02, the very latest lambda 8
           description="Runs tck tests for main directly">
 
     <run-tck-tests
-      target="8"
+      target="${build.main.java.version}"
       workdir="${build.dir}"
       classes="${product.jar}"/>
   </target>
@@ -411,7 +432,7 @@ As of 2013-02, the very latest lambda 8
 	  depends="jar"
           description="Runs jtreg tests for main using the jtreg ant task">
     <run-jtreg-tests
-       target="8"
+       target="${build.main.java.version}"
        workdir="${build.dir}"
        classes="${product.jar}"/>
   </target>
@@ -421,6 +442,23 @@ As of 2013-02, the very latest lambda 8
           description="Runs tck and jtreg tests for main">
   </target>
 
+  <target name="test89"
+          description="Runs tck and jtreg tests for main for multiple java versions">
+
+    <antcall target="clean"/>
+    <antcall target="test">
+      <param name="build.main.java.version" value="8"/>
+      <param name="build.main.javac" value="${javac8}"/>
+    </antcall>
+
+    <antcall target="clean"/>
+    <antcall target="test">
+      <param name="build.main.java.version" value="9"/>
+      <param name="build.main.javac" value="${javac9}"/>
+    </antcall>
+
+  </target>
+
 
 
   <target name="configure-compiler">
@@ -500,6 +538,35 @@ As of 2013-02, the very latest lambda 8
     </javac>
   </target>
 
+  <target name="4jdk7doclint"
+          depends="configure-compiler"
+          description="Finds doclint warnings">
+
+    <mkdir dir="${build.4jdk7.classes.dir}"/>
+
+    <javac srcdir="${4jdk7src.dir}"
+           destdir="${build.4jdk7.classes.dir}"
+           debug="${build.debug}"
+           debuglevel="${build.debuglevel}"
+           deprecation="${build.deprecation}"
+           source="6"
+           classpath=""
+           bootclasspath="${bootclasspath7}"
+           includeAntRuntime="false"
+           includeJavaRuntime="false"
+           executable="${javac8}"
+           fork="true">
+
+      <include name="**/*.java"/>
+      <compilerarg value="-Xprefer:source"/>
+      <compilerarg value="-XDignore.symbol.file=true"/>
+      <compilerarg value="-Xlint:all"/>
+      <compilerarg value="-Xdoclint:all/protected"/>
+      <compilerarg line="${build.args}"/>
+
+    </javac>
+  </target>
+
 
   <target name="4jdk7jar"
           depends="4jdk7compile"
@@ -523,6 +590,7 @@ As of 2013-02, the very latest lambda 8
       <javac-elements>
         <!-- JDK8+ test classes -->
         <exclude name="*8Test.java"/>
+        <exclude name="*9Test.java"/>
         <exclude name="DoubleAccumulatorTest.java"/>
         <exclude name="DoubleAdderTest.java"/>
         <exclude name="LongAccumulatorTest.java"/>
@@ -588,7 +656,7 @@ As of 2013-02, the very latest lambda 8
 
     <javadoc destdir="${4jdk7docs.dir}"
              packagenames="none"
-             link="${jdkapi7docs.url}"
+             link="${java7.api.url}"
              overview="${4jdk7src.dir}/intro.html"
              access="${build.javadoc.access}"
              sourcepath="${4jdk7src.dir}:${jdk7src.dir}"
@@ -597,6 +665,7 @@ As of 2013-02, the very latest lambda 8
       <fileset dir="${4jdk7src.dir}" defaultexcludes="yes">
         <include name="**/*.java"/>
       </fileset>
+      <arg line="-Xdocrootparent ${java7.docroot.url}"/>
       <arg value="-XDignore.symbol.file=true"/>
     </javadoc>
   </target>
@@ -676,12 +745,13 @@ As of 2013-02, the very latest lambda 8
 
     <javadoc destdir="${jsr166xdocs.dir}"
              packagenames="jsr166x.*"
-             link="${jdkapidocs.url}"
+             link="${java.api.url}"
              access="${build.javadoc.access}"
              sourcepath="${topsrc.dir}:${jdk6src.dir}"
              bootclasspath="${bootclasspath6}"
              source="5"
              executable="${javadoc7}">
+      <arg line="-Xdocrootparent ${java.docroot.url}"/>
       <arg value="-XDignore.symbol.file=true"/>
 
     </javadoc>
@@ -761,12 +831,13 @@ As of 2013-02, the very latest lambda 8
 
     <javadoc destdir="${jsr166ydocs.dir}"
              packagenames="jsr166y.*"
-             link="${jdkapidocs.url}"
+             link="${java.api.url}"
              access="${build.javadoc.access}"
              sourcepath="${topsrc.dir}:${jdk6src.dir}"
              bootclasspath="${bootclasspath6}"
              source="6"
              executable="${javadoc7}">
+      <arg line="-Xdocrootparent ${java.docroot.url}"/>
       <arg value="-XDignore.symbol.file=true"/>
 
     </javadoc>
@@ -847,12 +918,13 @@ As of 2013-02, the very latest lambda 8
 
     <javadoc destdir="${extra166ydocs.dir}"
              packagenames="extra166y.*"
-             link="${jdkapidocs.url}"
+             link="${java.api.url}"
              access="${build.javadoc.access}"
              sourcepath="${topsrc.dir}:${jdk6src.dir}"
              bootclasspath="${bootclasspath6}"
              source="6"
              executable="${javadoc7}">
+      <arg line="-Xdocrootparent ${java.docroot.url}"/>
       <arg value="-XDignore.symbol.file=true"/>
 
     </javadoc>
@@ -913,6 +985,32 @@ As of 2013-02, the very latest lambda 8
     </javac>
   </target>
 
+  <!-- jsr166e: find doclint errors -->
+  <target name="jsr166edoclint">
+
+    <mkdir dir="${build.jsr166e.classes.dir}"/>
+
+    <javac srcdir="${topsrc.dir}"
+           destdir="${build.jsr166e.classes.dir}"
+           debug="${build.debug}"
+           debuglevel="${build.debuglevel}"
+           deprecation="${build.deprecation}"
+           source="${build.jsr166e.java.version}"
+           classpath=""
+           bootclasspath="${bootclasspath7}"
+           includeAntRuntime="false"
+           includeJavaRuntime="false"
+           executable="${javac8}"
+           fork="true">
+
+      <include name="jsr166e/**/*.java"/>
+      <compilerarg value="-XDignore.symbol.file=true"/>
+      <compilerarg value="-Xlint:all"/>
+      <compilerarg value="-Xdoclint:all/protected"/>
+
+    </javac>
+  </target>
+
 
   <target name="jsr166ejar"
           depends="jsr166ecompile"
@@ -933,11 +1031,12 @@ As of 2013-02, the very latest lambda 8
 
     <javadoc destdir="${jsr166edocs.dir}"
              packagenames="jsr166e.*"
-             link="${jdkapidocs.url}"
+             link="${java.api.url}"
              access="${build.javadoc.access}"
              sourcepath="${topsrc.dir}:${jdk6src.dir}"
              source="${build.jsr166e.java.version}"
              executable="${javadoc7}">
+      <arg line="-Xdocrootparent ${java.docroot.url}"/>
       <arg value="-XDignore.symbol.file=true"/>
 
     </javadoc>