/[cvs]/jsr166/build.xml
ViewVC logotype

Diff of /jsr166/build.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.54 by tim, Mon Sep 1 04:09:57 2003 UTC revision 1.306 by jsr166, Sun Oct 6 18:23:18 2019 UTC
# Line 1  Line 1 
1  <project name="jsr166" default="usage">  <project name="jsr166" default="usage"
2      xmlns:if="ant:if"
3      xmlns:unless="ant:unless"
4      xmlns:ivy="antlib:org.apache.ivy.ant">
5    
6    <description>    <description>
7  ------------------------------------------------------------------------------  ------------------------------------------------------------------------------
# Line 6  Line 9 
9    
10    Usage: ant [target]    Usage: ant [target]
11    
12      See http://gee.cs.oswego.edu/dl/concurrency-interest/index.html for
13      more details.
14    
15    User-specific settings are read from user.properties.    User-specific settings are read from user.properties.
16    See user.properties.sample for an explanation of some useful settings.    See user.properties.sample for an explanation of some useful settings.
17    
18      The repository contains all dependencies except for ant and the JDK
19      itself.  Because the JDK version matters and because different
20      targets require different JDKs, we assume that users have created a
21      hierarchy containing:
22      $HOME/jdk/jdk11
23      $HOME/jdk/jdk12
24      $HOME/jdk/jdk13
25      $HOME/jdk/jdk14
26      where each of the above is a JDK or a symlink to same, and
27      $HOME/jdk/src/jdk11
28      $HOME/jdk/src/jdk12
29      $HOME/jdk/src/jdk13
30      $HOME/jdk/src/jdk14
31      where each of the above is a JDK source tree or a symlink to same.
32    
33      Alternatively, define ant variables thus:
34      ant -Djdk$N.home=... -Djdk$N.src.home=...
35      for $N in 11 .. 14 ...
36    
37      As of 2016-03, the sources in src/main are for jdk9+ only.
38      As of 2019-08, the sources in src/main are for jdk11+ only.
39      As of 2019-10, compatibility support for jdk8 is dropped entirely.
40  ------------------------------------------------------------------------------  ------------------------------------------------------------------------------
41    </description>    </description>
42    
43    <target name="usage" description="Advises user to run with -projecthelp">    <!-- Run 'ant -projecthelp' (default target) -->
44      <echo>Run "ant -projecthelp" for full usage information.</echo>    <target name="usage">
45        <java classname="org.apache.tools.ant.Main">
46          <arg value="-projecthelp" />
47        </java>
48    </target>    </target>
49    
50      <!-- HOWTO printf debug: <echo message="prop=${prop}"/> -->
51    
52    <!-- User-specific settings -->    <!-- User-specific settings -->
53    <property file="user.properties"/>    <property file="user.properties"/>
54    
55    
56    <!-- Compilation options -->    <!-- Compilation options -->
   <property name="build.sourcelevel"    value="1.5"/>  
   <property name="build.docsourcelevel" value="1.4"/>  
57    <property name="build.debug"          value="true"/>    <property name="build.debug"          value="true"/>
58    <property name="build.debuglevel"     value="source,lines,vars"/>    <property name="build.debuglevel"     value="source,lines,vars"/>
59    <property name="build.deprecation"    value="false"/>    <property name="build.deprecation"    value="false"/>
60      <property name="build.javadoc.access" value="protected"/>
61    
62    <!-- Build locations -->    <!-- Build locations -->
63    <property name="build.dir"            location="build"/>    <property name="build.dir"                   location="build"/>
64    <property name="build.classes.dir"    location="${build.dir}/classes"/>    <property name="build.classes.dir"           location="${build.dir}/classes"/>
65    <property name="build.emulation.dir"  location="${build.dir}/emulation"/>    <property name="build.testcases.dir"         location="${build.dir}/testcases"/>
66    <property name="build.testcases.dir"  location="${build.dir}/testcases"/>    <property name="build.loops.dir"             location="${build.dir}/loops"/>
67    <property name="build.lib.dir"        location="${build.dir}/lib"/>  
68    <property name="build.ant.dir"        location="${build.dir}/ant"/>    <!-- JDK locations -->
69    <property name="build.javadocs.dir"   location="${build.dir}/javadocs"/>    <property name="jdks.home"  location="${user.home}/jdk"/>
70    <property name="build.sinjdocs.dir"   location="${build.dir}/sinjdocs"/>  
71    <property name="build.stripped.dir"   location="${build.dir}/stripped"/>    <macrodef name="defjdklocations">
72    <property name="build.reports.dir"    location="${build.dir}/reports"/>      <attribute name="v"/>
73    <property name="build.doccheck.dir"   location="${build.dir}/doccheck"/>      <sequential>
74    <property name="build.filter.src.dir" location="${build.dir}/filtersrc"/>      <property name="jdk@{v}.home"     location="${jdks.home}/jdk@{v}"/>
75    <property name="build.filter.doccheck.dir" location="${build.dir}/filterdocchk"/>      <property name="java@{v}"         location="${jdk@{v}.home}/bin/java"/>
76        <property name="javac@{v}"        location="${jdk@{v}.home}/bin/javac"/>
77        <property name="javadoc@{v}"      location="${jdk@{v}.home}/bin/javadoc"/>
78        <property name="jdk@{v}.src.home" location="${jdks.home}/src/jdk@{v}"/>
79        <property name="jdk@{v}.src.dir"  location="${jdk@{v}.src.home}/jdk/src/java.base/share/classes"/>
80        </sequential>
81      </macrodef>
82    
83      <macrodef name="mirror-dir">
84        <attribute name="src"/>
85        <attribute name="dst"/>
86        <sequential>
87        <delete dir="@{dst}"/>
88        <mkdir dir="@{dst}"/>
89        <copy todir="@{dst}" preservelastmodified="true">
90          <fileset dir="@{src}"/>
91        </copy>
92        </sequential>
93      </macrodef>
94    
95      <defjdklocations v="11"/>
96      <defjdklocations v="12"/>
97      <defjdklocations v="13"/>
98      <defjdklocations v="14"/>
99    
100    <!-- Source locations -->    <!-- Source locations -->
101    <property name="src.dir"              location="${basedir}/src/main"/>    <property name="src.dir"              location="${basedir}/src/main"/>
   <property name="emulation.src.dir"    location="${basedir}/src/emulation"/>  
102    <property name="test.src.dir"         location="${basedir}/src/test"/>    <property name="test.src.dir"         location="${basedir}/src/test"/>
103    <property name="ant.src.dir"          location="${basedir}/etc/ant"/>    <property name="loops.src.dir"        location="${basedir}/src/loops"/>
104    <property name="stylesheet.dir"       location="${basedir}/etc/xsl"/>    <property name="tck.src.dir"          location="${test.src.dir}/tck"/>
105      <property name="jtreg11.src.dir"      location="${test.src.dir}/jtreg"/>
106      <property name="jtreg12.src.dir"      location="${test.src.dir}/jtreg"/>
107      <property name="jtreg13.src.dir"      location="${test.src.dir}/jtreg"/>
108      <property name="jtreg14.src.dir"      location="${test.src.dir}/jtreg"/>
109      <property name="jtreg.src.dir"        location="${jtreg11.src.dir}"/>
110    <property name="lib.dir"              location="${basedir}/lib"/>    <property name="lib.dir"              location="${basedir}/lib"/>
111    <property name="dist.dir"             location="${basedir}/dist"/>    <property name="dist.dir"             location="${basedir}/dist"/>
112      <property name="topsrc.dir"           location="${basedir}/src"/>
113    
114    <!-- Distribution locations -->    <!-- Javadoc locations -->
115    <property name="dist.javadocs.dir"    location="${dist.dir}/docs"/>    <property name="docs.dir"          location="${build.dir}/docs"/>
116      <property name="dist.docs.dir"     location="${dist.dir}/docs"/>
117    
118    <!-- Jar locations -->    <!-- Jar locations -->
119    <property name="product.jar"          location="${build.lib.dir}/jsr166.jar"/>    <property name="product.jar"      location="${build.dir}/jsr166.jar"/>
120    <property name="junit.jar"            location="${lib.dir}/junit.jar"/>    <property name="junit.jar"        location="${lib.dir}/junit.jar"/>
   <property name="rt.jar"               location="${java.home}/lib/rt.jar"/>  
   <property name="sinjdoc.jar"          location="${lib.dir}/sinjdoc.jar"/>  
   
   
   <!-- Files excluded from dist-docs and emulation jar -->  
   <patternset id="unsafe.exclusion">  
     <exclude name="java/util/Random.*"/>  
     <exclude name="sun/misc/Unsafe.*"/>  
   </patternset>  
   
   <!-- Files excludes from emulation jar -->  
   <patternset id="atomic.exclusion">  
     <exclude name="java/util/concurrent/atomic/AtomicBoolean*"/>  
     <exclude name="java/util/concurrent/atomic/AtomicInteger*"/>  
     <exclude name="java/util/concurrent/atomic/AtomicLong*"/>  
     <exclude name="java/util/concurrent/atomic/AtomicReference*"/>  
     <exclude name="java/util/concurrent/locks/LockSupport*"/>  
     <exclude name="java/util/concurrent/locks/ReentrantLock*"/>  
   </patternset>  
   
   
