--- jsr166/build.xml	2014/06/25 08:29:01	1.156
+++ jsr166/build.xml	2015/05/20 06:13:09	1.164
@@ -24,6 +24,10 @@
   $HOME/jdk/src/jdk9
   where each of the above is a complete JDK source tree
   (e.g. mercurial forest) or a symlink to same.
+
+  Alternatively, define ant variables thus:
+  ant -Djdk$N.home=...
+  for $N in 6 7 8 9 ...
 ------------------------------------------------------------------------------
   </description>
 
@@ -47,17 +51,14 @@
   <property name="build.javadoc.access" value="protected"/>
 
   <!-- Tck options; see JSR166TestCase.java
-   Profiling a tck test class:
+   To profile a single tck test class:
    ant -Djsr166.profileTests=true -Djsr166.profileThreshold=100 -Djsr166.tckTestClass=CompletableFutureTest test-tck
-   Stress test a tck test class:
+   To stress test a single 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"/>
-  <!-- Stress test an individual tck test class:
-  ant -Djsr166.tckTestClass=CountedCompleterTest -Djsr166.runsPerTest=100 test-tck
-  -->
   <property name="jsr166.tckTestClass"     value="JSR166TestCase"/>
 
   <!-- Build locations -->
@@ -166,14 +167,12 @@
   <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="java8.docroot.url"      value="http://docs.oracle.com/javase/8/docs"/>
+  <!-- The expected canonical location does not yet exist as of 2014-07 -->
   <!-- <property name="java9.docroot.url" value="http://docs.oracle.com/javase/9/docs"/> -->
-  <property name="java9.docroot.url"      value="${java8.docroot.url}"/>
+  <property name="java9.docroot.url"      value="http://download.java.net/jdk9/docs"/>
   <!-- Default jdk doc location (latest stable release seems best) -->
-  <property name="java.docroot.url"       value="${java7.docroot.url}"/>
+  <property name="java.docroot.url"       value="${java8.docroot.url}"/>
 
   <!-- Canonical location of jdk API docs, to use with javadoc link attribute -->
   <property name="java5.api.url"      value="${java5.docroot.url}/api/"/>
@@ -214,7 +213,6 @@
            source="@{compile-target}"
            target="@{compile-target}"
            classpath="${junit.jar}"
-           bootclasspath="@{classes}:${bootclasspath@{compile-target}}"
            includeAntRuntime="false"
            includeJavaRuntime="false"
            executable="${javac@{compile-target}}"
@@ -223,6 +221,7 @@
       <include name="*.java"/>
       <compilerarg value="-XDignore.symbol.file=true"/>
       <compilerarg value="-Xlint:all,-unchecked,-rawtypes,-serial,-deprecation"/>
+      <compilerarg value="-Xbootclasspath/p:@{classes}"/>
       <compilerarg line="${build.args}"/>
       <javac-elements/>
 
@@ -234,6 +233,12 @@
           fork="true">
 	<jvmarg value="-Xbootclasspath/p:@{classes}"/>
 	<jvmarg line="@{jvmflags}"/>
+
+        <!-- ant -Djava.util.concurrent.ForkJoinPool.common.parallelism=1 test-tck -->
+	<syspropertyset id="java.util.concurrent.ForkJoinPool-properties">
+	  <propertyref prefix="java.util.concurrent.ForkJoinPool"/>
+	</syspropertyset>
+
         <sysproperty key="jsr166.profileTests"     value="${jsr166.profileTests}"/>
         <sysproperty key="jsr166.profileThreshold" value="${jsr166.profileThreshold}"/>
         <sysproperty key="jsr166.runsPerTest"      value="${jsr166.runsPerTest}"/>
@@ -314,6 +319,7 @@
       <compilerarg value="-Xprefer:source"/>
       <compilerarg value="-XDignore.symbol.file=true"/>
       <compilerarg value="-Xlint:all"/>
