--- jsr166/build.xml	2009/01/06 16:31:52	1.76
+++ jsr166/build.xml	2012/11/18 06:21:11	1.91
@@ -21,30 +21,34 @@
 
 
   <!-- Compilation options -->
-  <property name="build.sourcelevel"    value="1.5"/>
+  <property name="build.sourcelevel"    value="1.6"/>
   <property name="build.debug"          value="true"/>
   <property name="build.debuglevel"     value="source,lines,vars"/>
   <property name="build.deprecation"    value="false"/>
 
   <!-- Build locations -->
-  <property name="build.dir"            location="build"/>
-  <property name="build.classes.dir"    location="${build.dir}/classes"/>
-  <property name="build.testcases.dir"  location="${build.dir}/testcases"/>
-  <property name="build.loops.dir"      location="${build.dir}/loops"/>
-  <property name="build.lib.dir"        location="${build.dir}/lib"/>
-  <property name="build.javadocs.dir"   location="${build.dir}/javadocs"/>
-  <property name="build.reports.dir"    location="${build.dir}/reports"/>
-  <property name="build.jsr166x.dir"    location="${build.dir}/jsr166x"/>
+  <property name="build.dir"                   location="build"/>
+  <property name="build.classes.dir"           location="${build.dir}/classes"/>
+  <property name="build.testcases.dir"         location="${build.dir}/testcases"/>
+  <property name="build.loops.dir"             location="${build.dir}/loops"/>
+  <property name="build.lib.dir"               location="${build.dir}/lib"/>
+  <property name="build.javadocs.dir"          location="${build.dir}/javadocs"/>
+  <property name="build.reports.dir"           location="${build.dir}/reports"/>
+  <property name="build.jsr166x.dir"           location="${build.dir}/jsr166x"/>
   <property name="build.jsr166xlib.dir"        location="${build.dir}/jsr166xlib"/>
   <property name="build.jsr166xjavadocs.dir"   location="${build.dir}/jsr166xjavadocs"/>
 
-  <property name="build.jsr166y.dir"    location="${build.dir}/jsr166y"/>
+  <property name="build.jsr166y.dir"           location="${build.dir}/jsr166y"/>
   <property name="build.jsr166ylib.dir"        location="${build.dir}/jsr166ylib"/>
   <property name="build.jsr166yjavadocs.dir"   location="${build.dir}/jsr166yjavadocs"/>
 
-  <property name="build.extra166y.dir"    location="${build.dir}/extra166y"/>
-  <property name="build.extra166ylib.dir"        location="${build.dir}/extra166ylib"/>
-  <property name="build.extra166yjavadocs.dir"   location="${build.dir}/extra166yjavadocs"/>
+  <property name="build.jsr166e.dir"           location="${build.dir}/jsr166e"/>
+  <property name="build.jsr166elib.dir"        location="${build.dir}/jsr166elib"/>
+  <property name="build.jsr166ejavadocs.dir"   location="${build.dir}/jsr166ejavadocs"/>
+
+  <property name="build.extra166y.dir"         location="${build.dir}/extra166y"/>
+  <property name="build.extra166ylib.dir"      location="${build.dir}/extra166ylib"/>
+  <property name="build.extra166yjavadocs.dir" location="${build.dir}/extra166yjavadocs"/>
 
   <!-- Source locations -->
   <property name="src.dir"              location="${basedir}/src/main"/>
@@ -57,24 +61,38 @@
   <property name="topsrc.dir"           location="${basedir}/src"/>
   <property name="jsr166xsrc.dir"       location="${basedir}/src/jsr166x"/>
   <property name="jsr166ysrc.dir"       location="${basedir}/src/jsr166y"/>
-  <property name="extra166ysrc.dir"       location="${basedir}/src/extra166y"/>
+  <property name="jsr166esrc.dir"       location="${basedir}/src/jsr166e"/>
+  <property name="extra166ysrc.dir"     location="${basedir}/src/extra166y"/>
+  <property name="jdksrc.dir"           location="/home/dl/1.6.0/j2se/martin/j2se/src/share/classes"/>
 
   <!-- Distribution locations -->