121    
122    <!-- Main targets -->    <!-- Canonical location of jdk docs root, to use with javadoc -Xdocrootparent flag -->
123      <!-- Switched to https: in 2017-10 - JDK-8190312 -->
124    <target name="compile"    <!-- <property name="java5.docroot.url"  value="https://docs.oracle.com/javase/1.5.0/docs"/> -->
125            depends="init, configure-compiler, prepare-src"    <!-- <property name="java6.docroot.url"  value="https://docs.oracle.com/javase/6/docs"/> -->
126            description="Compiles main sources to build folder">    <!-- <property name="java7.docroot.url"  value="https://docs.oracle.com/javase/7/docs"/> -->
127      <!-- <property name="java8.docroot.url"  value="https://docs.oracle.com/javase/8/docs"/> -->
128      <property name="prepare.src.dir" value="${src.dir}"/>    <!-- The location of jdk early access docs (RIP) -->
129      <!-- <property name="java11.docroot.url" value="http://download.java.net/java/jdk11/docs"/> -->
130      <mkdir dir="${build.classes.dir}"/>    <!-- <property name="java12.docroot.url" value="https://download.java.net/java/jdk12/docs"/> -->
131      <!-- <property name="java13.docroot.url" value="https://download.java.net/java/early_access/jdk13/docs"/> -->
132  <!--    <property name="java11.docroot.url" value="https://docs.oracle.com/en/java/javase/11/docs"/>
133      <echo>javac ${gjc.args}</echo>    <property name="java12.docroot.url" value="https://docs.oracle.com/en/java/javase/12/docs"/>
134      <echo>bootclasspath=${compile.bootclasspath}</echo>    <property name="java13.docroot.url" value="https://docs.oracle.com/en/java/javase/13/docs"/>
135  -->    <property name="java14.docroot.url" value="https://download.java.net/java/early_access/jdk14/docs"/>
136      <!-- Default jdk doc location (latest stable LTS release seems best) -->
137      <javac srcdir="${prepare.src.dir}"    <property name="java.docroot.url"   value="${java11.docroot.url}"/>
138            destdir="${build.classes.dir}"  
139              debug="${build.debug}"    <!-- Canonical location of jdk API docs, to use with javadoc link attribute -->
140         debuglevel="${build.debuglevel}"    <property name="java11.api.url"     value="${java11.docroot.url}/api/"/>
141        deprecation="${build.deprecation}"    <property name="java12.api.url"     value="${java12.docroot.url}/api/"/>
142             source="${build.sourcelevel}"    <property name="java13.api.url"     value="${java13.docroot.url}/api/"/>
143               fork="true">    <property name="java14.api.url"     value="${java14.docroot.url}/api/"/>
144      <property name="java.api.url"       value="${java.docroot.url}/api/"/>
145        <compilerarg    line="${gjc.args}"/>  
146  <!--    <!-- Define the "jtreg" task -->
147        <bootclasspath refid="compile.bootclasspath"/>    <!-- See the docs in "jtreg -onlineHelp" -->
148  -->    <taskdef name="jtreg" classname="com.sun.javatest.regtest.Main$$Ant"
149               classpath="${lib.dir}/jtreg.jar" />
150    
151      <!-- Tck configuration options; see JSR166TestCase.java
152       To profile a single tck test class:
153       ant -Djsr166.profileTests=true -Djsr166.profileThreshold=10 -Djsr166.tckTestClass=CompletableFutureTest tck
154       To stress test a single tck test class:
155       ant -Djsr166.tckTestClass=CountedCompleterTest -Djsr166.runsPerTest=100 tck
156       To stress test a single tck test method:
157       ant -Djsr166.tckTestClass=RecursiveTaskTest -Djsr166.runsPerTest=1000 -Djsr166.methodFilter=testAbnormalInvokeAll3 tck
158      -->
159      <property name="jsr166.tckTestClass"     value="JSR166TestCase"/>
160      <macrodef name="run-tck-tests">
161        <attribute name="tck.src.dir" default="${tck.src.dir}"/>
162        <attribute name="target"/>
163        <attribute name="compile-target" default="@{target}"/>
164        <attribute name="workdir"/>
165        <attribute name="classes"/>
166        <!--
167            <attribute name="jvmflags" default="-XX:+UseParallelGC -XX:-UseBiasedLocking -ea -esa -Djsr166.testImplementationDetails=true"/>
168        -->
169            <attribute name="jvmflags" default="-ea -esa -Djsr166.testImplementationDetails=true"/>
170        <element name="javac-elements" optional="true"/>
171    
172        <sequential>
173    
174        <mkdir dir="@{workdir}/tck-classes"/>
175    
176        <javac srcdir="@{tck.src.dir}"
177               destdir="@{workdir}/tck-classes"
178               debug="${build.debug}"
179               debuglevel="${build.debuglevel}"
180               deprecation="${build.deprecation}"
181               source="@{compile-target}"
182               target="@{compile-target}"
183               classpath="${junit.jar}"
184               includeAntRuntime="false"
185               includeJavaRuntime="false"
186               encoding="ASCII"
187               executable="${javac@{compile-target}}"
188               fork="true">
189    
190          <include name="*.java"/>
191          <compilerarg value="-XDignore.symbol.file=true"/>
192          <compilerarg value="-Xlint:all,-unchecked,-rawtypes,-serial,-deprecation,-try"/>
193          <compilerarg value="-Xdoclint:reference/private"/>
194          <compilerarg value="--patch-module=java.base=@{classes}"/>
195          <compilerarg line="${build.args}"/>
196          <javac-elements/>
197    
198      </javac>      </javac>
199    
200    </target>      <java classname="${jsr166.tckTestClass}"
201              failonerror="true"
202              jvm="${java@{target}}"
203    <target name="jar"            fork="true">
204            depends="configure-emulation, init-jar, native-jar, emulation-jar"          <jvmarg value="--patch-module=java.base=@{classes}"/>
205            description="Builds library jar from compiled sources"/>          <jvmarg value="--add-opens=java.base/java.lang=ALL-UNNAMED"/>
206            <jvmarg value="--add-opens=java.base/java.util=ALL-UNNAMED"/>
207            <jvmarg value="--add-opens=java.base/java.util.concurrent=ALL-UNNAMED"/>
208            <jvmarg value="--add-opens=java.base/java.util.concurrent.atomic=ALL-UNNAMED"/>
209            <jvmarg value="--add-opens=java.base/java.util.concurrent.locks=ALL-UNNAMED"/>
210            <jvmarg line="@{jvmflags}"/>
211            <!-- ant -Dvmoptions="-Xmx8m" -Djsr166.tckTestClass=CompletableFutureTest tck -->
212            <jvmarg line="${vmoptions}" if:set="vmoptions"/>
213    
214            <!-- ant -Djava.util.concurrent.ForkJoinPool.common.parallelism=1 tck -->
215            <syspropertyset id="system-properties-used-by-tck">
216              <propertyref prefix="java.util.concurrent.ForkJoinPool"/>
217              <propertyref prefix="jsr166."/>
218              <propertyref name="test.timeout.factor"/>
219            </syspropertyset>
220    
221            <classpath>
222              <pathelement location="${junit.jar}"/>
223              <pathelement location="@{workdir}/tck-classes"/>
224            </classpath>
225        </java>
226    
227        </sequential>
228      </macrodef>
229    
230    <target name="test"    <!-- Define jtreg test sets for different jdk versions -->
231            depends="init, configure-tests, report-tests"    <!-- ant -Djtreg.test.pattern="**/ConcurrentHashMap/" -->
232            description="Runs all tests (requires JUnit 3.8.1 in ${ant.home}/lib)" />    <!-- ant -Djtreg.test.pattern="**/ToArray.java" -->
233      <property name="jtreg.test.pattern" value="**/*.java"/>
234      <macrodef name="defjtregtests">
235        <attribute name="v"/>
236        <sequential>
237          <fileset dir="${jtreg@{v}.src.dir}">
238            <patternset id="jdk@{v}.jtreg.tests">
239              <include name="${jtreg.test.pattern}"/>
240            </patternset>
241          </fileset>
242        </sequential>
243      </macrodef>
244    
245      <defjtregtests v="14"/>
246      <defjtregtests v="13"/>
247      <defjtregtests v="12"/>
248      <defjtregtests v="11"/>
249    
250      <!-- ant -Djtreg.flags=-timeoutFactor:4 -->
251      <property name="jtreg.flags" value=""/>
252    
253      <macrodef name="run-jtreg-tests">
254        <!-- ant -Djtreg11.src.dir=src/test/jtreg/util/concurrent/CompletableFuture jtreg -->
255        <attribute name="target"/>
256        <attribute name="workdir"/>
257        <attribute name="classes"/>
258        <attribute name="verbose" default="${jtreg.verbose}"/>
259        <attribute name="jtregflags" default=""/>
260        <element name="jtreg-elements" optional="true"/>
261    
262        <sequential>
263    
264        <!-- ant -Djtreg.verbose=time,fail,error jtreg -->
265        <property name="jtreg.verbose" value="nopass,fail,error"/>
266    
267        <delete dir="@{workdir}/JTwork"   quiet="true"/>
268        <jtreg dir="${jtreg@{target}.src.dir}"
269               jdk="${jdk@{target}.home}"
270               workDir="@{workdir}/JTwork">
271          <patternset refid="jdk@{target}.jtreg.tests"/>
272          <arg value="-javacoptions:--patch-module=java.base=@{classes}"/>
273          <arg value="-vmoptions:--patch-module=java.base=@{classes}"/>
274          <arg value="-agentvm"/>
275          <arg value="-noreport"/>
276          <arg value="-verbose:@{verbose}"/>
277          <arg value="-vmoptions:-esa -ea"/>
278          <arg value="-automatic"/>
279          <arg value="-k:!ignore"/>
280          <arg line="@{jtregflags}"/>
281          <arg line="${jtreg.flags}"/>
282          <jtreg-elements/>
283        </jtreg>
284        </sequential>
285      </macrodef>
286    
287      <!-- ALoops classpath -->
288      <path id="loops.classpath">
289        <pathelement location="${build.loops.dir}"/>
290      </path>
291    
292      <!-- Support @jls tag, used in jdk8+ javadoc -->
293      <!-- TODO: switch to @jls taglet, as supported by jdk14+ javadoc -->
294      <property name="javadoc.jls.cite" value="The Java&amp;trade; Language Specification"/>
295      <property name="javadoc.jls.option" value="jls:a:See &lt;cite&gt;${javadoc.jls.cite}&lt;/cite&gt;:"/>
296    
297    <target name="checkstyle"    <!-- Main targets -->
           depends="filter-src"  
           description="Reports on style errors in Java source (verbose, mostly chaff)">  