+      <compilerarg value="-Werror"/>
       <compilerarg value="-Xdoclint:all/protected"/>
       <compilerarg line="-Xmaxerrs 1000 -Xmaxwarns 1000"/>
       <compilerarg line="${build.args}"/>
@@ -417,7 +423,7 @@
     <mirror-dir src="${docs.dir}" dst="${dist.docs.dir}"/>
   </target>
 
-
+  <target name="tck" depends="test-tck" description="alias for test-tck"/>
   <target name="test-tck"
 	  depends="jar"
           description="Runs tck tests for main directly">
@@ -428,6 +434,21 @@
       classes="${product.jar}"/>
   </target>
 
+  <target name="test-tck-parallelism-1"
+          description="Runs test-tck with given common pool parallelism">
+    <antcall target="test-tck">
+      <param name="java.util.concurrent.ForkJoinPool.common.parallelism" value="1"/>
+    </antcall>
+  </target>
+
+  <target name="test-tck-parallelism-0"
+          description="Runs test-tck with given common pool parallelism">
+    <antcall target="test-tck">
+      <param name="java.util.concurrent.ForkJoinPool.common.parallelism" value="0"/>
+    </antcall>
+  </target>
+
+  <target name="jtreg" depends="test-jtreg" description="alias for test-jtreg"/>
   <target name="test-jtreg"
 	  depends="jar"
           description="Runs jtreg tests for main using the jtreg ant task">
@@ -438,7 +459,7 @@
   </target>
 
   <target name="test"
-          depends="test-tck, test-jtreg"
+          depends="test-tck, test-tck-parallelism-1, test-jtreg"
           description="Runs tck and jtreg tests for main">
   </target>
 
@@ -533,6 +554,7 @@
       <compilerarg value="-Xprefer:source"/>
       <compilerarg value="-XDignore.symbol.file=true"/>
       <compilerarg value="-Xlint:all"/>
+      <compilerarg value="-Werror"/>
       <compilerarg line="${build.args}"/>
 
     </javac>
@@ -720,6 +742,7 @@
       <include name="jsr166x/**/*.java"/>
       <compilerarg value="-XDignore.symbol.file=true"/>
       <compilerarg value="-Xlint:all,-unchecked,-rawtypes"/>
+      <compilerarg value="-Werror"/>
       <compilerarg line="${build.args}"/>
 
     </javac>
@@ -806,6 +829,7 @@
       <include name="jsr166y/**/*.java"/>
       <compilerarg value="-XDignore.symbol.file=true"/>
       <compilerarg value="-Xlint:all"/>
+      <compilerarg value="-Werror"/>
       <compilerarg line="${build.args}"/>
 
     </javac>
@@ -893,6 +917,7 @@
       <include name="extra166y/**/*.java"/>
       <compilerarg value="-XDignore.symbol.file=true"/>
       <compilerarg value="-Xlint:all,-unchecked,-rawtypes,-serial"/>
+      <compilerarg value="-Werror"/>
       <compilerarg line="${build.args}"/>
 
     </javac>
@@ -980,6 +1005,7 @@
       <include name="jsr166e/**/*.java"/>
       <compilerarg value="-XDignore.symbol.file=true"/>
       <compilerarg value="-Xlint:all"/>
+      <compilerarg value="-Werror"/>
       <compilerarg line="${build.args}"/>
 
     </javac>
@@ -1006,6 +1032,7 @@
       <include name="jsr166e/**/*.java"/>
       <compilerarg value="-XDignore.symbol.file=true"/>
       <compilerarg value="-Xlint:all"/>
+      <compilerarg value="-Werror"/>
       <compilerarg value="-Xdoclint:all/protected"/>
 
     </javac>
@@ -1109,6 +1136,13 @@
 
   <target name="lint">
     <antcall target="dists">
+      <param name="build.javadoc.access" value="public"/>
+    </antcall>
+  </target>
+
+<!-- Generates all doclint warnings, even for private methods (rarely useful) -->
+  <target name="lint-private">
+    <antcall target="dist">
       <param name="build.javadoc.access" value="private"/>
     </antcall>
   </target>