-  <property name="dist.javadocs.dir"    location="${dist.dir}/docs"/>
+  <property name="dist.javadocs.dir"           location="${dist.dir}/docs"/>
   <property name="dist.jsr166xjavadocs.dir"    location="${dist.dir}/jsr166xdocs"/>
   <property name="dist.jsr166yjavadocs.dir"    location="${dist.dir}/jsr166ydocs"/>
-  <property name="dist.extra166yjavadocs.dir"    location="${dist.dir}/extra166ydocs"/>
+  <property name="dist.jsr166ejavadocs.dir"    location="${dist.dir}/jsr166edocs"/>
+  <property name="dist.extra166yjavadocs.dir"  location="${dist.dir}/extra166ydocs"/>
 
   <!-- Jar locations -->
   <property name="product.jar"          location="${build.lib.dir}/jsr166.jar"/>
   <property name="jsr166xproduct.jar"   location="${build.jsr166xlib.dir}/jsr166x.jar"/>
   <property name="jsr166yproduct.jar"   location="${build.jsr166ylib.dir}/jsr166y.jar"/>
-  <property name="extra166yproduct.jar"   location="${build.extra166ylib.dir}/extra166y.jar"/>
+  <property name="jsr166eproduct.jar"   location="${build.jsr166elib.dir}/jsr166e.jar"/>
+  <property name="extra166yproduct.jar" location="${build.extra166ylib.dir}/extra166y.jar"/>
   <property name="junit.jar"            location="${lib.dir}/junit.jar"/>
 
   <!-- Bootclasspath argument -->
   <property name="bootclasspath.args"   value="-Xbootclasspath/p:${product.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 2012-11 -->
+  <!-- <property name="jdkapi8docs.url" value="http://docs.oracle.com/javase/8/docs/api/"/> -->
+  <property name="jdkapidocs.url"       value="${jdkapi7docs.url}"/>
+
   <!-- Test classpath -->
   <path id="test.classpath">
     <pathelement location="${build.testcases.dir}"/>
@@ -89,6 +107,9 @@
 
   <!-- Main targets -->
 
+  <target name="dists"
+          depends="dist, jsr166xdist, jsr166ydist,jsr166edist,  extra166ydist"
+          description="Builds all public jars and docs"/>
 
   <target name="compile"
           depends="init, configure-compiler"
@@ -105,7 +126,7 @@
              fork="true">
 
       <include name="**/*.java"/>
-      <compilerarg value="-XDignore.symbol.file"/>
+      <compilerarg value="-XDignore.symbol.file=true"/>
 
 <!--
       <exclude name="java/lang/**"/>
@@ -145,14 +166,18 @@
     <delete dir="${build.javadocs.dir}"/>
     <mkdir dir="${build.javadocs.dir}"/>
 
-    <javadoc destdir="${build.javadocs.dir}"
-                link="http://java.sun.com/javase/6/docs/api/"
-            overview="${src.dir}/intro.html"
-            sourcepath="${src.dir}:/home/dl/1.6.0/j2se/martin/j2se/src/share/classes"
-    >           
-
-      <packageset dir="${src.dir}"/>
+    <!-- the packagenames="none" hack below prevents scanning the -->
+    <!-- sourcepath for packages -->
 
+    <javadoc destdir="${build.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>
@@ -164,7 +189,6 @@
           description="Puts all distributable products in single hierarchy"/>
 
 
-
   <target name="release"
           depends="dist"
           description="Puts entire CVS tree, plus distribution productions, in a jar">
@@ -211,31 +235,17 @@
     <delete dir="${dist.javadocs.dir}"/>
     <mkdir dir="${dist.javadocs.dir}"/>
 
-    <javadoc destdir="${dist.javadocs.dir}"
-            link="http://java.sun.com/javase/6/docs/api/"
-            overview="${src.dir}/intro.html"
+    <!-- the packagenames="none" hack below prevents scanning the -->
+    <!-- sourcepath for packages -->
 
