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

Diff of /jsr166/build.xml

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

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

Legend:
Removed from v.1.89  
changed lines
  Added in v.1.322

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