298    
299      <taskdef resource="checkstyletask.properties"    <!-- Default values: may seem strange ... -->
300              classpath="${lib.dir}/checkstyle-all-2.4.jar"/>    <!-- At runtime, target latest LTS, i.e. jdk11 -->
301      <!-- But at build time, target jdk9, for maximal binary portability -->
302      <!-- ButButBut as of 2019-08, target jdk11 at build time -->
303      <!-- Use javadoc12 (but -link to jdk11 api docs!), to get:
304        o override-methods=summary
305        o {@systemProperty ...}
306        o 8211194: issues linking to external documentation (was: missing package-list for JDK10 / JDK11 documentation)
307        o 8202628: javadoc generates bad links in TestModules.java
308        -->
309      <property name="java.runtime.target" value="11"/>
310      <property name="build.main.java" value="${java11}"/>
311      <property name="build.main.javac" value="${javac11}"/>
312      <property name="build.main.javadoc" value="${javadoc12}"/>
313      <property name="build.main.javadoc.source" value="${java.runtime.target}"/>
314    
315      <checkstyle>    <target name="dists"
316        <formatter type="plain"/>  <!-- also available: type="xml" -->            depends="dist"
317        <fileset dir="${build.filter.src.dir}" includes="**/*.java"/>            description="Builds all public jars and docs"/>
     </checkstyle>  
318    
319    </target>    <target name="compile"
320              depends="configure-compiler"
321              description="Compiles src/main sources to build dir">
322    
323        <local name="destdir"/>
324        <property name="destdir" value="${build.classes.dir}/java.base"/>
325    
326    <target name="doccheck"      <mkdir dir="${destdir}"/>
           depends="filter-doccheck"  
           description="Reports on javadoc style errors">  
327    
328      <delete dir="${build.doccheck.dir}"/>      <javac srcdir="${src.dir}"
329      <mkdir dir="${build.doccheck.dir}"/>             destdir="${destdir}"
330               debug="${build.debug}"
331               debuglevel="${build.debuglevel}"
332               deprecation="${build.deprecation}"
333               classpath=""
334               includeAntRuntime="false"
335               includeJavaRuntime="false"
336               encoding="ASCII"
337               executable="${build.main.javac}"
338               fork="true">
339    
340          <include name="**/*.java"/>
341          <compilerarg value="--patch-module=java.base=${src.dir}"/>
342          <compilerarg value="-Xprefer:source"/>
343          <compilerarg value="-XDignore.symbol.file=true"/>
344    <!--   Xlint:-removal for jdk12 Unsafe Object -> Reference renaming -->
345          <compilerarg value="-Xlint:all,-removal"/>
346          <compilerarg line="--doclint-format html5"/>
347          <compilerarg value="-Xdoclint:all/protected,reference/private"/>
348          <compilerarg value="-Xdoclint/package:java.util.*"/>
349          <compilerarg value="-Werror"/>
350          <compilerarg line="-Xmaxerrs 1000 -Xmaxwarns 1000"/>
351          <compilerarg line="${build.args}"/>
352    
353      <javadoc doclet="com.sun.tools.doclets.doccheck.DocCheck"      </javac>
354           docletpath="${lib.dir}/doccheck.jar"    </target>
             destdir="${build.doccheck.dir}">  
       <packageset dir="${build.filter.doccheck.dir}"/>  
     </javadoc>  
355    
     <echo>DocCheck output is in ${build.doccheck.dir}</echo>  
356    
357      <target name="jar"
358              depends="compile"
359              description="Builds library jar for src/main from compiled sources">
360        <local name="subdir"/>
361        <available property="subdir" file="${build.classes.dir}/java.base" type="dir" value="/java.base"/>
362        <jar destfile="${product.jar}">
363          <fileset dir="${build.classes.dir}${subdir}"/>
364          <manifest>
365            <attribute name="Built-By" value="${user.name}"/>
366            <attribute name="Implementation-Vendor" value="JCP JSR-166 Expert Group."/>
367          </manifest>
368        </jar>
369    </target>    </target>
370    
371    
372    <target name="docs"    <target name="docs"
373            depends="filter-src"            description="Builds javadocs for src/main to dist dir">
           description="Builds javadocs with custom tags to build folder">  
