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.321 by jsr166, Sat Dec 12 18:58:10 2020 UTC vs.
Revision 1.326 by jsr166, Fri Nov 25 19:33:39 2022 UTC

#	Line 19 | 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/jdk11
23	–	$HOME/jdk/jdk12
24	–	$HOME/jdk/jdk13
25	–	$HOME/jdk/jdk14
26	–	$HOME/jdk/jdk15
27	–	$HOME/jdk/jdk16
22		$HOME/jdk/jdk17
23	+	$HOME/jdk/jdk19
24		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
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 11 .. 17 ...
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
#	Line 98 | Line 88
88		</sequential>
89		</macrodef>
90
101	–	<defjdklocations v="11"/>
102	–	<defjdklocations v="12"/>
103	–	<defjdklocations v="13"/>
104	–	<defjdklocations v="14"/>
105	–	<defjdklocations v="15"/>
106	–	<defjdklocations v="16"/>
91		<defjdklocations v="17"/>
92	+	<defjdklocations v="18"/>
93	+	<defjdklocations v="19"/>
94
95		<!-- Source locations -->
96		<property name="src.dir"              location="${basedir}/src/main"/>
97		<property name="test.src.dir"         location="${basedir}/src/test"/>
98		<property name="loops.src.dir"        location="${basedir}/src/loops"/>
99		<property name="tck.src.dir"          location="${test.src.dir}/tck"/>
114	–	<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"/>
100		<property name="jtreg17.src.dir"      location="${test.src.dir}/jtreg"/>
101	<	<property name="jtreg.src.dir"        location="${jtreg11.src.dir}"/>
101	>	<property name="jtreg18.src.dir"      location="${test.src.dir}/jtreg"/>
102	>	<property name="jtreg19.src.dir"      location="${test.src.dir}/jtreg"/>
103	>	<property name="jtreg.src.dir"        location="${jtreg17.src.dir}"/>
104		<property name="lib.dir"              location="${basedir}/lib"/>
105		<property name="dist.dir"             location="${basedir}/dist"/>
106		<property name="topsrc.dir"           location="${basedir}/src"/>
#	Line 133 | Line 115
115
116		<!-- Canonical location of jdk docs root, to use with javadoc -Xdocrootparent flag -->
117		<!-- Switched to https: in 2017-10 - JDK-8190312 -->
118	<	<!-- <property name="java5.docroot.url"  value="https://docs.oracle.com/javase/1.5.0/docs"/> -->
119	<	<!-- <property name="java6.docroot.url"  value="https://docs.oracle.com/javase/6/docs"/> -->
120	<	<!-- <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	<	<!-- The location of jdk early access docs (RIP) -->
141	<	<!-- <property name="java11.docroot.url" value="http://download.java.net/java/jdk11/docs"/> -->
142	<	<!-- <property name="java12.docroot.url" value="https://download.java.net/java/jdk12/docs"/> -->
143	<	<!-- <property name="java13.docroot.url" value="https://download.java.net/java/early_access/jdk13/docs"/> -->
144	<	<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"/>
118	>	<property name="java17.docroot.url" value="https://docs.oracle.com/en/java/javase/17/docs"/>
119	>	<property name="java18.docroot.url" value="https://download.java.net/java/early_access/jdk18/docs"/>
120	>	<property name="java19.docroot.url" value="https://download.java.net/java/early_access/jdk19/docs"/>
121		<!-- Default jdk doc location (latest stable LTS release seems best) -->
122	<	<property name="java.docroot.url"   value="${java11.docroot.url}"/>
122	>	<property name="java.docroot.url"   value="${java17.docroot.url}"/>
123
124		<!-- 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/"/>
125		<property name="java17.api.url"     value="${java17.docroot.url}/api/"/>
126	+	<property name="java18.api.url"     value="${java18.docroot.url}/api/"/>
127	+	<property name="java19.api.url"     value="${java19.docroot.url}/api/"/>
128		<property name="java.api.url"       value="${java.docroot.url}/api/"/>
129
130		<!-- Define the "jtreg" task -->
#	Line 261 | Line 227
227		</macrodef>
228
229		<defjtregtests v="17"/>
230	<	<defjtregtests v="16"/>
231	<	<defjtregtests v="15"/>
266	<	<defjtregtests v="14"/>
267	<	<defjtregtests v="13"/>
268	<	<defjtregtests v="12"/>
269	<	<defjtregtests v="11"/>
230	>	<defjtregtests v="18"/>
231	>	<defjtregtests v="19"/>
232
233		<!-- ant -Djtreg.flags=-timeoutFactor:4 -->
234		<property name="jtreg.flags" value=""/>
235
236		<macrodef name="run-jtreg-tests">
275	–	<!-- ant -Djtreg11.src.dir=src/test/jtreg/util/concurrent/CompletableFuture jtreg -->
237		<attribute name="target"/>
238		<attribute name="workdir"/>
239		<attribute name="classes"/>
#	Line 285 | Line 246
246		<!-- ant -Djtreg.verbose=time,fail,error jtreg -->
247		<property name="jtreg.verbose" value="nopass,fail,error"/>
248
249	<	<delete dir="@{workdir}/JTwork"   quiet="true"/>
249	>	<!-- concurrency > 1 mitigates slowness of some jtreg tests -->
250	>	<!-- BUT concurrency:auto starts "too many" VMs; just 1 free core each -->
251	>	<!-- In 2020 concurrency:3 seems like a sweet spot -->
252	>	<!-- Override using:  ant -Djtreg.concurrency="N" jtreg -->
253	>	<property name="jtreg.concurrency" value="3"/>
254	>
255	>	<delete dir="@{workdir}/JTwork" quiet="true"/>
256		<jtreg dir="${jtreg@{target}.src.dir}"
257		jdk="${jdk@{target}.home}"
258		workDir="@{workdir}/JTwork">
259		<patternset refid="jdk@{target}.jtreg.tests"/>
260	<	<arg value="-javacoptions:--patch-module=java.base=@{classes}"/>
261	<	<arg value="-vmoptions:--patch-module=java.base=@{classes}"/>
260	>	<arg value="-javacoption:--patch-module=java.base=@{classes}"/>
261	>	<arg value="-vmoption:--patch-module=java.base=@{classes}"/>
262	>	<arg value="-vmoption:-Xmx256m"/>
263	>	<arg value="-concurrency:${jtreg.concurrency}"/>
264	>	<arg value="-vmoptions:-esa -ea"/>
265		<arg value="-vmoptions:${vmoptions}" if:set="vmoptions"/>
266		<arg value="-agentvm"/>
267		<arg value="-noreport"/>
268		<arg value="-verbose:@{verbose}"/>
299	–	<arg value="-vmoptions:-esa -ea"/>
269		<arg value="-automatic"/>
270		<arg value="-k:!ignore"/>
271		<arg line="@{jtregflags}"/>
#	Line 319 | Line 288
288		<!-- Main targets -->
289
290		<!-- Default values: may seem strange ... -->
291	<	<!-- At runtime, target latest LTS, i.e. jdk11 -->
292	<	<!-- But at build time, target jdk9, for maximal binary portability -->
293	<	<!-- ButButBut as of 2019-08, target jdk11 at build time -->
294	<	<!-- Use javadoc12 (but -link to jdk11 api docs!), to get:
295	<	o override-methods=summary
327	<	o {@systemProperty ...}
328	<	o 8211194: issues linking to external documentation (was: missing package-list for JDK10 / JDK11 documentation)
329	<	o 8202628: javadoc generates bad links in TestModules.java
330	<	-->
331	<	<property name="java.runtime.target" value="11"/>
332	<	<property name="build.main.java" value="${java11}"/>
333	<	<property name="build.main.javac" value="${javac11}"/>
334	<	<property name="build.main.javadoc" value="${javadoc12}"/>
291	>	<!-- At runtime, target latest, but build for current LTS -->
292	>	<property name="java.runtime.target" value="19"/>
293	>	<property name="build.main.java" value="${java17}"/>
294	>	<property name="build.main.javac" value="${javac17}"/>
295	>	<property name="build.main.javadoc" value="${javadoc19}"/>
296		<property name="build.main.javadoc.source" value="${java.runtime.target}"/>
297
298		<target name="dists"
#	Line 363 | Line 324
324		<compilerarg value="--patch-module=java.base=${src.dir}"/>
325		<compilerarg value="-Xprefer:source"/>
326		<compilerarg value="-XDignore.symbol.file=true"/>
327	<	<!--   Xlint:-removal for jdk12 Unsafe Object -> Reference renaming -->
367	<	<compilerarg value="-Xlint:all,-removal"/>
368	<	<compilerarg line="--doclint-format html5"/>
369	<	<!--  Temporarily disable doclint for private elements, due to -->
370	<	<!--  https://bugs.openjdk.java.net/browse/JDK-8214571 -->
371	<	<!--  which is expected to be fixed in openjdk 11.0.8 -->
372	<	<!--  <compilerarg value="-Xdoclint:all/protected,reference/private"/> -->
327	>	<compilerarg value="-Xlint:all"/>
328		<compilerarg value="-Xdoclint:all/protected"/>
329		<compilerarg value="-Xdoclint/package:java.util.*"/>
330		<compilerarg value="-Werror"/>
331		<compilerarg line="-Xmaxerrs 1000 -Xmaxwarns 1000"/>
332		<compilerarg line="${build.args}"/>
378	–
333		</javac>
334		</target>
335
382	–
336		<target name="jar"
337		depends="compile"
338		description="Builds library jar for src/main from compiled sources">
#	Line 397 | Line 350
350
351		<target name="docs"
352		description="Builds javadocs for src/main to dist dir">
400	–
353		<delete dir="${docs.dir}" quiet="true"/>
354		<mkdir dir="${docs.dir}"/>
403	–
404	–	<!-- old school frames via docs/index.html?overview-summary.html -->
405	–	<!-- dash-dash-frames no longer a supported option in jdk13+ -->
406	–	<local name="use-frames"/>
407	–	<condition property="use-frames">
408	–	<equals arg1="${build.main.javadoc}" arg2="${javadoc12}"/>
409	–	</condition>
410	–
411	–	<!-- the packagenames="none" hack below prevents scanning the -->
412	–	<!-- sourcepath for packages -->
413	–
414	–	<!-- TODO: sourcepath="${src.dir}:${jdk9.src.dir}" -->
415	–	<!-- TODO: sourcepath="${src.dir}:${jdk9.src.dir}:${jdk9.src.home}/jdk/src/java.logging/share/classes" -->
416	–	<!-- TODO: sourcepath="${src.dir}:${jdk9.home}/src.zip" -->
417	–	<!-- TODO: <arg line="-sourcepath ${src.dir}:${jdk9.home}/src.zip"/> -->
418	–	<!-- TODO: <arg line="- -module-source-path ${jdk9.home}/src.zip"/> -->
355		<javadoc destdir="${docs.dir}"
356		packagenames="none"
357		link="${java.api.url}"
#	Line 425 | Line 361
361		classpath=""
362		source="${build.main.javadoc.source}"
363		executable="${build.main.javadoc}">
428	–	<!-- TODO: JDK-8214571 failonerror = "true" -->
364		<fileset dir="${src.dir}" defaultexcludes="yes">
365		<include name="java/**/*.java"/>
366		</fileset>
367		<arg line="-Xdocrootparent ${java.docroot.url}"/>
368		<arg line="-Xmaxerrs 1000 -Xmaxwarns 1000"/>
369	+	<arg line="-Xmaxerrs 1000 -Xmaxwarns 1"/>
370		<arg value="-quiet"/>
371		<arg value="-XDignore.symbol.file=true"/>
372		<arg value="-html5"/>
#	Line 442 | Line 378
378		<arg value="-tag"/> <arg value="implSpec:a:Implementation Requirements:"/>
379		<arg value="-tag"/> <arg value="implNote:a:Implementation Note:"/>
380		<arg value="-tag"/> <arg value="apiNote:a:API Note:"/>
445	–	<!-- tags added in jdk9: currently unused -->
446	–	<!--  <arg value="-tag"/> <arg value="revised:X"/> -->
447	–	<!--  <arg value="-tag"/> <arg value="spec:X"/> -->
381		</javadoc>
382		</target>
383
451	–
384		<target name="dist"
385		depends="dist-clean, dist-jar, dist-docs"
386		description="Puts all distributable products in single hierarchy"/>
387
456	–
388		<target name="clean"
389		description="Removes all build products">
390		<delete dir="${build.dir}"/>
391		</target>
392
462	–
393		<target name="dist-clean"
394		description="Removes all build and distribution products">
395		<delete dir="${build.dir}"/>
396		<delete dir="${dist.dir}"/>
397		</target>
398
469	–
399		<target name="dist-jar"
400		depends="clean, jar">
401		<copy file="${product.jar}" todir="${dist.dir}"/>
#	Line 480 | Line 409
409		<target name="tck"
410		depends="jar"
411		description="Runs tck tests for src/main directly">
483	–
412		<run-tck-tests
413		target="${java.runtime.target}"
414		workdir="${build.dir}"
415		classes="${product.jar}">
416		<javac-elements>
417	<	<compilerarg value="-Werror"/>
417	>	<!-- <compilerarg value="-Werror"/> -->
418		</javac-elements>
419		</run-tck-tests>
420		</target>
#	Line 526 | Line 454
454		description="Runs tck and jtreg tests for src/main"/>
455
456		<target name="test-version-permutations"
457	<	depends="test11, test12, test13, test14, test15, test16,
530	<	test11-12, test11-13, test11-14, test11-15, test11-16,
531	<	clean, test, docs"
457	>	depends="test17, test19, clean, test, docs"
458		description="Runs tck and jtreg tests for various build-time and runtime java versions"/>
459
534	–	<target name="test11">
535	–	<antcall>
536	–	<param name="java.runtime.target" value="11"/>
537	–	<param name="build.main.javac" value="${javac11}"/>
538	–	<param name="build.main.javadoc" value="${javadoc12}"/>
539	–	<param name="build.main.javadoc.source" value="11"/>
540	–	<target name="clean"/>
541	–	<target name="test"/>
542	–	<target name="docs"/>
543	–	</antcall>
544	–	</target>
545	–
546	–	<target name="test12">
547	–	<antcall>
548	–	<param name="java.runtime.target" value="12"/>
549	–	<param name="build.main.javac" value="${javac12}"/>
550	–	<param name="build.main.javadoc" value="${javadoc12}"/>
551	–	<param name="build.main.javadoc.source" value="12"/>
552	–	<target name="clean"/>
553	–	<target name="test"/>
554	–	<target name="docs"/>
555	–	</antcall>
556	–	</target>
557	–
558	–	<target name="test13">
559	–	<antcall>
560	–	<param name="java.runtime.target" value="13"/>
561	–	<param name="build.main.javac" value="${javac13}"/>
562	–	<param name="build.main.javadoc" value="${javadoc13}"/>
563	–	<param name="build.main.javadoc.source" value="13"/>
564	–	<target name="clean"/>
565	–	<target name="test"/>
566	–	<target name="docs"/>
567	–	</antcall>
568	–	</target>
569	–
570	–	<target name="test14">
571	–	<antcall>
572	–	<param name="java.runtime.target" value="14"/>
573	–	<param name="build.main.javac" value="${javac14}"/>
574	–	<param name="build.main.javadoc" value="${javadoc14}"/>
575	–	<param name="build.main.javadoc.source" value="14"/>
576	–	<target name="clean"/>
577	–	<target name="test"/>
578	–	<target name="docs"/>
579	–	</antcall>
580	–	</target>
581	–
582	–	<target name="test15">
583	–	<antcall>
584	–	<param name="java.runtime.target" value="15"/>
585	–	<param name="build.main.javac" value="${javac15}"/>
586	–	<param name="build.main.javadoc" value="${javadoc15}"/>
587	–	<param name="build.main.javadoc.source" value="15"/>
588	–	<target name="clean"/>
589	–	<target name="test"/>
590	–	<target name="docs"/>
591	–	</antcall>
592	–	</target>
593	–
594	–	<target name="test16">
595	–	<antcall>
596	–	<param name="java.runtime.target" value="16"/>
597	–	<param name="build.main.javac" value="${javac16}"/>
598	–	<param name="build.main.javadoc" value="${javadoc16}"/>
599	–	<param name="build.main.javadoc.source" value="16"/>
600	–	<target name="clean"/>
601	–	<target name="test"/>
602	–	<target name="docs"/>
603	–	</antcall>
604	–	</target>
460
461	<	<target name="test11-12">
461	>	<target name="test17">
462		<antcall>
463	<	<param name="java.runtime.target" value="12"/>
464	<	<param name="build.main.javac" value="${javac11}"/>
465	<	<param name="build.main.javadoc" value="${javadoc12}"/>
466	<	<param name="build.main.javadoc.source" value="11"/>
463	>	<param name="java.runtime.target" value="17"/>
464	>	<param name="build.main.javac" value="${javac17}"/>
465	>	<param name="build.main.javadoc" value="${javadoc17}"/>
466	>	<param name="build.main.javadoc.source" value="17"/>
467		<target name="clean"/>
468		<target name="test"/>
469		<target name="docs"/>
470		</antcall>
471		</target>
472	<
618	<	<target name="test11-13">
472	>	<target name="test19">
473		<antcall>
474	<	<param name="java.runtime.target" value="13"/>
475	<	<param name="build.main.javac" value="${javac11}"/>
476	<	<param name="build.main.javadoc" value="${javadoc13}"/>
477	<	<param name="build.main.javadoc.source" value="11"/>
474	>	<param name="java.runtime.target" value="19"/>
475	>	<param name="build.main.javac" value="${javac19}"/>
476	>	<param name="build.main.javadoc" value="${javadoc19}"/>
477	>	<param name="build.main.javadoc.source" value="19"/>
478		<target name="clean"/>
479		<target name="test"/>
480		<target name="docs"/>
481		</antcall>
482		</target>
483
630	–	<target name="test11-14">
631	–	<antcall>
632	–	<param name="java.runtime.target" value="14"/>
633	–	<param name="build.main.javac" value="${javac11}"/>
634	–	<param name="build.main.javadoc" value="${javadoc14}"/>
635	–	<param name="build.main.javadoc.source" value="11"/>
636	–	<target name="clean"/>
637	–	<target name="test"/>
638	–	<target name="docs"/>
639	–	</antcall>
640	–	</target>
641	–
642	–	<target name="test11-15">
643	–	<antcall>
644	–	<param name="java.runtime.target" value="15"/>
645	–	<param name="build.main.javac" value="${javac11}"/>
646	–	<param name="build.main.javadoc" value="${javadoc15}"/>
647	–	<param name="build.main.javadoc.source" value="11"/>
648	–	<target name="clean"/>
649	–	<target name="test"/>
650	–	<target name="docs"/>
651	–	</antcall>
652	–	</target>
653	–
654	–	<target name="test11-16">
655	–	<antcall>
656	–	<param name="java.runtime.target" value="16"/>
657	–	<param name="build.main.javac" value="${javac11}"/>
658	–	<param name="build.main.javadoc" value="${javadoc16}"/>
659	–	<param name="build.main.javadoc.source" value="11"/>
660	–	<target name="clean"/>
661	–	<target name="test"/>
662	–	<target name="docs"/>
663	–	</antcall>
664	–	</target>
665	–
666	–	<target name="docs16">
667	–	<antcall>
668	–	<param name="java.runtime.target" value="16"/>
669	–	<param name="build.main.javac" value="${javac16}"/>
670	–	<param name="build.main.javadoc" value="${javadoc16}"/>
671	–	<param name="build.main.javadoc.source" value="16"/>
672	–	<target name="clean"/>
673	–	<target name="docs"/>
674	–	</antcall>
675	–	</target>
676	–
484
485		<target name="configure-compiler">
486		<fail message="ant version too old">
#	Line 817 | Line 624
624		<compilerarg value="-XDignore.symbol.file=true"/>
625		<compilerarg value="-Xlint:all"/>
626		<compilerarg value="-Xdoclint:all/protected,reference/private"/>
627	<	<compilerarg line="-Xmaxerrs 3000 -Xmaxwarns 3000"/>
627	>	<!--      <compilerarg line="-Xmaxerrs 3000 -Xmaxwarns 3000"/> -->
628	>	<compilerarg line="-Xmaxerrs 3000 -Xmaxwarns 1"/>
629		<compilerarg line="${build.args}"/>
630		</javac>
631
#	Line 837 | Line 645
645		<compilerarg value="-Xplugin:ErrorProne
646		${errorprone.jsr166.flags}
647		${errorprone.jsr166.test.flags}"/>
648	<	<compilerarg line="-Xmaxerrs 3000 -Xmaxwarns 3000"/>
648	>	<!--      <compilerarg line="-Xmaxerrs 3000 -Xmaxwarns 3000"/> -->
649	>	<compilerarg line="-Xmaxerrs 3000 -Xmaxwarns 1"/>
650		</javac-elements>
651		</run-tck-tests>
652		</target>

Diff Legend

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