-            sourcepath="${src.dir}:/home/dl/1.6.0/j2se/martin/j2se/src/share/classes"
-     >
-<!--
-      <packageset dir="${src.dir}" defaultexcludes="yes">
-      <include name="java/util/concurrent"/>
-      <include name="java/util/concurrent/atomic"/>
-      <include name="java/util/concurrent/locks"/>
-      </packageset>
--->
-      <fileset dir="${topsrc.dir}" defaultexcludes="yes">
-      <include name="main/java/util/concurrent/*.java"/>
-      <include name="main/java/util/concurrent/atomic/*.java"/>
-      <include name="main/java/util/concurrent/locks/*.java"/>
-      <include name="main/java/util/*.java"/>
-<!--
-      <include name="main/java/util/concurrent/*.html"/>
-      <include name="main/java/util/concurrent/atomic/*.html"/>
-      <include name="main/java/util/concurrent/locks/*.html"/>
-      <include name="main/java/util/*.html"/>
--->
-<!--      <include name="jsr166x/*.java"/> -->
+    <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>
 
@@ -279,6 +289,7 @@
 
       <compilerarg value="${bootclasspath.args}"/>
       <compilerarg line="${build.args}"/>
+      <compilerarg value="-XDignore.symbol.file=true"/>
 
       <classpath refid="test.classpath"/>
 
@@ -296,6 +307,7 @@
 
       <compilerarg value="${bootclasspath.args}"/>
       <compilerarg line="${build.args}"/>
+      <compilerarg value="-XDignore.symbol.file=true"/>
 
       <classpath refid="test.classpath"/>
 
@@ -312,6 +324,7 @@
 
       <compilerarg value="${bootclasspath.args}"/>
       <compilerarg line="${build.args}"/>
+      <compilerarg value="-XDignore.symbol.file=true"/>
 
       <classpath refid="test.classpath"/>
 
@@ -452,6 +465,7 @@
 
       <compilerarg line="${build.args}"/>
       <classpath refid="loops.classpath"/>
+      <compilerarg value="-XDignore.symbol.file=true"/>
 
     </javac>
 
@@ -481,6 +495,7 @@
 
       <include name="**/*.java"/>
       <compilerarg line="${build.args}"/>
+      <compilerarg value="-XDignore.symbol.file=true"/>
 
     </javac>
 
@@ -509,17 +524,11 @@
     <mkdir dir="${build.jsr166xjavadocs.dir}"/>
 
     <javadoc destdir="${build.jsr166xjavadocs.dir}"
-             link="http://java.sun.com/javase/6/docs/api/"
-
-            sourcepath="${jsr166xsrc.dir}:/home/dl/1.5.0/j2se/martin/j2se/src/share/classes"
-
-    >
-      <packageset dir="${topsrc.dir}" defaultexcludes="yes">
-      <include name="jsr166x"/>
-      </packageset>
-
-
-    </javadoc>
+             packagenames="jsr166x"
+             link="${jdkapidocs.url}"
+             source="${build.sourcelevel}"
+             sourcepath="${topsrc.dir}:${jdksrc.dir}"
+             additionalparam="-XDignore.symbol.file=true" />
 
   </target>
 
@@ -554,14 +563,11 @@
     <mkdir dir="${dist.jsr166xjavadocs.dir}"/>
 
     <javadoc destdir="${dist.jsr166xjavadocs.dir}"
-                link="http://java.sun.com/javase/6/docs/api/"
-              source="${build.sourcelevel}">
-
-      <packageset dir="${topsrc.dir}" defaultexcludes="yes">
-      <include name="jsr166x"/>
-      </packageset>
-
-    </javadoc>
+             packagenames="jsr166x"
+             link="${jdkapidocs.url}"
+             source="${build.sourcelevel}"
+             sourcepath="${topsrc.dir}:${jdksrc.dir}"
+             additionalparam="-XDignore.symbol.file=true" />
 
   </target>
 