374    
375      <delete dir="${build.javadocs.dir}"/>      <delete dir="${docs.dir}"/>
376      <mkdir dir="${build.javadocs.dir}"/>      <mkdir dir="${docs.dir}"/>
377    
378      <javadoc destdir="${build.javadocs.dir}"      <!-- old school frames via docs/index.html?overview-summary.html -->
379                  link="http://java.sun.com/j2se/1.4.1/docs/api"      <!-- dash-dash-frames no longer a supported option in jdk13+ -->
380              overview="${src.dir}/intro.html"      <local name="use-frames"/>
381                source="${build.docsourcelevel}">      <condition property="use-frames">
382          <equals arg1="${build.main.javadoc}" arg2="${javadoc12}"/>
383        <tag name="revised" description="Last revised:"/>      </condition>
       <tag name="spec"    description="Specified by:"/>  
       <tag name="editor"  description="Last edited by:"/>  
       <tag name="fixme"   description="FIX ME:"/>  
384    
385        <packageset dir="${build.filter.src.dir}"/>      <!-- the packagenames="none" hack below prevents scanning the -->
386        <!-- sourcepath for packages -->
387    
388    <!-- TODO: sourcepath="${src.dir}:${jdk9.src.dir}" -->
389    <!-- TODO: sourcepath="${src.dir}:${jdk9.src.dir}:${jdk9.src.home}/jdk/src/java.logging/share/classes" -->
390    <!-- TODO: sourcepath="${src.dir}:${jdk9.home}/src.zip" -->
391    <!-- TODO: <arg line="-sourcepath ${src.dir}:${jdk9.home}/src.zip"/> -->
392    <!-- TODO: <arg line="- -module-source-path ${jdk9.home}/src.zip"/> -->
393        <javadoc destdir="${docs.dir}"
394                 packagenames="none"
395                 link="${java.api.url}"
396                 overview="${src.dir}/intro.html"
397                 access="${build.javadoc.access}"
398                 sourcepath="${src.dir}"
399                 classpath=""
400                 source="${build.main.javadoc.source}"
401                 executable="${build.main.javadoc}">
402    <!-- TODO: JDK-8214571 failonerror = "true" -->
403          <fileset dir="${src.dir}" defaultexcludes="yes">
404            <include name="**/*.java"/>
405          </fileset>
406          <arg line="-Xdocrootparent ${java.docroot.url}"/>
407          <arg line="-Xmaxerrs 1000 -Xmaxwarns 1000"/>
408          <arg value="-XDignore.symbol.file=true"/>
409          <arg value="-html5"/>
410          <arg value="--patch-module=java.base=${src.dir}"/>
411          <arg value="--frames" if:set="use-frames"/>
412          <arg value="--override-methods=summary"/>
413          <arg value="-tag"/> <arg value="${javadoc.jls.option}"/>
414          <arg value="-tag"/> <arg value="implSpec:a:Implementation Requirements:"/>
415          <arg value="-tag"/> <arg value="implNote:a:Implementation Note:"/>
416          <arg value="-tag"/> <arg value="apiNote:a:API Note:"/>
417    <!-- tags added in jdk9: currently unused -->
418    <!--  <arg value="-tag"/> <arg value="revised:X"/> -->
419    <!--  <arg value="-tag"/> <arg value="spec:X"/> -->
420      </javadoc>      </javadoc>
   
   </target>  
   
   
   <target name="sinjdocs"  
           depends="configure-tests"  
           description="Builds javadocs with custom tags to build folder">  
   
     <delete dir="${build.sinjdocs.dir}"/>  
     <mkdir dir="${build.sinjdocs.dir}"/>  
   
     <java classname="net.cscott.sinjdoc.Main" fork="true">  
   
       <jvmarg value="-Xbootclasspath/p:${test.run.bootclasspath}"/>  
   
       <classpath>  
         <pathelement location="${sinjdoc.jar}"/>  
         <pathelement location="${lib.dir}/jutil.jar"/>  
         <pathelement location="${lib.dir}/cup.jar"/>  
         <path refid="test.classpath"/>  
       </classpath>  
   
   
       <arg value="-d"/>          <arg value="${build.sinjdocs.dir}"/>  
       <arg value="-sourcepath"/> <arg value="${src.dir}"/>  
       <arg value="-overview"/>   <arg value="${src.dir}/intro.html"/>  
       <arg value="-source"/>     <arg value="${build.sourcelevel}"/>  
       <!-- <arg value="-verbose"/> -->  
       <!-- <arg value="-link"/>  <arg value="http://java.sun.com/j2se/1.4.1/docs/api"/> -->  
       <arg value="java.lang"/>  
       <arg value="java.util"/>  
       <arg value="java.util.concurrent"/>  
       <arg value="java.util.concurrent.atomic"/>  
       <arg value="java.util.concurrent.locks"/>  
   
       <!--  
       <arg value="-help"/>  
       -->  
   
     </java>  
   
   </target>  
   
   
   <target name="strip"  
           depends="init, configure-compiler"  
           description="Strip generics from java source (not working yet)">  
   
     <mkdir dir="${build.stripped.dir}"/>  
   
     <!--  
      # javac -s doesn't reliably generate compilable code. It generates  
      # bridge methods (marked as "synthetic") that can have identical  
      # signatures to existing methods except for the return value.  
      -->  
     <javac srcdir="${src.dir}"  
           destdir="${build.stripped.dir}"  
             debug="${build.debug}"  
        debuglevel="${build.debuglevel}"  
       deprecation="${build.deprecation}"  
            source="${build.sourcelevel}"  
              fork="true">  
   
       <compilerarg    line="${gjc.args} -s"/>  
 <!--  
       <bootclasspath refid="compile.bootclasspath"/>  
 -->  
   
     </javac>  
   
421    </target>    </target>
422    
423    
424    <target name="dist"    <target name="dist"
425            depends="init, dist-clean, dist-jar, dist-docs"            depends="dist-clean, dist-jar, dist-docs"
426            description="Puts all distributable products in single hierarchy"/>            description="Puts all distributable products in single hierarchy"/>
427    
   <target name="release"  
           depends="dist"  
           description="Puts entire CVS tree, plus distribution productions, in a jar">  
   
 <!--  
     #keep build dir? - dl  
     <delete dir="${build.dir}"/>  
 -->  
     <property name="release.jar" value="dist/jsr166-${version}-dist.jar"/>  
   
     <jar basedir="${basedir}" destfile="${release.jar}">  
       <exclude name="${release.jar}"/>  
       <exclude name="user.properties"/>  
       <exclude name="etc/notes/**"/>  
       <exclude name="lib/gjc/2.1/**"/>  
       <exclude name="**/SyntaxTest.java"/>  
     </jar>  
   
   </target>  
428    
429    <target name="clean"    <target name="clean"
430            description="Removes all build products">            description="Removes all build products">
   
431      <delete dir="${build.dir}"/>      <delete dir="${build.dir}"/>
     <delete dir="${build.classes.dir}"/>  
     <delete dir="${build.lib.dir}"/>  
   
