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.14 by tim, Thu Dec 12 20:23:16 2002 UTC vs.
Revision 1.32 by tim, Thu May 29 04:35:42 2003 UTC

#	Line 1 | Line 1
1	<	<project name="jsr166" default="jar">
1	>	<project name="jsr166" default="usage">
2
3		<description>
4	+	------------------------------------------------------------------------------
5	+	Build file for JSR-166
6
7	<	Build file for JSR-166
6	<
7	<	Note that junit.jar must be in ${ant.home}/lib for the
8	<	test target to work. [FIXME: This should be automatically
9	<	enforced by this build file by failing with a message if
10	<	junit.jar is not in the right place.]
7	>	Usage: ant [target]
8
9	+	User-specific settings are read from user.properties.
10	+	See user.properties.sample for an explanation of some useful settings.
11	+	------------------------------------------------------------------------------
12		</description>
13
14	+	<target name="usage" description="Advises user to run with -projecthelp">
15	+	<echo>Run "ant -projecthelp" for full usage information.</echo>
16	+	</target>
17	+
18	+
19	+	<!-- User-specific settings -->
20	+	<property file="user.properties"/>
21	+
22	+
23		<!-- Compilation options -->
24		<property name="build.sourcelevel"    value="1.5"/>
25	+	<property name="build.docsourcelevel" value="1.4"/>
26		<property name="build.debug"          value="true"/>
27		<property name="build.debuglevel"     value="source,lines,vars"/>
28		<property name="build.deprecation"    value="false"/>
19	–	<!--
20	–	<property name="build.warnings"       value="true"/>
21	–	-->
29
30		<!-- Build locations -->
31		<property name="build.dir"            location="build"/>
32		<property name="build.classes.dir"    location="${build.dir}/classes"/>
33	+	<property name="build.emulation.dir"  location="${build.dir}/emulation"/>
34		<property name="build.testcases.dir"  location="${build.dir}/testcases"/>
35		<property name="build.lib.dir"        location="${build.dir}/lib"/>
36		<property name="build.ant.dir"        location="${build.dir}/ant"/>
37		<property name="build.javadocs.dir"   location="${build.dir}/javadocs"/>
38	+	<property name="build.stripped.dir"   location="${build.dir}/stripped"/>
39		<property name="build.reports.dir"    location="${build.dir}/reports"/>
40	+	<property name="build.doccheck.dir"   location="${build.dir}/doccheck"/>
41		<property name="build.filter.src.dir" location="${build.dir}/filtersrc"/>
42
43		<!-- Source locations -->
44	<	<property name="src.dir"              location="${basedir}"/>
45	<	<property name="test.src.dir"         location="${basedir}/etc/testcases"/>
44	>	<property name="src.dir"              location="${basedir}/src/main"/>
45	>	<property name="emulation.src.dir"    location="${basedir}/src/emulation"/>
46	>	<property name="test.src.dir"         location="${basedir}/src/test"/>
47		<property name="ant.src.dir"          location="${basedir}/etc/ant"/>
48		<property name="stylesheet.dir"       location="${basedir}/etc/xsl"/>
49		<property name="lib.dir"              location="${basedir}/lib"/>
#	Line 43 | Line 54
54
55		<!-- Jar locations -->
56		<property name="product.jar"          location="${build.lib.dir}/jsr166.jar"/>
46	–	<property name="javac.jar"            location="${lib.dir}/javac.jar"/>
47	–	<property name="collect.jar"          location="${lib.dir}/collect.jar"/>
57		<property name="junit.jar"            location="${lib.dir}/junit.jar"/>
58		<property name="rt.jar"               location="${java.home}/lib/rt.jar"/>
59
51	–	<property name="javac.args"           value='-J-Xbootclasspath/p:${javac.jar}'/>
60
61	<	<path id="javac.bootclasspath">
62	<	<pathelement location="${collect.jar}"/>
63	<	<pathelement location="${rt.jar}"/>
64	<	</path>
65	<
66	<	<path id="test.classpath">
67	<	<pathelement location="${product.jar}"/>
60	<	</path>
61	>
62	>	<!-- Files excluded from emulation and dist-docs -->
63	>	<patternset id="emulation.excludes">
64	>	<exclude name="java/util/Random.*"/>
65	>	<exclude name="sun/misc/Unsafe.*"/>
66	>	</patternset>
67	>
68
69
70		<!-- Main targets -->
71
72	<	<target name="compile" depends="init"
73	<	description="Compiles all sources to build folder">
72	>	<target name="compile"
73	>	depends="init, configure-compiler"
74	>	description="Compiles main sources to build folder">
75	>
76		<mkdir dir="${build.classes.dir}"/>
77	+
78		<javac srcdir="${src.dir}"
79		destdir="${build.classes.dir}"
80		debug="${build.debug}"
#	Line 74 | Line 84
84		fork="true">
85
86		<bootclasspath refid="javac.bootclasspath"/>
87	<	<compilerarg line="${javac.args} ${build.warnings.option}"/>
78	<
79	<	<!-- need this because srcdir is basedir! -->
80	<	<include name="java/**/*.java"/>
87	>	<compilerarg line="${build.javac.args}"/>
88
89		</javac>
90	+
91		</target>
92
93
94	<	<target name="jar" depends="compile"
95	<	description="Builds library jar from compiled sources">
96	<	<mkdir dir="${build.lib.dir}"/>
97	<	<jar basedir="${build.classes.dir}"
98	<	destfile="${product.jar}"
99	<	/>
94	>	<target name="jar"
95	>	depends="configure-emulation, init-jar, native-jar, emulation-jar"
96	>	description="Builds library jar from compiled sources"/>
97	>
98	>
99	>	<target name="test"
100	>	depends="init, configure-tests, report-tests"
101	>	description="Runs all tests (requires JUnit 3.8.1 in ${ant.home}/lib)" />
102	>
103	>
104	>	<target name="checkstyle"
105	>	depends="filter-src"
106	>	description="Reports on style errors in Java source (verbose, mostly chaff)">
107	>
108	>	<taskdef resource="checkstyletask.properties"
109	>	classpath="${lib.dir}/checkstyle-all-2.4.jar"/>
110	>
111	>	<checkstyle>
112	>	<formatter type="plain"/>  <!-- also available: type="xml" -->
113	>	<fileset dir="${build.filter.src.dir}" includes="**/*.java"/>
114	>	</checkstyle>
115	>
116		</target>
117
118
119	<	<target name="test" depends="init, report-tests"
120	<	description="Runs all tests"/>
119	>	<target name="doccheck"
120	>	depends="filter-src"
121	>	description="Reports on javadoc style errors (not working yet)">
122
123	+	<delete dir="${build.doccheck.dir}"/>
124	+	<mkdir dir="${build.doccheck.dir}"/>
125
126	<	<target name="docs" depends="init, clean-filtered-src, filter-src"
126	>	<javadoc doclet="com.sun.tools.doclets.doccheck.DocCheck"
127	>	docletpath="${lib.dir}/doccheck.jar"
128	>	destdir="${build.doccheck.dir}">
129	>	<packageset dir="${build.filter.src.dir}"/>
130	>	</javadoc>
131	>
132	>	</target>
133	>
134	>
135	>	<target name="docs"
136	>	depends="filter-src"
137		description="Builds javadocs with custom tags to build folder">
138	+
139		<delete dir="${build.javadocs.dir}"/>
140		<mkdir dir="${build.javadocs.dir}"/>
141	+
142		<javadoc destdir="${build.javadocs.dir}"
143		link="http://java.sun.com/j2se/1.4.1/docs/api"
144		overview="${src.dir}/intro.html"
145	<	source="${build.sourcelevel}">
145	>	source="${build.docsourcelevel}">
146
147		<tag name="revised" description="Last revised:"/>
148	<	<tag name="spec" description="Specified by:"/>
149	<	<tag name="editor" description="Last edited by:"/>
150	<	<tag name="fixme" description="FIX ME:"/>
151	<	<packageset dir="${build.filter.src.dir}">
152	<	<include name="java/**"/>
114	<	</packageset>
148	>	<tag name="spec"    description="Specified by:"/>
149	>	<tag name="editor"  description="Last edited by:"/>
150	>	<tag name="fixme"   description="FIX ME:"/>
151	>
152	>	<packageset dir="${build.filter.src.dir}"/>
153
154		</javadoc>
155	+
156		</target>
157
158
159	<	<target name="dist" depends="init, dist-clean, dist-jar, dist-docs"/>
159	>	<target name="strip"
160	>	depends="init, configure-compiler"
161	>	description="Strip generics from java source (not working yet)">
162	>
163	>	<mkdir dir="${build.stripped.dir}"/>
164	>
165	>	<!--
166	>	# javac -s doesn't reliably generate compilable code. It generates
167	>	# bridge methods (marked as "synthetic") that can have identical
168	>	# signatures to existing methods except for the return value.
169	>	-->
170	>	<javac srcdir="${src.dir}"
171	>	destdir="${build.stripped.dir}"
172	>	debug="${build.debug}"
173	>	debuglevel="${build.debuglevel}"
174	>	deprecation="${build.deprecation}"
175	>	source="${build.sourcelevel}"
176	>	fork="true">
177	>
178	>	<bootclasspath refid="javac.bootclasspath"/>
179	>	<compilerarg line="${build.javac.args} -s"/>
180	>
181	>	</javac>
182	>
183	>	</target>
184	>
185	>
186	>	<target name="dist"
187	>	depends="init, dist-clean, dist-jar, dist-docs"
188	>	description="Puts all distributable products in single hierarchy"/>
189
190
191		<target name="clean"
192		description="Removes all build products">
193	+
194		<delete dir="${build.dir}"/>
195		<delete dir="${build.classes.dir}"/>
196		<delete dir="${build.lib.dir}"/>
197	+
198		</target>
199
200
201		<target name="dist-clean"
202		description="Removes all build and distribution products">
203	+
204		<delete dir="${dist.dir}"/>
205	+
206		</target>
207
208
209	<	<!-- Anthill targets -->
209	>	<target name="dist-docs"
210	>	depends="filter-src"
211	>	description="Builds javadocs without custom tags to dist folder">
212
213	<	<!-- Should really run the tests instead of just the jar target -->
214	<	<target name="anthill-build" depends="jar, docs, dist-docs"
215	<	description="Build the jar and both the external and internal docs"/>
213	>	<delete dir="${dist.javadocs.dir}"/>
214	>	<mkdir dir="${dist.javadocs.dir}"/>
215	>
216	>	<javadoc destdir="${dist.javadocs.dir}"
217	>	link="http://java.sun.com/j2se/1.4.1/docs/api"
218	>	overview="${src.dir}/intro.html"
219	>	source="${build.docsourcelevel}">
220	>
221	>	<packageset dir="${build.filter.src.dir}"/>
222	>
223	>	</javadoc>
224
143	–	<target name="anthill-publish">
144	–	<copy todir="${deployDir}/docs/private">
145	–	<fileset dir="${build.javadocs.dir}"/>
146	–	</copy>
147	–	<copy todir="${deployDir}/docs/public">
148	–	<fileset dir="${dist.javadocs.dir}"/>
149	–	</copy>
225		</target>
226
227
228	+
229		<!-- Internal targets -->
230
155	–	<target name="set-warnings-if" if="build.warnings">
156	–	<property name="build.warnings.option" value="-warnunchecked"/>
157	–	</target>
231
232	<	<target name="set-warnings-unless" unless="build.warnings">
160	<	<property name="build.warnings.option" value=""/>
161	<	</target>
232	>	<target name="init">
233
163	–	<target name="init" depends="set-warnings-if, set-warnings-unless">
234		<!-- Version is kept in a separate file -->
235		<loadfile property="version" srcFile="version.properties"/>
236		<echo>Building JSR-166 version ${version}</echo>
237	+
238		</target>
239
240
241	<	<target name="clean-filtered-src">
242	<	<delete dir="${build.filter.src.dir}"/>
241	>	<target name="init-jar">
242	>
243	>	<mkdir dir="${build.lib.dir}"/>
244	>
245		</target>
246
247
248	<	<target name="dist-jar" depends="clean, jar">
249	<	<copy file="${product.jar}" todir="${dist.dir}"/>
248	>	<target name="native-jar"
249	>	depends="compile"
250	>	unless="build.emulation.true">
251	>
252	>	<jar destfile="${product.jar}">
253	>	<fileset dir="${build.classes.dir}"/>
254	>	</jar>
255	>
256		</target>
257
258
259	<	<target name="dist-docs" depends="clean-filtered-src, filter-src"
260	<	description="Builds javadocs without custom tags to dist folder">
261	<	<delete dir="${dist.javadocs.dir}"/>
183	<	<mkdir dir="${dist.javadocs.dir}"/>
184	<	<javadoc destdir="${dist.javadocs.dir}"
185	<	link="http://java.sun.com/j2se/1.4.1/docs/api"
186	<	overview="${src.dir}/intro.html"
187	<	source="${build.sourcelevel}">
259	>	<target name="compile-emulation"
260	>	depends="init, configure-compiler"
261	>	if="build.emulation.true">
262
263	<	<packageset dir="${build.filter.src.dir}">
264	<	<include name="java/**"/>
265	<	</packageset>
263	>	<mkdir dir="${build.emulation.dir}"/>
264	>
265	>	<javac srcdir="${emulation.src.dir}"
266	>	destdir="${build.emulation.dir}"
267	>	debug="${build.debug}"
268	>	debuglevel="${build.debuglevel}"
269	>	deprecation="${build.deprecation}"
270	>	source="${build.sourcelevel}"
271	>	fork="true">
272	>
273	>	<bootclasspath refid="javac.bootclasspath"/>
274	>	<compilerarg line="${build.javac.args}"/>
275	>
276	>	</javac>
277
193	–	</javadoc>
278		</target>
279
280
281	<	<target name="compile-ant-filter">
281	>	<target name="emulation-jar"
282	>	depends="compile-emulation"
283	>	if="build.emulation.true">
284	>
285	>
286	>	<jar destfile="${product.jar}" duplicate="add">
287	>	<fileset dir="${build.classes.dir}">
288	>	<patternset refid="emulation.excludes"/>
289	>	</fileset>
290	>	<fileset dir="${build.emulation.dir}"/>
291	>	</jar>
292	>
293	>	</target>
294	>
295	>
296	>	<target name="dist-jar"
297	>	depends="clean, jar">
298	>
299	>	<copy file="${product.jar}" todir="${dist.dir}"/>
300	>
301	>	</target>
302	>
303	>
304	>	<target name="compile-ant-filter"
305	>	depends="init">
306	>
307		<mkdir dir="${build.ant.dir}"/>
308	+
309		<javac srcdir="${ant.src.dir}"
310		destdir="${build.ant.dir}"
311		source="1.4"
312		/>
313	+
314		</target>
315
316
317	<	<target name="filter-src" depends="compile-ant-filter">
317	>	<target name="filter-src"
318	>	depends="compile-ant-filter">
319	>
320		<mkdir dir="${build.filter.src.dir}"/>
321	+
322	+	<copy todir="${build.filter.src.dir}">
323	+	<fileset dir="${src.dir}">
324	+	<include name="**/*.html"/>
325	+	</fileset>
326	+	</copy>
327	+
328		<copy todir="${build.filter.src.dir}">
329		<fileset dir="${src.dir}">
330	<	<include name="**/*.java"/>
330	>	<exclude name="**/*.html"/>
331	>	<patternset refid="emulation.excludes"/>
332		</fileset>
333		<filterchain>
334		<filterreader classname="jsr166.ant.filters.ReplaceFilter"
#	Line 241 | Line 362
362		</filterreader>
363		</filterchain>
364		</copy>
365	+
366		</target>
367
368
369	<	<target name="compile-tests" depends="jar">
369	>	<target name="compile-tests"
370	>	depends="jar">
371	>
372		<mkdir dir="${build.testcases.dir}"/>
373	+
374		<javac srcdir="${test.src.dir}"
375		destdir="${build.testcases.dir}"
376		debug="${build.debug}"
#	Line 254 | Line 379
379		source="${build.sourcelevel}"
380		fork="true">
381
257	–	<bootclasspath refid="javac.bootclasspath"/>
258	–	<compilerarg line="${javac.args} ${build.warnings.option}"/>
382		<classpath refid="test.classpath"/>
383	<	<include name="**/*Test.java"/>
383	>	<bootclasspath refid="javac.bootclasspath"/>
384	>	<compilerarg line="${build.javac.args}"/>
385
386		</javac>
387	+
388		</target>
389
390
391	<	<target name="run-tests" depends="compile-tests">
391	>	<target name="run-tests"
392	>	depends="compile-tests">
393	>
394	>	<!-- May be overridden by user.properties -->
395	>	<property name="testcase" value="*"/>
396	>
397		<mkdir dir="${build.reports.dir}"/>
398	+
399		<junit printsummary="true"
400		showoutput="true"
401		errorProperty="junit.failed"
#	Line 272 | Line 403
403		dir="${build.reports.dir}"
404		fork="true">
405
406	<	<jvmarg value="-Xbootclasspath/p:${product.jar}"/>
276	<
277	<	<classpath>
278	<	<!-- <path refid="test.classpath"/> -->
279	<	<pathelement location="${build.testcases.dir}"/>
280	<	</classpath>
406	>	<jvmarg value="${test.bootclasspath.arg}"/>
407
408		<formatter type="xml"/>
409
410		<batchtest todir="${build.reports.dir}">
411		<fileset dir="${test.src.dir}">
412	<	<include name="**/*Test.java"/>
412	>	<include name="**/${testcase}Test.java"/>
413		</fileset>
414		</batchtest>
415
416		</junit>
417	+
418		</target>
419
420
421	<	<target name="report-tests" depends="run-tests">
421	>	<target name="report-tests"
422	>	depends="run-tests">
423	>
424		<!-- Sets junit.report.format to frames if Xalan is present,
425		otherwise sets it to noframes. -->
426		<available property="junit.report.format"
#	Line 311 | Line 440
440		</junitreport>
441
442		<fail message="Test Cases Failed" if="junit.failed"/>
443	+
444	+	</target>
445	+
446	+
447	+	<target name="configure-compiler">
448	+
449	+	<property name="gjc.version"
450	+	value="1.3"/>
451	+
452	+	<condition property="build.novariance" value="-novariance">
453	+	<and>
454	+	<equals arg1="${gjc.version}" arg2="2.0"/>
455	+	<or>
456	+	<not><isset property="gjc.novariance"/></not>
457	+	<istrue value="${gjc.novariance}"/>
458	+	</or>
459	+	</and>
460	+	</condition>
461	+
462	+	<property name="build.novariance"
463	+	value=""/>
464	+
465	+	<property name="gjc.dir"
466	+	value="${lib.dir}/gjc"/>
467	+
468	+	<property name="javac.jar"
469	+	location="${gjc.dir}/${gjc.version}/javac.jar"/>
470	+
471	+	<property name="collect.jar"
472	+	location="${gjc.dir}/${gjc.version}/collect${build.novariance}.jar"/>
473	+
474	+
475	+	<condition property="build.warnunchecked" value="-warnunchecked">
476	+	<istrue value="${gjc.warnunchecked}"/>
477	+	</condition>
478	+
479	+	<property name="build.warnunchecked" value=""/>
480	+
481	+
482	+	<!--
483	+	! Bootclasspath munging for source compilation.
484	+	-->
485	+
486	+	<path id="javac.bootclasspath.prefix">
487	+	<!-- <pathelement location="${src.dir}"/> -->
488	+	<pathelement location="${javac.jar}"/>
489	+	</path>
490	+
491	+	<path id="javac.bootclasspath">
492	+	<!-- <pathelement location="${src.dir}"/> -->
493	+	<pathelement location="${collect.jar}"/>
494	+	<pathelement location="${rt.jar}"/>
495	+	</path>
496	+
497	+	<!-- Flatten bootclasspath prefix into a platform-appropriate string -->
498	+	<property name="javac.bootclasspath.prefix"
499	+	refid="javac.bootclasspath.prefix"/>
500	+
501	+	<!-- Turn the flattened bootclasspath prefix into a javac argument -->
502	+	<property name="build.bootclasspath.arg"
503	+	value='-J-Xbootclasspath/p:${javac.bootclasspath.prefix}'/>
504	+
505	+	<!-- Flatten bootclasspath for trace message -->
506	+	<property name="javac.bootclasspath"
507	+	refid="javac.bootclasspath"/>
508	+
509	+	<!-- Common options in javac invocations -->
510	+	<property name="build.javac.args"
511	+	value="${build.bootclasspath.arg} ${build.warnunchecked} ${build.novariance}"/>
512	+
513	+	<echo>javac ${build.javac.args}
514	+	bootclasspath is ${javac.bootclasspath}</echo>
515	+
516	+	</target>
517	+
518	+
519	+	<target name="configure-emulation">
520	+
521	+	<condition property="build.emulation.true">
522	+	<or>
523	+	<and>
524	+	<os family="windows"/>
525	+	<not>
526	+	<isset property="build.emulation"/>
527	+	</not>
528	+	</and>
529	+	<istrue value="${build.emulation}"/>
530	+	</or>
531	+	</condition>
532	+
533	+	</target>
534	+
535	+
536	+	<target name="configure-tests">
537	+
538	+	<!-- junit.framework.Protectable is in JUnit 3.8.1 but not in 3.7 -->
539	+	<available property="junit.available"
540	+	classname="junit.framework.Protectable"/>
541	+
542	+	<fail message="Need JUnit 3.8.1 in ${ant.home}${file.separator}lib to run tests"
543	+	unless="junit.available"/>
544	+
545	+
546	+	<!--
547	+	! Bootclasspath munging for testing, so JUnit can test our local
548	+	! modifications to java.*.
549	+	-->
550	+
551	+	<path id="test.classpath">
552	+	<pathelement location="${product.jar}"/>
553	+	<pathelement location="${build.testcases.dir}"/>
554	+	<pathelement location="${junit.jar}"/>
555	+	</path>
556	+
557	+	<!-- Flatten test classpath into a platform-appropriate string -->
558	+	<property name="test.classpath" refid="test.classpath"/>
559	+
560	+	<!-- Turn the flattened test classpath into a javac argument -->
561	+	<property name="test.bootclasspath.arg"
562	+	value='-Xbootclasspath/p:${test.classpath}'/>
563	+
564	+	</target>
565	+
566	+
567	+
568	+	<!-- Anthill targets -->
569	+
570	+	<target name="anthill-build"
571	+	depends="jar, test, docs, dist-docs"/>
572	+
573	+	<target name="anthill-publish">
574	+
575	+	<copy todir="${deployDir}/docs/private">
576	+	<fileset dir="${build.javadocs.dir}"/>
577	+	</copy>
578	+
579	+	<copy todir="${deployDir}/docs/public">
580	+	<fileset dir="${dist.javadocs.dir}"/>
581	+	</copy>
582	+
583	+	<copy tofile="${deployDir}/index.html"
584	+	file="${basedir}/etc/anthill-index.html"/>
585	+
586	+	<copy todir="${deployDir}/notes">
587	+	<fileset dir="${basedir}/etc/notes"/>
588	+	</copy>
589	+
590		</target>
591
592

Diff Legend

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