--- jsr166/build.xml	2014/06/16 18:01:38	1.155
+++ jsr166/build.xml	2014/10/03 23:18:13	1.159
@@ -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>
 
@@ -46,13 +50,15 @@
   <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
+   To profile a single tck test class:
+   ant -Djsr166.profileTests=true -Djsr166.profileThreshold=100 -Djsr166.tckTestClass=CompletableFutureTest test-tck
+   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"/>
-  <!-- Allow running an individual tck test class -->
-  <!-- ant -Djsr166.tckTestClass=CountedCompleterTest -Djsr166.runsPerTest=100 test-tck -->
   <property name="jsr166.tckTestClass"     value="JSR166TestCase"/>
 
   <!-- Build locations -->
@@ -161,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/"/>