432    </target>    </target>
433    
434    
435    <target name="dist-clean"    <target name="dist-clean"
436            description="Removes all build and distribution products">            description="Removes all build and distribution products">
437        <delete dir="${build.dir}"/>
438      <delete dir="${dist.dir}"/>      <delete dir="${dist.dir}"/>
   
   </target>  
   
   
   <target name="dist-docs"  
           depends="filter-src"  
           description="Builds javadocs without custom tags to dist folder">  
   
     <delete dir="${dist.javadocs.dir}"/>  
     <mkdir dir="${dist.javadocs.dir}"/>  
   
     <javadoc destdir="${dist.javadocs.dir}"  
                 link="http://java.sun.com/j2se/1.4.1/docs/api"  
             overview="${src.dir}/intro.html"  
               source="${build.docsourcelevel}">  
   
       <packageset dir="${build.filter.src.dir}"/>  
   
     </javadoc>  
   
   </target>  
   
   
   
   <!-- Internal targets -->  
   
   
   <target name="init">  
   
     <!-- Version is kept in a separate file -->  
     <loadfile property="version" srcFile="version.properties"/>  
     <echo>Building JSR-166 version ${version}</echo>  
     <echo>java.home is ${java.home}</echo>  
   
   </target>  
   
   
   <target name="init-jar">  
   
     <mkdir dir="${build.lib.dir}"/>  
   
   </target>  
   
   
   <target name="native-jar"  
           depends="compile"  
           unless="build.emulation.true">  
   
     <jar destfile="${product.jar}">  
       <fileset dir="${build.classes.dir}"/>  
     </jar>  
   
   </target>  
   
   
   <target name="compile-emulation"  
           depends="init, configure-compiler"  
           if="build.emulation.true">  
   
     <mkdir dir="${build.emulation.dir}"/>  
   
     <javac srcdir="${emulation.src.dir}"  
           destdir="${build.emulation.dir}"  
             debug="${build.debug}"  
        debuglevel="${build.debuglevel}"  
       deprecation="${build.deprecation}"  
            source="${build.sourcelevel}"  
              fork="true">  
   
       <compilerarg    line="${gjc.args}"/>  
 <!--  
       <bootclasspath refid="compile.bootclasspath"/>  
 -->  
   
     </javac>  
   
   </target>  
   
   
   <target name="emulation-jar"  
           depends="compile-emulation"  
           if="build.emulation.true">  
   
   
     <jar destfile="${product.jar}" duplicate="add">  
       <fileset dir="${build.classes.dir}">  
         <patternset refid="atomic.exclusion"/>  
         <patternset refid="unsafe.exclusion"/>  
       </fileset>  
       <fileset dir="${build.emulation.dir}"/>  
     </jar>  
   
439    </target>    </target>
440    
441    
442    <target name="dist-jar"    <target name="dist-jar"
443            depends="clean, jar">            depends="clean, jar">
   
444      <copy file="${product.jar}" todir="${dist.dir}"/>      <copy file="${product.jar}" todir="${dist.dir}"/>
   
   </target>  
   
   
   <target name="compile-ant-filter"  
           depends="init">  
   
     <mkdir dir="${build.ant.dir}"/>  
   
     <javac srcdir="${ant.src.dir}"  
           destdir="${build.ant.dir}"  
            source="1.4"  
     />  
   
   </target>  
   
   
   <target name="filter-src"  
           depends="compile-ant-filter">  
   
     <mkdir dir="${build.filter.src.dir}"/>  
   
     <copy todir="${build.filter.src.dir}">  
       <fileset dir="${src.dir}">  
         <include name="**/*.html"/>  
       </fileset>  
     </copy>  
   
     <copy todir="${build.filter.src.dir}">  
       <fileset dir="${src.dir}">  
         <exclude name="**/*.html"/>  
         <patternset refid="unsafe.exclusion"/>  
       </fileset>  
       <filterchain>  
   
         <!--  
          # This filter gets rid of angle-bracketed type parameters  
          # so that javadoc can run on the result. The following  
          # heuristic seems to work:  
          #  
          # For all lines not starting with space(s)-asterisk-space(s),  
          #   replace <something> with a space, where there may be more  
          #   than one right angle bracket at the end, and "something"  
          #   must not contain parens or pipes. (This may need some  
          #   tweaking.)  
          -->  
   
         <filterreader classname="jsr166.ant.filters.ReplaceFilter"  
                       classpath="${build.ant.dir}">  
           <param name="notmatching" value="^\s+\*\s.*$"/>  
           <param name="pattern"     value="&lt;[^|>()]+?>+"/>  
           <param name="replacement" value=" "/>  
         </filterreader>  
   
   
         <!--  
          # This filter uncomments lines beginning with "//@" so that  
          # javadoc can see imports that are needed to resolve links  
          # but that shouldn't be in the compiled code.  
          -->  
   
         <filterreader classname="jsr166.ant.filters.ReplaceFilter"  
                       classpath="${build.ant.dir}">  
           <param name="matching"    value="^//@.*$"/>  
           <param name="pattern"     value="^//@"/>  
           <param name="replacement" value=""/>  
         </filterreader>  
       </filterchain>  
     </copy>  
   
445    </target>    </target>
446    
447      <target name="dist-docs"
448              depends="clean, docs">
449        <mirror-dir src="${docs.dir}" dst="${dist.docs.dir}"/>
   <target name="filter-doccheck"  
           depends="filter-src">  
   
     <mkdir dir="${build.filter.doccheck.dir}"/>  
   
     <copy todir="${build.filter.doccheck.dir}">  
       <fileset dir="${build.filter.src.dir}">  
         <include name="**/*.html"/>  
       </fileset>  
     </copy>  
   
     <property name="generic.declarations"  
              value="/** Fake type parameter. */ public interface E {} /** Fake type parameter. */ public interface T {} /** Fake type parameter. */ public interface K {} /** Fake type parameter. */ public interface V {}"  
     />  
   
     <copy todir="${build.filter.doccheck.dir}">  
       <fileset dir="${build.filter.src.dir}">  
         <exclude name="**/*.html"/>  
       </fileset>  
       <filterchain>  
         <!--  
          # These two filters try to make the source look like  
          # something that doccheck can process. The first removes  
          # -source 1.4 assertions and the second adds in a bunch  
          # of single letter public nested marker interfaces so that  
          # the generic type parameters are recognized.  
          -->  
   
         <filterreader classname="jsr166.ant.filters.ReplaceFilter"  
                       classpath="${build.ant.dir}">  
           <param name="matching"    value="^\s*assert[\s ].*$"/>  
           <param name="pattern"     value="assert"/>  
           <param name="replacement" value="//assert"/>  
         </filterreader>  
   
         <filterreader classname="jsr166.ant.filters.ReplaceFilter"  
                       classpath="${build.ant.dir}">  
           <param name="matching"    value="^([^*]*(class|interface|implements) .*|)\{.*$"/>  
           <param name="pattern"     value="$"/>  
           <param name="replacement" value=" ${generic.declarations}"/>  
         </filterreader>  
   
       </filterchain>  
     </copy>  
   
450    </target>    </target>
451    
452      <target name="tck"
453    <target name="compile-tests"            depends="jar"
454            depends="jar">            description="Runs tck tests for src/main directly">
455    
456      <mkdir dir="${build.testcases.dir}"/>      <run-tck-tests
457          target="${java.runtime.target}"
458  <!--        workdir="${build.dir}"
459      <echo>javac ${gjc.args}</echo>        classes="${product.jar}">
460      <echo>bootclasspath=${test.compile.bootclasspath}</echo>        <javac-elements>
461      <echo>classpath="${test.classpath}"</echo>          <compilerarg value="-Werror"/>
462  -->        </javac-elements>
463        </run-tck-tests>
464      <javac srcdir="${test.src.dir}"    </target>
465            destdir="${build.testcases.dir}"  
466              debug="${build.debug}"    <target name="tck-parallelism-1"
467         debuglevel="${build.debuglevel}"            description="Runs tck with common pool parallelism 1">
468        deprecation="${build.deprecation}"      <antcall target="tck">
469             source="${build.sourcelevel}"        <param name="java.util.concurrent.ForkJoinPool.common.parallelism" value="1"/>
470               fork="true">      </antcall>
471      </target>
472        <compilerarg    line="${gjc.args}"/>  
473  <!--          <target name="tck-parallelism-0"
474        <bootclasspath refid="test.compile.bootclasspath"/>            description="Runs tck with common pool parallelism 0">
475  -->            <antcall target="tck">
476        <classpath     refid="test.classpath"/>        <param name="java.util.concurrent.ForkJoinPool.common.parallelism" value="0"/>
477              </antcall>
478        <include name="java/**"/>    </target>
479        <include name="jsr166/**"/>  
480      <target name="tck-security-manager"
481      </javac>            description="Runs tck with a security manager">
482        <antcall target="tck">
483          <param name="jsr166.useSecurityManager" value="true"/>
484        </antcall>
485      </target>
486    
487      <target name="jtreg"
488              depends="jar"
489              description="Runs jtreg tests for src/main using the jtreg ant task">
490        <run-jtreg-tests
491           target="${java.runtime.target}"
492           workdir="${build.dir}"
493           classes="${product.jar}"/>
494    </target>    </target>
495    
496      <target name="test"
497              depends="tck, tck-parallelism-1, tck-parallelism-0, jtreg"
498              description="Runs tck and jtreg tests for src/main"/>
499    
500    <target name="run-tests"    <target name="test-version-permutations"
501            depends="compile-tests">            depends="test11, test12, test13, test14, test11-12, test11-13, test11-14, clean, test, docs">
   
     <!-- May be overridden by user.properties -->  
     <property name="testcase" value="*"/>  
   
     <mkdir dir="${build.reports.dir}"/>  
   
     <junit printsummary="true"  
              showoutput="true"  
           errorProperty="junit.failed"  
         failureProperty="junit.failed"  
                     dir="${build.reports.dir}"  
                    fork="true">  
   
       <jvmarg value="-Xbootclasspath:${test.run.bootclasspath}"/>  
   
       <formatter type="xml"/>  
   
       <batchtest todir="${build.reports.dir}">  
         <fileset dir="${test.src.dir}">  
           <include name="java/**/${testcase}Test.java"/>  
           <include name="jsr166/**/${testcase}Test.java"/>  
         </fileset>  
       </batchtest>  
   
     </junit>  
   
