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

Diff of /jsr166/build.xml

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

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

Legend:
Removed from v.1.52  
changed lines
  Added in v.1.324

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