@@ -591,6 +597,7 @@
 
       <include name="**/*.java"/>
       <compilerarg line="${build.args}"/>
+      <compilerarg value="-XDignore.symbol.file=true"/>
       <compilerarg value="${bootclasspath.args}"/>
 
 <!--       <compilerarg line="-Xlint -Xmaxwarns 1000"/> -->
@@ -622,16 +629,11 @@
     <mkdir dir="${build.jsr166yjavadocs.dir}"/>
 
     <javadoc destdir="${build.jsr166yjavadocs.dir}"
-                link="http://java.sun.com/javase/6/docs/api/"
-            sourcepath="${jsr166ysrc.dir}:/home/dl/1.5.0/j2se/martin/j2se/src/share/classes"
-
-    >
-      <packageset dir="${topsrc.dir}" defaultexcludes="no">
-      <include name="jsr166y"/>
-      </packageset>
-
-
-    </javadoc>
+             packagenames="jsr166y"
+             link="${jdkapidocs.url}"
+             source="${build.sourcelevel}"
+             sourcepath="${topsrc.dir}:${jdksrc.dir}"
+             additionalparam="-XDignore.symbol.file=true" />
 
   </target>
 
@@ -664,12 +666,11 @@
     <mkdir dir="${dist.jsr166yjavadocs.dir}"/>
 
     <javadoc destdir="${dist.jsr166yjavadocs.dir}"
-                link="http://java.sun.com/javase/6/docs/api/"
-              source="${build.sourcelevel}">
-      <fileset dir="${topsrc.dir}" defaultexcludes="yes">
-      <include name="jsr166y/*.java"/>
-            </fileset>
-    </javadoc>
+             packagenames="jsr166y"
+             link="${jdkapidocs.url}"
+             source="${build.sourcelevel}"
+             sourcepath="${topsrc.dir}:${jdksrc.dir}"
+             additionalparam="-XDignore.symbol.file=true" />
 
   </target>
 
@@ -680,11 +681,12 @@
 
   </target>
 
+
   <!-- extra166y -->
 
 
   <target name="extra166ycompile"
-          depends="init, configure-compiler"
+          depends="init, configure-compiler, jsr166ycompile"
           description="Compiles extra166y sources">
 
     <mkdir dir="${build.extra166y.dir}"/>
@@ -692,6 +694,7 @@
     <javac srcdir="${extra166ysrc.dir}"
           destdir="${build.extra166y.dir}"
             debug="${build.debug}"
+            classpath="${jsr166yproduct.jar}"
        debuglevel="${build.debuglevel}"
       deprecation="${build.deprecation}"
            source="${build.sourcelevel}"
@@ -699,6 +702,7 @@
 
       <include name="**/*.java"/>
       <compilerarg line="${build.args}"/>
+      <compilerarg value="-XDignore.symbol.file=true"/>
       <compilerarg value="${bootclasspath.args}"/>
 
 <!--       <compilerarg line="-Xlint -Xmaxwarns 1000"/> -->
@@ -730,16 +734,11 @@
     <mkdir dir="${build.extra166yjavadocs.dir}"/>
 
     <javadoc destdir="${build.extra166yjavadocs.dir}"
-                link="http://java.sun.com/javase/6/docs/api/"
-            sourcepath="${extra166ysrc.dir}:/home/dl/1.5.0/j2se/martin/j2se/src/share/classes"
-
-    >
-      <packageset dir="${topsrc.dir}" defaultexcludes="no">
-      <include name="extra166y"/>
-      </packageset>
-
-
-    </javadoc>
+             packagenames="extra166y"
+             link="${jdkapidocs.url}"
+             source="${build.sourcelevel}"
+             sourcepath="${topsrc.dir}:${jdksrc.dir}"
+             additionalparam="-XDignore.symbol.file=true" />
 
   </target>
 
@@ -772,12 +771,11 @@
     <mkdir dir="${dist.extra166yjavadocs.dir}"/>
 
     <javadoc destdir="${dist.extra166yjavadocs.dir}"
