ViewVC Help

View File | Revision Log | Show Annotations | Download File | Root Listing

root/jsr166/jsr166/build.xml

Comparing jsr166/build.xml (file contents):
Revision 1.117 by jsr166, Sun Jan 20 07:43:30 2013 UTC vs.
Revision 1.327 by jsr166, Fri Nov 25 20:33:50 2022 UTC

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

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines
>	Changed lines