502    </target>    </target>
503    
504      <target name="test11">
505    <target name="report-tests"      <antcall>
506            depends="run-tests">        <param name="java.runtime.target" value="11"/>
507          <param name="build.main.javac" value="${javac11}"/>
508      <!-- Sets junit.report.format to frames if redirection is present,        <param name="build.main.javadoc" value="${javadoc12}"/>
509           otherwise sets it to noframes. -->        <param name="build.main.javadoc.source" value="11"/>
510      <available property="junit.report.format"        <target name="clean"/>
511                    value="frames"        <target name="test"/>
512                classname="org.apache.xalan.lib.Redirect"        <target name="docs"/>
513      />      </antcall>
514      <property name="junit.report.format" value="noframes"/>    </target>
515    
516      <junitreport todir="${build.reports.dir}">    <target name="test12">
517        <fileset dir="${build.reports.dir}">      <antcall>
518          <include name="TEST-*.xml"/>        <param name="java.runtime.target" value="12"/>
519        </fileset>        <param name="build.main.javac" value="${javac12}"/>
520        <report styledir="${stylesheet.dir}"        <param name="build.main.javadoc" value="${javadoc12}"/>
521                  format="${junit.report.format}"        <param name="build.main.javadoc.source" value="12"/>
522                   todir="${build.reports.dir}"        <target name="clean"/>
523        />        <target name="test"/>
524      </junitreport>        <target name="docs"/>
525        </antcall>
526      <fail message="Test Cases Failed" if="junit.failed"/>    </target>
527    
528      <target name="test13">
529        <antcall>
530          <param name="java.runtime.target" value="13"/>
531          <param name="build.main.javac" value="${javac13}"/>
532          <param name="build.main.javadoc" value="${javadoc13}"/>
533          <param name="build.main.javadoc.source" value="13"/>
534          <target name="clean"/>
535          <target name="test"/>
536          <target name="docs"/>
537        </antcall>
538      </target>
539    
540      <target name="test14">
541        <antcall>
542          <param name="java.runtime.target" value="14"/>
543          <param name="build.main.javac" value="${javac14}"/>
544          <param name="build.main.javadoc" value="${javadoc14}"/>
545          <param name="build.main.javadoc.source" value="14"/>
546          <target name="clean"/>
547          <target name="test"/>
548          <target name="docs"/>
549        </antcall>
550      </target>
551    
552      <target name="test11-12">
553        <antcall>
554          <param name="java.runtime.target" value="12"/>
555          <param name="build.main.javac" value="${javac11}"/>
556          <param name="build.main.javadoc" value="${javadoc12}"/>
557          <param name="build.main.javadoc.source" value="11"/>
558          <target name="clean"/>
559          <target name="test"/>
560          <target name="docs"/>
561        </antcall>
562      </target>
563    
564      <target name="test11-13">
565        <antcall>
566          <param name="java.runtime.target" value="13"/>
567          <param name="build.main.javac" value="${javac11}"/>
568          <param name="build.main.javadoc" value="${javadoc13}"/>
569          <param name="build.main.javadoc.source" value="11"/>
570          <target name="clean"/>
571          <target name="test"/>
572          <target name="docs"/>
573        </antcall>
574      </target>
575    
576      <target name="test11-14">
577        <antcall>
578          <param name="java.runtime.target" value="14"/>
579          <param name="build.main.javac" value="${javac11}"/>
580          <param name="build.main.javadoc" value="${javadoc14}"/>
581          <param name="build.main.javadoc.source" value="11"/>
582          <target name="clean"/>
583          <target name="test"/>
584          <target name="docs"/>
585        </antcall>
586    </target>    </target>
587    
588    
589    <target name="configure-compiler">    <target name="configure-compiler">
590        <fail message="ant version too old">
591      <property name="gjc.version"        <condition> <not> <antversion atleast="1.9.1"/> </not> </condition>
592               value="2.2"/>      </fail>
   
     <condition property="novariance.arg" value="-novariance">  
       <and>  
         <equals arg1="${gjc.version}" arg2="2.0"/>  
         <or>  
           <not><isset property="gjc.novariance"/></not>  
           <istrue value="${gjc.novariance}"/>  
         </or>  
       </and>  
     </condition>  
   
     <property name="novariance.arg"  
              value=""/>  
   
     <property name="gjc.dir"  
              value="${lib.dir}/gjc"/>  
   
     <property name="javac.jar"  
           location="${gjc.dir}/${gjc.version}/javac.jar"/>  
   
     <property name="collect.jar"  
           location="${gjc.dir}/${gjc.version}/collect${novariance.arg}.jar"/>  
   
 <!--  
     <property name="unchecked.option" value="-warnunchecked"/>  
 -->  
593    
594      <property name="unchecked.option" value="-Xlint:unchecked"/>      <property name="unchecked.option" value="-Xlint:unchecked"/>
595    
596      <condition property="warnunchecked.arg" value="${unchecked.option}">      <condition property="warnunchecked.arg" value="${unchecked.option}">
597        <istrue value="${gjc.warnunchecked}"/>        <istrue value="${build.warnunchecked}"/>
598      </condition>      </condition>
599    
600      <property name="warnunchecked.arg" value=""/>      <property name="warnunchecked.arg" value=""/>
       
     <condition property="prepare.src.dir" value="${build.dir}/prepare-src">  
       <istrue value="${build.nothreads}"/>  
     </condition>  
   
   
     <!--  
      ! Bootclasspath munging for source compilation.  
      -->  
   
     <path id="pre.bootclasspath">  
 <!--  
       <pathelement location="${javac.jar}"/>  
 -->  
     </path>  
   
     <path id="compile.bootclasspath">  
       <pathelement location="${build.classes.dir}"/>  
 <!--        
       <pathelement location="${collect.jar}"/>  
 -->  
       <pathelement location="${rt.jar}"/>  
     </path>  
   
     <!-- Flatten paths into platform-appropriate strings -->  
     <property name="pre.bootclasspath"     refid="pre.bootclasspath"/>  
     <property name="compile.bootclasspath" refid="compile.bootclasspath"/>  
601    
602    
603      <!-- Common options in javac invocations -->      <!-- Common options in javac invocations -->
604  <!--      <property name="build.args" value="${warnunchecked.arg}"/>
     <property name="gjc.args"  
              value="-J-Xbootclasspath/p:${pre.bootclasspath} ${warnunchecked.arg} ${novariance.arg}"  
     />  
 -->  
     <property name="gjc.args" value="${warnunchecked.arg} ${novariance.arg}"/>  
   
   </target>  
   
   
   <target name="prepare-src"  
           depends="configure-compiler"  
           if="prepare.src.dir">  
   
     <mkdir dir="${prepare.src.dir}"/>  
     <copy todir="${prepare.src.dir}">  
       <fileset dir="${src.dir}">  
         <exclude name="java/lang/**"/>  
       </fileset>  
     </copy>  