-                link="http://java.sun.com/javase/6/docs/api/"
-              source="${build.sourcelevel}">
-      <fileset dir="${topsrc.dir}" defaultexcludes="yes">
-      <include name="extra166y/*.java"/>
-            </fileset>
-    </javadoc>
+             packagenames="extra166y"
+             link="${jdkapidocs.url}"
+             source="${build.sourcelevel}"
+             sourcepath="${topsrc.dir}:${jdksrc.dir}"
+             additionalparam="-XDignore.symbol.file=true" />
 
   </target>
 
@@ -788,4 +786,107 @@
 
   </target>
 
+  <!-- jsr166e -->
+
+
+  <target name="jsr166ecompile"
+          depends="init, configure-compiler"
+          description="Compiles jsr166e sources">
+
+    <mkdir dir="${build.jsr166e.dir}"/>
+
+    <javac srcdir="${jsr166esrc.dir}"
+          destdir="${build.jsr166e.dir}"
+            debug="${build.debug}"
+       debuglevel="${build.debuglevel}"
+      deprecation="${build.deprecation}"
+           source="1.7"
+             fork="true">
+
+      <include name="**/*.java"/>
+      <compilerarg line="${build.args}"/>
+      <compilerarg value="-XDignore.symbol.file=true"/>
+      <compilerarg value="${bootclasspath.args}"/>
+
+<!--       <compilerarg line="-Xlint -Xmaxwarns 1000"/> -->
+
+    </javac>
+
+  </target>
+
+
+
+  <target name="jsr166ejar"
+          depends="jsr166ecompile"
+          description="Builds library jar from compiled sources">
+
+    <mkdir dir="${build.jsr166elib.dir}"/>
+
+    <jar destfile="${jsr166eproduct.jar}" index="true">
+      <fileset dir="${build.jsr166e.dir}"/>
+    </jar>
+
+  </target>
+
+
+
+  <target name="jsr166edocs"
+          description="Builds javadocs with custom tags to build folder">
+
+    <delete dir="${build.jsr166ejavadocs.dir}"/>
+    <mkdir dir="${build.jsr166ejavadocs.dir}"/>
+
+    <javadoc destdir="${build.jsr166ejavadocs.dir}"
+             packagenames="jsr166e,jsr166e.extra"
+             link="${jdkapidocs.url}"
+             source="1.7"
+             sourcepath="${topsrc.dir}:${jdksrc.dir}"
+             additionalparam="-XDignore.symbol.file=true" />
+
+  </target>
+
+
+  <target name="jsr166edist"
+          depends="jsr166edist-clean, jsr166edist-jar, jsr166edist-docs"
+          description="Puts all distributable products in single hierarchy"/>
+
+
+
+  <target name="jsr166eclean"
+          description="Removes all build products">
+
+    <delete dir="${build.jsr166e.dir}"/>
+    <delete dir="${build.jsr166elib.dir}"/>
+
+  </target>
+
+
+
+  <target name="jsr166edist-clean"
+          description="Removes all build and distribution products">
+
+  </target>
+
+  <target name="jsr166edist-docs"
+          description="Builds javadocs without custom tags to dist folder">
+
+    <delete dir="${dist.jsr166ejavadocs.dir}"/>
+    <mkdir dir="${dist.jsr166ejavadocs.dir}"/>
+
+    <javadoc destdir="${dist.jsr166ejavadocs.dir}"
+             packagenames="jsr166e,jsr166e.extra"
+             link="${jdkapidocs.url}"
+             source="1.7"
+             sourcepath="${topsrc.dir}:${jdksrc.dir}"
+             additionalparam="-XDignore.symbol.file=true" />
+
+  </target>
+
+  <target name="jsr166edist-jar"
+          depends="jsr166eclean, jsr166ejar">
+
+    <copy file="${jsr166eproduct.jar}" todir="${dist.dir}"/>
+
+  </target>
+
 </project>