605    
606    </target>    </target>
607    
608    
609    <target name="configure-emulation">    <target name="compile-test-loops" depends="jar"
610              description="Compiles all the perf tests in src/test/loops">
611    
612      <condition property="build.emulation.true">      <mkdir dir="${build.dir}/test/loops"/>
       <or>  
         <and>  
           <os family="windows"/>  
           <not>  
             <isset property="build.emulation"/>  
           </not>  
         </and>  
         <istrue value="${build.emulation}"/>  
       </or>  
     </condition>  
   
   </target>  
613    
614        <javac srcdir="${basedir}/src/test/loops"
615               destdir="${build.dir}/test/loops"
616               debug="${build.debug}"
617               debuglevel="${build.debuglevel}"
618               deprecation="${build.deprecation}"
619               includeAntRuntime="false"
620               includeJavaRuntime="false"
621               encoding="ASCII"
622               executable="${build.main.javac}"
623               fork="true">
624    
625    <target name="configure-tests"        <include name="*.java"/>
626         depends="configure-compiler">        <compilerarg value="-XDignore.symbol.file=true"/>
627          <compilerarg value="-Xlint:all,-unchecked,-rawtypes,-serial,-deprecation"/>
628      <!-- junit.framework.Protectable is in JUnit 3.8.1 but not in 3.7 -->        <compilerarg value="--patch-module=java.base=${src.dir}"/>
629      <available property="junit.available"        <compilerarg line="${build.args}"/>
630                 classname="junit.framework.Protectable"/>      </javac>
   
     <fail message="Need JUnit 3.8.1 in ${ant.home}${file.separator}lib to run tests"  
           unless="junit.available"/>  
   
     <!-- Xalan -->  
     <available property="xalan.available"  
                classname="org.apache.xalan.Version"/>  
   
     <fail message="Need Xalan 2.5.1 jar in ${ant.home}${file.separator}lib to run tests"  
           unless="xalan.available"/>  
   
   
     <!--  
      ! Bootclasspath munging for testing, so JUnit can test our local  
      ! modifications to java.*.  
      -->  
   
     <path id="test.classpath">  
       <pathelement location="${product.jar}"/>  
       <pathelement location="${rt.jar}"/>  
       <pathelement location="${build.testcases.dir}"/>  
       <pathelement location="${junit.jar}"/>  
     </path>  
   
     <path id="test.compile.bootclasspath">  
       <pathelement location="${javac.jar}"/>  
       <pathelement location="${collect.jar}"/>  
       <pathelement location="${rt.jar}"/>  
     </path>  
   
     <path id="test.run.bootclasspath">  
 <!--      
       <pathelement location="${javac.jar}"/>  
 -->        
       <path refid="test.classpath"/>  
     </path>  
   
     <!-- Flatten test classpaths into platform-appropriate strings -->  
     <property name="test.classpath"             refid="test.classpath"/>  
     <property name="test.compile.bootclasspath" refid="test.compile.bootclasspath"/>  
     <property name="test.run.bootclasspath"     refid="test.run.bootclasspath"/>  
   
631    </target>    </target>
632    
633    
634      <!-- old branches no longer maintained.  build support deleted -->
635      <!-- jsr166 4jdk8; (no longer maintained as of 2019-10) -->
636      <!-- jsr166 4jdk7 (no longer maintained) -->
637      <!-- jsr166x (no longer maintained) -->
638      <!-- jsr166y (no longer maintained) -->
639      <!-- extra166y (no longer maintained) -->
640      <!-- jsr166e (no longer maintained) -->
641    
642    <!-- Find buglets that can be detected by static build tools -->
643    
644    <!--   <target name="lint"> -->
645    <!--     <antcall target="dists"> -->
646    <!--       <param name="build.javadoc.access" value="protected"/> -->
647    <!--     </antcall> -->
648    <!--   </target> -->
649    
650    <!-- Generates all doclint warnings, even for private methods (rarely useful) -->
651      <target name="doclint-private">
652        <antcall target="dist">
653          <param name="build.javadoc.access" value="private"/>
654        </antcall>
655      </target>
656    
657    
658    <!-- ==============================================================
659      Experimental errorprone support
660      https://errorprone.info
661      https://errorprone.info/docs/installation
662      https://github.com/google/error-prone/issues/1143
663    =================================================================== -->
664      <path id="errorprone.processorpath.path">
665        <pathelement location="${lib.dir}/error_prone_core-2.3.2-with-dependencies.jar"/>
666        <pathelement location="${lib.dir}/dataflow-2.5.7.jar"/>
667        <pathelement location="${lib.dir}/javacutil-2.5.7.jar"/>
668        <pathelement location="${lib.dir}/jFormatString-3.0.0.jar"/>
669      </path>
670      <property name="errorprone.processorpath" refid="errorprone.processorpath.path" />
671      <property name="errorprone.jsr166.user.flags" value=""/>
672      <property name="errorprone.jsr166.flags"
673                value="-Xep:HashtableContains:OFF
674                       -Xep:JdkObsolete:OFF
675                       -Xep:MissingOverride:OFF
676                       -Xep:MissingFail:OFF
677                       -Xep:ThreadPriorityCheck:OFF
678                       -Xep:MixedArrayDimensions:ERROR
679                       -Xep:RemoveUnusedImports:ERROR
680                       -Xep:EmptyIf:ERROR
681                       -Xep:MultipleTopLevelClasses:ERROR
682                       -Xep:ClassName:ERROR
683                       -Xep:LongLiteralLowerCaseSuffix:ERROR
684                       -Xep:RedundantThrows:ERROR
685                       -Xep:IdentityBinaryExpression:WARN
686                       -Xep:ConstructorInvokesOverridable:WARN
687                       -Xep:MethodCanBeStatic:WARN
688                       ${errorprone.jsr166.user.flags}"/>
689      <!-- -Xep:WildcardImport:ERROR -->
690      <property name="errorprone.jsr166.test.flags"
691                value="-Xep:StringSplitter:OFF
692                       -Xep:BoxedPrimitiveConstructor:OFF
693                       -Xep:ModifyingCollectionWithItself:OFF"/>
694      <!-- ant -emacs errorprone |& grep -EA1 '(warning|error):|warnings' -->
695      <target name="errorprone"
696              depends="clean, configure-compiler"
697              description="Run errorprone over jsr166 source code (experimental)">
698    
699        <local name="destdir"/>
700        <property name="destdir" value="${build.classes.dir}/java.base"/>
701        <mkdir dir="${destdir}"/>
702    
703    <!-- Anthill targets -->      <javac srcdir="${src.dir}"
704               destdir="${destdir}"
705    <target name="anthill-build">             debug="${build.debug}"
706      <exec resultproperty="result.property" dir="${basedir}" executable="${tiger.home}/bin/java">             debuglevel="${build.debuglevel}"
707        <arg value="-Xmx256000000"/>             deprecation="${build.deprecation}"
708        <!-- classpath of new JVM -->             classpath=""
709        <arg value="-classpath"/> <arg path="${java.class.path}"/>             includeAntRuntime="false"
710        <!-- location of Ant home directory -->             includeJavaRuntime="false"
711        <arg value="-Dant.home=${ant.home}"/>             encoding="ASCII"
712        <!-- the Ant main class -->             executable="${build.main.javac}"
713        <arg value="org.apache.tools.ant.Main"/>             fork="true">
714        <!-- The build file -->  
715        <arg value="-buildfile"/>  <arg value="build.xml"/>        <include name="**/*.java"/>
716        <!-- the target to build on the new Ant instance -->        <!-- Needed to silence -Xep:FutureReturnValueIgnored -->
717        <arg value="-DJAVA_HOME=${tiger.home}"/>        <compilerarg value="-J--illegal-access=permit"/>
718        <arg value="do-anthill-build"/>        <compilerarg value="-XDcompilePolicy=simple"/>
719      </exec>        <compilerarg value="-processorpath"/>
720    </target>        <compilerarg pathref="errorprone.processorpath.path"/>
721            <compilerarg value="-Xplugin:ErrorProne
722    <target name="do-anthill-build"                            ${errorprone.jsr166.flags}"/>
723            depends="jar, test, docs, dist-docs"/>        <compilerarg value="--patch-module=java.base=${src.dir}"/>
724          <compilerarg value="-Xprefer:source"/>
725    <target name="anthill-publish">        <compilerarg value="-XDignore.symbol.file=true"/>
726          <compilerarg value="-Xlint:all"/>
727      <copy todir="${deployDir}/docs/private">        <compilerarg value="-Xdoclint:all/protected,reference/private"/>
728        <fileset dir="${build.javadocs.dir}"/>        <compilerarg line="-Xmaxerrs 3000 -Xmaxwarns 3000"/>
729      </copy>        <compilerarg line="${build.args}"/>
730        </javac>
     <copy todir="${deployDir}/docs/public">  
       <fileset dir="${dist.javadocs.dir}"/>  
     </copy>  
   
     <copy tofile="${deployDir}/index.html"  
           file="${basedir}/etc/anthill-index.html"/>  
   
     <copy todir="${deployDir}/notes">  
       <fileset dir="${basedir}/etc/notes"/>  
     </copy>  
   
   </target>  
   
731    
732    <target name="ng" depends="test">      <jar destfile="${product.jar}">
733      <java classname="SuperfluousAbstract" fork="true">        <fileset dir="${destdir}"/>
734        </jar>
735    
736        <jvmarg value="-Xbootclasspath/p:${test.run.bootclasspath}"/>      <run-tck-tests
737          target="${java.runtime.target}"
738          workdir="${build.dir}"
739          classes="${product.jar}">
740          <javac-elements>
741            <!-- Needed to silence -Xep:FutureReturnValueIgnored -->
742            <compilerarg value="-J--illegal-access=permit"/>
743            <compilerarg value="-XDcompilePolicy=simple"/>
744            <compilerarg line="-processorpath ${errorprone.processorpath}"/>
745            <compilerarg value="-Xplugin:ErrorProne
746                                ${errorprone.jsr166.flags}
747                                ${errorprone.jsr166.test.flags}"/>
748            <compilerarg line="-Xmaxerrs 3000 -Xmaxwarns 3000"/>
749          </javac-elements>
750        </run-tck-tests>
751      </target>
752    
753      <!-- ant -emacs errorprone-jtreg |& grep -EA1 '(warning|error):' -->
754      <!-- -XDcompilePolicy=simple or byfile avoids confusing UnusedImports -->
755      <target name="errorprone-jtreg"
756              depends="jar"
757              description="Run errorprone over jtreg tests (experimental)">
758    
759        <run-jtreg-tests
760           target="${java.runtime.target}"
761           workdir="${build.dir}"
762           classes="${product.jar}"
763           verbose="all">
764          <jtreg-elements>
765            <arg value="-javacoption:-XDcompilePolicy=simple"/>
766            <arg value="-javacoption:-processorpath"/>
767            <arg value="-javacoption:${errorprone.processorpath}"/>
768            <arg value="-javacoption:-Xplugin:ErrorProne
769                                ${errorprone.jsr166.flags}
770                                ${errorprone.jsr166.test.flags}
771                                -Xep:MultipleTopLevelClasses:WARN
772                                -Xep:NonAtomicVolatileUpdate:OFF"/>
773          </jtreg-elements>
774        </run-jtreg-tests>
775      </target>
776    
777    
778    <!-- ==============================================================
779      Running guava tests against jsr166 code
780    =================================================================== -->
781    
782    <!-- <ivy:cachepath pathid="lib.path.id" inline="true" conf="*" -->
783    <!--   organisation="com.google.guava" module="guava-testlib" revision="21.0"/> -->
784    <!-- <property name="guava.version" value="21.0"/> -->
785    
786    <!-- HOWTO debug print a path id -->
787    <!-- <pathconvert property="guava.testlib.classpath" refid="guava.testlib.classpath" /> -->
788    <!-- <echo message="guava.testlib.classpath=${guava.testlib.classpath}"/> -->
789    
790    <!-- <ivy:retrieve pathid="guava.tests.classpath" type="jar" inline="true" conf="*" pattern="${lib.dir}/[type]/[artifact].[ext]" -->
791    <!--   organisation="com.google.guava" module="guava-tests"/> -->
792    <!-- <get src="http://repo2.maven.org/maven2/com/google/guava/guava-tests/${guava.version}/guava-tests-${guava.version}-tests.jar" -->
793    <!--   dest="${lib.dir}/jar/guava-tests-tests.jar" usetimestamp="true"/> -->
794    <!--     <ivy:cachepath pathid="lib.path.id" inline="true" conf="*" type="*" -->
795    <!--       organisation="com.google.guava" module="guava-testlib" revision="${guava.version}"/> -->
796    
797    <!-- <test name="com.google.common.collect.testing.TestsForQueuesInJavaUtil"/> -->
798    <!-- <test name="com.google.common.collect.testing.TestsForListsInJavaUtil"/> -->
799    <!-- <test name="com.google.common.collect.testing.TestsForSetsInJavaUtil"/> -->
800    <!-- <test name="com.google.common.collect.testing.TestsForMapsInJavaUtil"/> -->
801    
802    <!-- <ivy:retrieve pathid="guava.testlib.classpath" -->
803    <!--   type="*" inline="true" conf="*(private),*(public)" -->
804    <!--   pattern="${guava.dir}/[artifact].[ext]" -->
805    <!--   organisation="com.google.guava" module="guava-testlib"/> -->
806    
807    <!-- Work around bug below by downloading guava-testlib-tests.jar "by hand": -->
808    <!-- https://issues.apache.org/jira/browse/IVY-1444 -->
809    <!-- maven tests artifacts cannot be downloaded because they are mapped to private configurations -->
810    
811      <target name="init-ivy">
812        <get src="http://repo2.maven.org/maven2/org/apache/ivy/ivy/2.4.0/ivy-2.4.0.jar"
813             dest="${build.dir}/ivy.jar" usetimestamp="true" skipexisting="true"/>
814        <taskdef resource="org/apache/ivy/ant/antlib.xml" uri="antlib:org.apache.ivy.ant"
815                 classpath="${build.dir}/ivy.jar"/>
816      </target>
817    
818      <target name="guava-tests" depends="jar, init-ivy"
819              description="Guava tests run against jsr166 collections">
820        <property name="guava.dir" value="${build.dir}/guava-testlib"/>
821        <mkdir dir="${guava.dir}"/>
822        <ivy:retrieve pathid="guava.testlib.classpath"
823          type="jar,bundle" inline="true" conf="default,master"
824          pattern="${guava.dir}/[artifact].[ext]"
825          organisation="com.google.guava" module="guava-testlib"/>
826        <property name="guava.version" value="21.0"/>
827        <get src="http://repo2.maven.org/maven2/com/google/guava/guava-testlib/${guava.version}/guava-testlib-${guava.version}-tests.jar"
828             dest="${guava.dir}/guava-testlib-tests.jar" usetimestamp="true"/>
829        <junit printsummary="true" showoutput="true" haltonfailure="true"
830               jvm="${build.main.java}" fork="true">
831          <jvmarg line="-ea -esa --patch-module=java.base=${product.jar}"/>
832          <formatter type="brief"/>
833          <classpath>
834            <pathelement location="${guava.dir}/guava-testlib-tests.jar"/>
835            <path refid="guava.testlib.classpath"/>
836          </classpath>
837    
838      </java>        <!-- "6" in "OpenJdk6Tests" misleadingly means "6+" -->
839          <test name="com.google.common.collect.testing.OpenJdk6Tests"/>
840        </junit>
841    </target>    </target>
842    
   
843  </project>  </project>

Legend:
Removed from v.1.54  
changed lines
  Added in v.1.306

dl@cs.oswego.edu
ViewVC Help
Powered by ViewVC 1.1.27