build.xml revision 2547:e6e8e286c316
1101776Stjr<?xml version="1.0" encoding="UTF-8"?>
2101776Stjr<!--
3101776Stjr Copyright (c) 2007, 2014, Oracle and/or its affiliates. All rights reserved.
4101776Stjr DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5101776Stjr
6101776Stjr This code is free software; you can redistribute it and/or modify it
7101776Stjr under the terms of the GNU General Public License version 2 only, as
8101776Stjr published by the Free Software Foundation.  Oracle designates this
9101776Stjr particular file as subject to the "Classpath" exception as provided
10101776Stjr by Oracle in the LICENSE file that accompanied this code.
11101776Stjr
12101776Stjr This code is distributed in the hope that it will be useful, but WITHOUT
13101776Stjr ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
14101776Stjr FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
15101776Stjr version 2 for more details (a copy is included in the LICENSE file that
16101776Stjr accompanied this code).
17101776Stjr
18101776Stjr You should have received a copy of the GNU General Public License version
19101776Stjr 2 along with this work; if not, write to the Free Software Foundation,
20101776Stjr Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
21101776Stjr
22101776Stjr Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
23101776Stjr or visit www.oracle.com if you need additional information or have any
24101776Stjr questions.
25101776Stjr-->
26101776Stjr
27101776Stjr<!--
28101776Stjr This is the main build file for the complete langtools repository.
29101776Stjr It is used when building JDK (in which case it is invoked from the
30101776Stjr Makefile), and it can be used when working on the tools themselves,
31101776Stjr in an IDE such as NetBeans.
32101776Stjr
33101776Stjr External dependencies are specified via properties. These can be given
34101776Stjr on the command line, or by providing a local build.properties file.
35101776Stjr (They can also be edited into make/build.properties, although that is not
36101776Stjr recommended.)  At a minimum, boot.java.home must be set to the installed
37101776Stjr location of the version of JDK used to build this repository. Additional
38101776Stjr properties may be required, depending on the targets that are built.
39101776Stjr For example, to run any of the jtreg tests you must set jtreg.home,
40101776Stjr to run findbugs on the code you must set findbugs.home, and so on.
41101776Stjr
42101776Stjr For the most part, javac can be built using the previous version of JDK.
43101776Stjr However, a small number of javac files require access to the latest JDK,
44101776Stjr which may not yet have been compiled. To compile these files, you can do
45101776Stjr one of the following:
46101776Stjr - Set boot.java.home to a recent build of the latest version of JDK.
47101776Stjr - Set import.jdk to either a recent build (containing jre/lib/rt.jar)
48101776Stjr   or to jdk source repository.  In the latter case, stub files will
49   automatically be generated and used for the required API, to avoid
50   unnecessary compilation of the source repository.
51 If you do neither, the relevant files will not be built.
52
53 The main build happens in two phases:
54 - First, javac and other tools as needed are built using ${boot.java.home}.
55   (This implies a constraint on the source code that they can be compiled
56   with the previous version of JDK.
57 - Second, all required classes are compiled with the latest javac, created
58   in the previous step.
59 The first phase is called the bootstrap phase. All targets, properties and
60 tasks that are specific to that phase have "bootstrap" in their name.
61
62 For more details on the JDK build, see
63    http://blogs.sun.com/kto/entry/anatomy_of_the_jdk_build
64    http://openjdk.java.net/groups/build/
65 For more details on the stub generator, see
66    http://blogs.sun.com/jjg/entry/building_javac_for_jdk7
67
68 Internal details ...
69
70 Interim build products are created in the build/ directory.
71 Final build products are created in the dist/ directory.
72 When building JDK, the dist/directory will contain:
73 - A bootstrap compiler suitable for running with ${boot.java.home}
74   suitable for compiling downstream parts of JDK
75 - Source files and class files for inclusion in the JDK being built
76 When building standalone, the dist/directory will contain:
77 - Separate jar files for each of the separate langtools components
78 - Simple scripts to invoke the tools by executing the corresponding
79   jar files.
80 These jar files and scripts are "for developer use only".
81
82 This file is organized into sections as follows:
83 - global property definitions
84 - general top level targets
85 - general diagnostic/debugging targets
86 - groups of targets for each tool: javac, javadoc, doclets, javah, javap
87    Within each group, the following targets are provided, where applicable
88      build-bootstrap-TOOL      build the bootstrap version of the tool
89      build-classes-TOOL        build the classes for the tool
90      build-TOOL                build the jar file and script for the tool
91      jtreg-TOOL                build the tool and run the appropriate tests
92      findbugs-TOOL             run findbugs on the tool's source code
93      TOOL                      build the tool, run the tests, and run findbugs
94 - utility definitions
95 -->
96
97<project name="langtools" default="build" basedir="..">
98    <!--
99    **** Global property definitions.
100    -->
101
102    <!-- Force full debuginfo for javac if the debug.classfiles
103    property is set.  This must be BEFORE the include of
104    build.properties because it sets javac.debuglevel.  -->
105    <condition property="javac.debuglevel" value="source,lines,vars">
106        <equals arg1="${debug.classfiles}" arg2="true"/>
107    </condition>
108
109    <!-- The following locations can be used to override default property values. -->
110
111    <!-- Use this location for customizations specific to this instance of this workspace -->
112    <property file="build.properties"/>
113
114    <!-- Use this location for customizations common to all OpenJDK langtools workspaces -->
115    <property file="${user.home}/.openjdk/${ant.project.name}-build.properties"/>
116
117    <!-- Use this location for customizations common to all OpenJDK workspaces -->
118    <property file="${user.home}/.openjdk/build.properties"/>
119
120    <!-- Convenient shorthands for standard locations within the workspace. -->
121    <property name="build.dir" location="build"/>
122    <property name="build.bootstrap.dir" location="${build.dir}/bootstrap"/>
123    <property name="build.coverage.dir" location="${build.dir}/coverage"/>
124    <property name="build.classes.dir" location="${build.dir}/classes"/>
125    <property name="build.gensrc.dir" location="${build.dir}/gensrc"/>
126    <property name="build.genstubs.dir" location="${build.dir}/genstubs"/>
127    <property name="build.javadoc.dir" location="${build.dir}/javadoc"/>
128    <property name="build.jtreg.dir" location="${build.dir}/jtreg"/>
129    <property name="build.toolclasses.dir" location="${build.dir}/toolclasses"/>
130    <property name="dist.dir" location="dist"/>
131    <property name="dist.bin.dir" location="${dist.dir}/bin"/>
132    <property name="dist.coverage.dir" location="${dist.dir}/coverage"/>
133    <property name="dist.findbugs.dir" location="${dist.dir}/findbugs"/>
134    <property name="dist.checkstyle.dir" location="${dist.dir}/checkstyle"/>
135    <property name="dist.lib.dir" location="${dist.dir}/lib"/>
136    <property name="make.dir" location="make"/>
137    <property name="make.conf.dir" location="${make.dir}/conf"/>
138    <property name="make.tools.dir" location="${make.dir}/tools"/>
139    <property name="src.dir" location="src"/>
140    <property name="src.bin.dir" location="${src.dir}/share/bin"/>
141    <property name="src.classes.dir" location="${src.dir}/share/classes"/>
142    <property name="test.dir" location="test"/>
143
144    <!-- java.marker is set to a marker file to check for within a Java install dir.
145         The best file to check for across Solaris/Linux/Windows/MacOS is one of the
146         executables; regrettably, that is OS-specific. -->
147    <condition property="java.marker" value="bin/java">
148        <os family="unix"/>
149    </condition>
150    <condition property="java.marker" value="bin/java.exe">
151        <os family="windows"/>
152    </condition>
153
154    <!-- Standard property values, if not overriden by earlier settings. -->
155    <property file="${make.dir}/build.properties"/>
156
157    <!-- launcher.java is used in the launcher scripts provided to run
158        the tools' jar files.  If it has not already been set, then
159        default it to use ${target.java.home}, if available, otherwise
160        quietly default to simply use "java". -->
161    <condition property="launcher.java"
162        value="${target.java.home}/bin/java" else="java">
163        <isset property="target.java.home"/>
164    </condition>
165
166    <!-- Logic for handling access import jdk classes, if available.
167        import.jdk should be unset, or set to jdk home (to use rt.jar)
168        or to jdk repo (to use src/share/classes).
169        Based on the value, if any, set up default values for javac's sourcepath,
170        classpath and bootclasspath. Note: the default values are overridden
171        in the build-bootstrap-classes macro. -->
172
173    <available property="import.jdk.src.dir" value="${import.jdk}/src/share/classes"
174        filepath="${import.jdk}/src/share/classes" file="java/nio/file/Path.java"/>
175    <available property="import.jdk.jar" value="${import.jdk}/jre/lib/rt.jar"
176        ignoresystemclasses="true"
177        classpath="${import.jdk}/jre/lib/rt.jar" classname="java.nio.file.Path"/>
178
179    <!-- Set the default bootclasspath option used for javac.
180        Note that different variants of the option are used, meaning we can't just
181        define the value for the option.
182        Note the explicit use of the standard property ${path.separator} in the following.
183        This is because Ant is not clever enough to handle direct use of : or ; -->
184    <condition property="javac.bootclasspath.opt"
185            value="-Xbootclasspath:${build.classes.dir}${path.separator}${import.jdk.jar}"
186            else="-Xbootclasspath/p:${build.classes.dir}">
187        <isset property="import.jdk.jar"/>
188    </condition>
189
190    <condition property="boot.java.provides.latest.jdk">
191        <available
192            ignoresystemclasses="true"
193            classpath="${boot.java.home}/jre/lib/rt.jar" classname="java.nio.file.Path"/>
194    </condition>
195
196    <condition property="bootstrap.exclude.files" value="" else="${require.latest.jdk.files}">
197        <isset property="boot.java.provides.latest.jdk"/>
198    </condition>
199
200    <condition property="exclude.files" value="" else="${require.latest.jdk.files}">
201        <or>
202            <isset property="boot.java.provides.latest.jdk"/>
203            <isset property="import.jdk"/>
204        </or>
205    </condition>
206
207    <condition property="require.import.jdk.stubs">
208        <and>
209            <not>
210                <isset property="boot.java.provides.latest.jdk"/>
211            </not>
212            <isset property="import.jdk.src.dir"/>
213        </and>
214    </condition>
215
216    <!-- Set the default value of the sourcepath used for javac. -->
217    <condition property="javac.sourcepath" value="${build.genstubs.dir}" else="">
218        <isset property="require.import.jdk.stubs"/>
219    </condition>
220
221    <!-- Set the default value of the classpath used for javac. -->
222    <property name="javac.classpath" value=""/>
223
224
225    <!--
226    **** General top level targets.
227    -->
228
229    <!-- Standard target to build deliverables for JDK build. -->
230
231    <target name="build" depends="build-bootstrap-tools,build-all-classes">
232        <copy todir="${dist.dir}/bootstrap">
233            <fileset dir="${build.bootstrap.dir}" includes="bin/,lib/"/>
234        </copy>
235        <chmod dir="${dist.dir}/bootstrap/bin" perm="ugo+rx">
236            <include name="*"/>
237        </chmod>
238        <mkdir dir="${dist.lib.dir}"/>
239        <jar file="${dist.lib.dir}/classes.jar" basedir="${build.classes.dir}"/>
240        <zip file="${dist.lib.dir}/src.zip" basedir="${src.classes.dir}"/>
241    </target>
242
243    <target name="build-bootstrap-tools"
244        depends="build-bootstrap-javac,build-bootstrap-javadoc,build-bootstrap-doclets,build-bootstrap-javah,build-bootstrap-sjavac"
245    />
246
247    <target name="build-all-tools"
248        depends="build-javac,build-javadoc,build-doclets,build-javah,build-javap,build-sjavac"
249    />
250
251    <target name="build-all-classes" depends="build-bootstrap-javac,-create-import-jdk-stubs">
252        <build-classes includes="${javac.includes} ${javadoc.includes} ${doclets.includes} ${javah.includes} ${javap.includes} ${sjavac.includes}"/>
253    </target>
254
255    <!-- clean -->
256
257    <target name="clean" description="Delete all generated files">
258        <delete dir="${build.dir}"/>
259        <delete dir="${dist.dir}"/>
260    </target>
261
262    <!-- Additional targets for running tools on the build -->
263
264    <target name="jtreg" depends="build-all-tools,-def-jtreg">
265        <jtreg-tool name="all" tests="${jtreg.tests}"/>
266    </target>
267
268    <target name="checkstyle" depends="-def-checkstyle"
269        description="Generates reports for code convention violations.">
270        <mkdir dir="${dist.checkstyle.dir}"/>
271        <checkstyle config="${make.conf.dir}/checkstyle-langtools.xml"
272              failureProperty="checkstyle.failure"
273              failOnViolation="false">
274            <formatter type="xml" tofile="${dist.checkstyle.dir}/checkstyle_report.xml"/>
275            <fileset dir="src" includes="**/*.java, **/*.properties"/>
276        </checkstyle>
277        <!-- transform the output to a simple html -->
278        <xslt  in="${dist.checkstyle.dir}/checkstyle_report.xml"
279               out="${dist.checkstyle.dir}/checkstyle_report.html"
280               style="${checkstyle.home}/contrib/checkstyle-simple.xsl"/>
281        <!-- transform the output to a very simple emacs friendly text file -->
282        <xslt  in="${dist.checkstyle.dir}/checkstyle_report.xml"
283               out="${dist.checkstyle.dir}/checkstyle_report.tmp"
284               style="${make.conf.dir}/checkstyle-emacs.xsl"/>
285        <!-- beautify remove extra lines -->
286        <move file="${dist.checkstyle.dir}/checkstyle_report.tmp"
287             toFile="${dist.checkstyle.dir}/checkstyle_report.emacs.txt">
288            <filterchain>
289                <ignoreblank/>
290                <replaceregex byline="true" pattern="^File:" replace="${line.separator}File:"/>
291            </filterchain>
292        </move>
293    </target>
294    <!-- target can be invoked from an ide, the output of which can be used
295         to access and fix the errors directly.
296     -->
297    <target name="checkstyle-ide" depends="checkstyle">
298        <concat>
299            <fileset file="${dist.checkstyle.dir}/checkstyle_report.emacs.txt"/>
300        </concat>
301    </target>
302
303    <target name="findbugs" depends="-def-findbugs,build-all-tools">
304        <property name="findbugs.reportLevel" value="medium"/>
305        <mkdir dir="${dist.findbugs.dir}"/>
306        <findbugs
307            home="${findbugs.home}"
308            projectName="JDK langtools ${full.version}"
309            output="xml"
310            outputFile="${dist.findbugs.dir}/findbugs.xml"
311            reportLevel="${findbugs.reportLevel}"
312            failOnError="false"
313            errorProperty="findbugs.all.errors"
314            warningsProperty="findbugs.all.warnings"
315            jvm="${target.java.home}/bin/java"
316            jvmargs="-Xmx512M">
317            <class location="${build.classes.dir}"/>
318            <sourcePath>
319                <pathelement location="${src.classes.dir}"/>
320            </sourcePath>
321        </findbugs>
322        <exec executable="sh">
323            <arg value="${findbugs.home}/bin/convertXmlToText"/>
324            <arg value="-longBugCodes"/>
325            <arg value="-html:${findbugs.home}/src/xsl/fancy.xsl"/>
326            <arg value="${dist.findbugs.dir}/findbugs.xml"/>
327            <redirector output="${dist.findbugs.dir}/findbugs.html"/>
328        </exec>
329    </target>
330
331    <target name="coverage" depends="-def-cobertura,build-all-classes,instrument-classes,jtreg,coverage-report"/>
332
333    <target name="instrument-classes" depends="-def-cobertura">
334        <!-- only define the following property when we want coverage info -->
335        <path id="coverage.classpath">
336            <pathelement location="${build.coverage.dir}/classes"/>
337            <path refid="cobertura.classpath"/>
338        </path>
339        <property name="coverage.options" value="-Dnet.sourceforge.cobertura.datafile=${build.coverage.dir}/cobertura.ser"/>
340        <property name="coverage.classpath" refid="coverage.classpath"/>
341        <mkdir dir="${build.coverage.dir}/classes"/>
342        <delete file="${build.coverage.dir}/cobertura.ser"/>
343        <cobertura-instrument todir="${build.coverage.dir}/classes"
344            datafile="${build.coverage.dir}/cobertura.ser">
345            <fileset dir="${build.classes.dir}"
346               includes="**/*.class" excludes="**/resources/*.class"/>
347        </cobertura-instrument>
348    </target>
349
350    <target name="coverage-report" depends="-def-cobertura">
351        <mkdir dir="${dist.coverage.dir}"/>
352        <cobertura-report
353            srcdir="${src.classes.dir}"
354            destdir="${dist.coverage.dir}"
355            datafile="${build.coverage.dir}/cobertura.ser"/>
356        <cobertura-report
357            format="xml"
358            srcdir="${src.classes.dir}"
359            destdir="${dist.coverage.dir}"
360            datafile="${build.coverage.dir}/cobertura.ser"/>
361    </target>
362
363    <target name="diags-examples" depends="build-javac,build-javap">
364        <!-- can override the following on the command line if desired. -->
365        <property name="diags.examples.out" location="${build.dir}/diag-examples/diags-examples.html"/>
366        <mkdir dir="${build.dir}/diag-examples/classes"/>
367        <javac fork="true"
368            executable="${dist.bin.dir}/javac"
369            srcdir="test/tools/javac/diags"
370            destdir="${build.dir}/diag-examples/classes"
371            includes="ArgTypeCompilerFactory.java,Example.java,FileManager.java,HTMLWriter.java,RunExamples.java,DocCommentProcessor.java"
372            sourcepath=""
373            classpath="${dist.lib.dir}/javac.jar;${dist.lib.dir}/javap.jar"
374            includeAntRuntime="no"
375            debug="${javac.debug}"
376            debuglevel="${javac.debuglevel}">
377            <compilerarg line="${javac.lint.opts}"/>
378        </javac>
379        <java fork="true"
380            jvm="${target.java.home}/bin/java"
381            dir="test/tools/javac/diags"
382            classpath="${build.dir}/diag-examples/classes;${dist.lib.dir}/javac.jar;${dist.lib.dir}/javap.jar"
383            classname="RunExamples">
384            <jvmarg value="-Dtest.classes=${build.dir}/diag-examples/classes"/>
385            <arg value="-examples"/>
386            <arg value="examples"/>
387            <arg value="-o"/>
388            <arg file="${diags.examples.out}"/>
389            <arg value="-showFiles"/>
390            <arg value="-title"/>
391            <arg value="Examples of javac diagnostics"/>
392        </java>
393    </target>
394
395    <!-- a patching facility to speed up incorporating the langtools' classfiles
396         into a jdk of your choice. Either target.java.home or patch.jdk can be
397         set on the command line; setting target.java.home has the advantage of
398         patching the jdk used for jtreg and other tests.
399    -->
400    <target name="patch" depends="build-all-classes">
401        <condition property="patch.jdk" value="${target.java.home}">
402            <available file="${target.java.home}" type="dir"/>
403        </condition>
404        <fail message="patch.jdk or target.java.home is not set, please set target.java.home, or patch.jdk for an alternate jdk image to patch">
405            <condition>
406                <not>
407                    <isset property="patch.jdk"/>
408                </not>
409            </condition>
410        </fail>
411        <property name="patch.tools.jar" location="${patch.jdk}/lib/tools.jar"/>
412        <property name="patch.rt.jar" location="${patch.jdk}/jre/lib/rt.jar"/>
413        <fail message="patch.jdk or target.java.home must point to a valid jdk image: missing tools.jar">
414            <condition>
415                <not>
416                    <available file="${patch.tools.jar}" type="file"/>
417                </not>
418            </condition>
419        </fail>
420        <fail message="patch.jdk or target.java.home must point to a valid jdk image: missing rt.jar">
421            <condition>
422                <not>
423                    <available file="${patch.rt.jar}" type="file"/>
424                </not>
425            </condition>
426        </fail>
427        <zip zipfile="${patch.tools.jar}" update="true">
428            <zipfileset dir="${build.classes.dir}" includes="com/**"/>
429        </zip>
430        <zip zipfile="${patch.rt.jar}" update="true">
431            <zipfileset dir="${build.classes.dir}" includes="javax/**"/>
432        </zip>
433    </target>
434
435    <target name="doclint-api" depends="build-all-classes">
436        <delete dir="${build.dir}/doclint/classes"/>
437        <mkdir dir="${build.dir}/doclint/classes"/>
438        <javac fork="true"
439               executable="${boot.javac}"
440               srcdir="${src.classes.dir}:${build.gensrc.dir}"
441               destdir="${build.dir}/doclint/classes"
442               includes="javax/lang/model/** com/sun/javadoc/** com/sun/source/**"
443               excludes=""
444               sourcepath="${javac.sourcepath}"
445               classpath="${javac.classpath}"
446               includeAntRuntime="no"
447               source="${javac.source}"
448               target="${javac.target}"
449               debug="${javac.debug}"
450               debuglevel="${javac.debuglevel}">
451            <compilerarg value="-implicit:none"/>
452            <compilerarg value="-Xprefer:source"/>
453            <compilerarg value="-J-Xbootclasspath/p:${build.bootstrap.dir}/classes"/>
454            <compilerarg line="${javac.no.jdk.warnings}"/>
455            <compilerarg line="${javac.version.opt}"/>
456            <compilerarg line="-Xdoclint:all/protected,-missing"/>
457        </javac>
458    </target>
459
460    <!-- Generate API docs for "important" test classes that are used by
461         multiple tests.
462    -->
463    <target name="test-framework-docs" depends="build-all-classes">
464        <javadoc executable="${target.java.home}/bin/javadoc"
465                destdir="${build.dir}/testframeworkdocs">
466            <!-- disable doclint for now; it might be good to enable -Xdoclint:missing -->
467            <arg value="-Xdoclint:none"/>
468            <!-- source files to be documented -->
469            <sourcefiles>
470                <fileset dir="${test.dir}">
471                    <include name="**/ToolBox.java"/>
472                    <include name="**/*Tester.java"/>
473                    <include name="**/*TestBase.java"/>
474                    <include name="**/*Testing*.java"/>
475                </fileset>
476            </sourcefiles>
477            <!-- source path used for documentation -->
478            <sourcepath>
479                <pathelement path="${test.dir}/lib"/>
480                <pathelement path="${test.dir}/lib/combo"/>
481                <pathelement path="${test.dir}/tools/javac/lib"/>
482                <pathelement path="${test.dir}/tools/javac/classfiles/attributes/LocalVariableTable"/>
483            </sourcepath>
484            <!-- exclude the following "packages" found by <javadoc>
485                on the sourcepath -->
486            <excludepackage name="combo.tools.javac.combo"/>
487            <excludepackage name="tools.javac.combo"/>
488            <!-- library classes used for documentation -->
489            <classpath>
490                <pathelement path="${jtreg.home}/lib/testng.jar"/>
491            </classpath>
492            <!-- platform classes used for documentation -->
493            <bootclasspath>
494                <pathelement path="${build.dir}/classes"/>
495                <pathelement path="${target.java.home}/jre/lib/rt.jar"/>
496            </bootclasspath>
497        </javadoc>
498    </target>
499
500    <!--
501    **** Debugging/diagnostic targets.
502    -->
503
504    <!-- standard JDK target -->
505    <target name="sanity"
506        description="display settings of configuration values">
507        <echo level="info">ant.home = ${ant.home}</echo>
508        <echo level="info">boot.java.home = ${boot.java.home}</echo>
509        <echo level="info">target.java.home = ${target.java.home}</echo>
510        <echo level="info">jtreg.home = ${jtreg.home}</echo>
511        <echo level="info">findbugs.home = ${findbugs.home}</echo>
512        <echo level="info">checkstyle.home = ${checkstyle.home}</echo>
513    </target>
514
515    <target name="post-sanity" depends="-def-jtreg,sanity,build"
516        description="perform basic validation after a standard build">
517        <jtreg
518            dir="make/test"
519            workDir="${build.jtreg.dir}/post-sanity/work"
520            reportDir="${build.jtreg.dir}/post-sanity/report"
521            jdk="${target.java.home}"
522            verbose="summary"
523            failonerror="false" resultproperty="jtreg.post-sanity.result">
524        </jtreg>
525    </target>
526
527    <!-- use vizant tool to generate graphical image of this Ant file.-->
528    <target name="vizant" depends="-def-vizant">
529        <mkdir dir="${build.dir}"/>
530        <echo message="Generating ${build.dir}/build.dot"/>
531        <vizant antfile="${make.dir}/build.xml" outfile="${build.dir}/build.dot"/>
532        <echo message="Generating ${build.dir}/build.png"/>
533        <exec executable="${dot}" >
534            <arg value="-Tpng"/>
535            <arg value="-o"/>
536            <arg file="${build.dir}/build.png"/>
537            <arg file="${build.dir}/build.dot"/>
538        </exec>
539    </target>
540
541    <target name="check-import.jdk">
542        <echo message="import.jdk: ${import.jdk}"/>
543        <echo message="import.jdk.jar: ${import.jdk.jar}"/>
544        <echo message="import.jdk.src.dir: ${import.jdk.src.dir}"/>
545    </target>
546
547    <target name="diagnostics">
548        <diagnostics/>
549    </target>
550
551
552    <!--
553    **** javac targets.
554    -->
555
556    <target name="build-bootstrap-javac"
557            depends="-def-build-bootstrap-classes,-def-build-bootstrap-jar,-def-build-bootstrap-tool">
558        <build-bootstrap-classes includes="${javac.includes}"/>
559        <build-bootstrap-jar     name="javac" includes="${javac.includes}"/>
560        <build-bootstrap-tool    name="javac"/>
561    </target>
562
563    <target name="build-classes-javac" depends="build-bootstrap-javac,-create-import-jdk-stubs">
564        <build-classes includes="${javac.includes}"/>
565    </target>
566
567    <target name="build-javac" depends="build-classes-javac">
568        <build-jar  name="javac" includes="${javac.includes}"/>
569        <build-tool name="javac"/>
570    </target>
571
572    <target name="javadoc-javac" depends="build-javac,-def-javadoc-tool">
573        <javadoc-tool name="javac" includes="${javac.includes}" options="${javadoc.jls.option}"/>
574    </target>
575
576    <target name="jtreg-javac" depends="build-javac,build-javap,-def-jtreg">
577        <jtreg-tool name="javac" tests="${javac.tests}"/>
578    </target>
579
580    <target name="findbugs-javac" depends="build-javac,-def-findbugs">
581        <findbugs-tool name="javac"/>
582    </target>
583
584    <target name="javac" depends="build-javac,jtreg-javac,findbugs-javac"/>
585
586
587    <!--
588    **** javadoc targets.
589    -->
590
591    <target name="build-bootstrap-javadoc" depends="build-bootstrap-javac">
592        <build-bootstrap-classes includes="${javadoc.includes}"/>
593        <build-bootstrap-jar     name="javadoc" includes="${javadoc.includes}"
594                                 jarclasspath="javac.jar doclets.jar"/>
595        <build-bootstrap-tool    name="javadoc"/>
596    </target>
597
598    <target name="build-classes-javadoc" depends="build-classes-javac">
599        <build-classes includes="${javadoc.includes}"/>
600    </target>
601
602    <target name="build-javadoc" depends="build-javac,build-classes-javadoc">
603        <build-jar  name="javadoc" includes="${javadoc.includes}"
604                    jarclasspath="javac.jar doclets.jar"/>
605        <build-tool name="javadoc"/>
606    </target>
607
608    <target name="javadoc-javadoc" depends="build-javadoc,-def-javadoc-tool">
609        <javadoc-tool name="javadoc" includes="${javadoc.includes}"/>
610    </target>
611
612    <target name="jtreg-javadoc" depends="build-javadoc,-def-jtreg">
613        <jtreg-tool name="javadoc" tests="${javadoc.tests}"/>
614    </target>
615
616    <target name="findbugs-javadoc" depends="build-javadoc,-def-findbugs">
617        <findbugs-tool name="javadoc"/>
618    </target>
619
620    <target name="javadoc" depends="build-javadoc,jtreg-javadoc,findbugs-javadoc"/>
621
622
623    <!--
624    **** doclets targets.
625    -->
626
627    <target name="build-bootstrap-doclets" depends="build-bootstrap-javadoc,-def-build-bootstrap-jar">
628        <build-bootstrap-classes includes="${doclets.includes}"/>
629        <build-bootstrap-jar     name="doclets" includes="${doclets.includes}"
630                                 jarmainclass="com.sun.tools.javadoc.Main"
631                                 jarclasspath="javadoc.jar"/>
632    </target>
633
634    <target name="build-classes-doclets" depends="build-classes-javadoc">
635        <build-classes includes="${doclets.includes}"/>
636    </target>
637
638    <target name="build-doclets" depends="build-javadoc,build-classes-doclets">
639        <!-- just jar, no bin for doclets -->
640        <build-jar name="doclets" includes="${doclets.includes}" jarclasspath="javadoc.jar"/>
641    </target>
642
643    <!-- (no javadoc for doclets) -->
644
645    <target name="jtreg-doclets" depends="build-doclets,-def-jtreg">
646        <jtreg-tool name="doclets" tests="${doclets.tests}"/>
647    </target>
648
649    <target name="findbugs-doclets" depends="build-doclets,-def-findbugs">
650        <findbugs-tool name="doclets"/>
651    </target>
652
653    <target name="doclets" depends="build-doclets,jtreg-doclets,findbugs-doclets"/>
654
655
656    <!--
657    **** javah targets.
658    -->
659
660    <target name="build-bootstrap-javah" depends="build-bootstrap-javadoc">
661        <build-bootstrap-classes includes="${javah.includes}"/>
662        <build-bootstrap-jar     name="javah" includes="${javah.includes}"
663                                 jarclasspath="javadoc.jar doclets.jar javac.jar"/>
664        <build-bootstrap-tool    name="javah"/>
665    </target>
666
667    <target name="build-javah" depends="build-javac,build-classes-javah">
668        <build-jar  name="javah" includes="${javah.includes}" jarclasspath="javac.jar"/>
669        <build-tool name="javah"/>
670    </target>
671
672    <target name="build-classes-javah" depends="build-classes-javadoc">
673        <build-classes includes="${javah.includes}"/>
674    </target>
675
676    <!-- (no javadoc for javah) -->
677
678    <target name="jtreg-javah" depends="build-javah,-def-jtreg">
679        <jtreg-tool name="javah" tests="${javah.tests}"/>
680    </target>
681
682    <target name="findbugs-javah" depends="build-javah,-def-findbugs">
683        <findbugs-tool name="javah"/>
684    </target>
685
686    <target name="javah" depends="build-javah,jtreg-javah,findbugs-javah"/>
687
688
689    <!--
690    **** javap targets.
691    -->
692
693    <target name="build-bootstrap-javap"
694            depends="-def-build-bootstrap-classes,-def-build-bootstrap-jar,-def-build-bootstrap-tool">
695        <build-bootstrap-classes includes="${javap.includes}"/>
696        <build-bootstrap-jar     name="javap" includes="${javap.includes}"
697                                 jarmainclass="sun.tools.javap.Main"/>
698        <build-bootstrap-tool    name="javap"/>
699    </target>
700
701    <target name="build-classes-javap" depends="build-classes-javac">
702        <build-classes includes="${javap.includes}"/>
703    </target>
704
705    <target name="build-javap" depends="build-javac,build-classes-javap">
706        <build-jar  name="javap" includes="${javap.includes}"
707                    jarmainclass="com.sun.tools.javap.Main"
708                    jarclasspath="javac.jar"/>
709        <build-tool name="javap"/>
710    </target>
711
712    <!-- (no javadoc for javap) -->
713
714    <target name="jtreg-javap" depends="build-javap,-def-jtreg">
715        <jtreg-tool name="javap" tests="${javap.tests}"/>
716    </target>
717
718    <target name="findbugs-javap" depends="build-javap,-def-findbugs">
719        <findbugs-tool name="javap"/>
720    </target>
721
722    <target name="javap" depends="build-javap,jtreg-javap,findbugs-javap"/>
723
724    <!--
725    **** sjavac targets.
726    -->
727
728    <target name="build-bootstrap-sjavac"
729            depends="-def-build-bootstrap-classes,-def-build-bootstrap-jar,-def-build-bootstrap-tool">
730        <build-bootstrap-classes includes="${sjavac.includes}"/>
731        <build-bootstrap-jar     name="sjavac" includes="${sjavac.includes}"
732                                 jarmainclass="com.sun.tools.sjavac.Main"/>
733        <build-bootstrap-tool    name="sjavac"/>
734    </target>
735
736    <target name="build-classes-sjavac" depends="build-classes-javac">
737        <build-classes includes="${sjavac.includes}"/>
738    </target>
739
740    <target name="build-sjavac" depends="build-classes-sjavac">
741        <build-jar  name="sjavac" includes="${sjavac.includes}"
742                    jarmainclass="com.sun.tools.sjavac.Main"
743                    jarclasspath="sjavac.jar"/>
744        <build-tool name="sjavac"/>
745    </target>
746
747    <!-- (no javadoc for javap) -->
748
749    <target name="jtreg-sjavac" depends="build-sjavac,-def-jtreg">
750        <jtreg-tool name="sjavac" tests="${sjavac.tests}"/>
751    </target>
752
753    <target name="findbugs-sjavac" depends="build-sjavac,-def-findbugs">
754        <findbugs-tool name="sjavac"/>
755    </target>
756
757    <target name="sjavac" depends="build-sjavac,jtreg-sjavac,findbugs-sjavac"/>
758
759    <!--
760    **** crules targets.
761    -->
762
763    <target name="build-crules" depends="-def-compilecrules,-def-build-jar-with-services">
764        <compilecrules/>
765        <build-jar-with-services
766                    name="crules"
767                    includes="crules/* crules/resources/*"
768                    classes.dir="${build.toolclasses.dir}"
769                    lib.dir="${build.toolclasses.dir}"
770                    jarmainclass=""
771                    jarclasspath="crules.jar"
772                    service.type="com.sun.source.util.Plugin"
773                    service.provider="crules.MutableFieldsAnalyzer"/>
774        <build-tool name="crules"/>
775    </target>
776
777    <target name="check-coding-rules" depends="build-bootstrap-javac,-create-import-jdk-stubs,build-crules">
778        <build-classes includes="${javac.includes}"
779            plugin.options="-J-Xbootclasspath/a:${build.toolclasses.dir}/crules.jar -Xplugin:mutable_fields_analyzer" />
780    </target>
781
782    <!--
783    **** Create import JDK stubs.
784    -->
785
786    <target name="-create-import-jdk-stubs" depends="-def-genstubs" if="require.import.jdk.stubs">
787        <mkdir dir="${build.genstubs.dir}"/>
788        <genstubs
789            srcdir="${import.jdk.src.dir}" destdir="${build.genstubs.dir}"
790            includes="${import.jdk.stub.files}"
791            fork="true" classpath="${build.toolclasses.dir}:${build.bootstrap.dir}/classes:${ant.core.lib}"
792        />
793    </target>
794
795    <!--
796    **** IDE support
797    -->
798
799    <target name="idea">
800        <mkdir dir=".idea"/>
801        <copy todir=".idea" >
802            <fileset dir="make/intellij" includes="**"/>
803        </copy>
804        <replace file=".idea/ant.xml" token="@@@" value="${jtreg.home}"/>
805    </target>
806
807    <!--
808    **** Check targets.
809    **** "-check-*" targets check that a required property is set, and set to a reasonable value.
810    **** A user friendly message is generated if not, and the build exits.
811    -->
812
813    <target name="-check-boot.java.home" depends="-def-check">
814        <check name="bootstrap java" property="boot.java.home" marker="${java.marker}"/>
815    </target>
816
817    <target name="-check-target.java.home" depends="-def-check">
818        <check name="target java" property="target.java.home" marker="${java.marker}"/>
819    </target>
820
821    <target name="-check-cobertura.home" depends="-def-check">
822        <check name="cobertura" property="cobertura.home" marker="cobertura.jar"/>
823    </target>
824
825    <target name="-check-findbugs.home" depends="-def-check">
826        <check name="findbugs" property="findbugs.home" marker="lib/findbugs.jar"/>
827    </target>
828
829    <target name="-check-checkstyle.home" depends="-def-check">
830        <check name="checkstyle" property="checkstyle.home" marker="${checkstyle.name.version}.jar"/>
831    </target>
832
833    <target name="-check-jtreg.home" depends="-def-check">
834        <check name="jtreg" property="jtreg.home" marker="lib/jtreg.jar"/>
835    </target>
836
837    <target name="-check-vizant" depends="-def-check">
838        <check name="vizant" property="vizant.jar"/>
839        <check name="dot" property="dot"/>
840    </target>
841
842
843    <!--
844    **** Targets for Ant macro and task definitions.
845    -->
846
847    <target name="-def-build-tool">
848        <macrodef name="build-tool">
849            <attribute name="name"/>
850            <attribute name="bin.dir" default="${dist.bin.dir}"/>
851            <attribute name="java" default="${launcher.java}"/>
852            <sequential>
853                <mkdir dir="@{bin.dir}"/>
854                <copy file="${src.bin.dir}/launcher.sh-template" tofile="@{bin.dir}/@{name}">
855                    <filterset begintoken="#" endtoken="#">
856                        <filter token="PROGRAM" value="@{name}"/>
857                        <filter token="TARGET_JAVA" value="@{java}"/>
858                        <filter token="PS" value="${path.separator}"/>
859                    </filterset>
860                </copy>
861                <chmod file="@{bin.dir}/@{name}" perm="ugo+rx"/>
862            </sequential>
863        </macrodef>
864    </target>
865
866    <target name="-def-build-jar">
867        <macrodef name="build-jar">
868            <attribute name="name"/>
869            <attribute name="includes"/>
870            <attribute name="classes.dir" default="${build.classes.dir}"/>
871            <attribute name="lib.dir" default="${dist.lib.dir}"/>
872            <attribute name="jarmainclass" default="com.sun.tools.@{name}.Main"/>
873            <attribute name="jarclasspath" default=""/>
874            <sequential>
875                <mkdir dir="@{lib.dir}"/>
876                <jar destfile="@{lib.dir}/@{name}.jar"
877                     basedir="@{classes.dir}"
878                     includes="@{includes}">
879                    <manifest>
880                        <attribute name="Main-Class" value="@{jarmainclass}"/>
881                        <attribute name="Class-Path" value="@{jarclasspath}"/>
882                    </manifest>
883                </jar>
884            </sequential>
885        </macrodef>
886    </target>
887
888    <target name="-def-build-jar-with-services">
889        <macrodef name="build-jar-with-services">
890            <attribute name="name"/>
891            <attribute name="includes"/>
892            <attribute name="classes.dir" default="${build.classes.dir}"/>
893            <attribute name="lib.dir" default="${dist.lib.dir}"/>
894            <attribute name="jarmainclass" default="com.sun.tools.@{name}.Main"/>
895            <attribute name="jarclasspath" default=""/>
896            <attribute name="service.type" default=""/>
897            <attribute name="service.provider" default=""/>
898            <sequential>
899                <mkdir dir="${build.toolclasses.dir}"/>
900                <jar destfile="@{lib.dir}/@{name}.jar"
901                     basedir="@{classes.dir}"
902                     includes="@{includes}">
903                    <service type="@{service.type}" provider="@{service.provider}"/>
904                    <manifest>
905                        <attribute name="Main-Class" value="@{jarmainclass}"/>
906                        <attribute name="Class-Path" value="@{jarclasspath}"/>
907                    </manifest>
908                </jar>
909            </sequential>
910        </macrodef>
911    </target>
912
913    <target name="-def-build-classes" depends="-def-pcompile">
914        <macrodef name="build-classes">
915            <attribute name="includes"/>
916            <attribute name="excludes" default="${exclude.files} **/package-info.java"/>
917            <attribute name="classes.dir" default="${build.classes.dir}"/>
918            <attribute name="gensrc.dir" default="${build.gensrc.dir}"/>
919            <attribute name="javac.bootclasspath" default="${build.bootstrap.dir}/classes"/>
920            <attribute name="bootclasspath.opt" default="${javac.bootclasspath.opt}"/>
921            <attribute name="classpath" default="${javac.classpath}"/>
922            <attribute name="sourcepath" default="${javac.sourcepath}"/>
923            <attribute name="java.home" default="${boot.java.home}"/>
924            <attribute name="source" default="${javac.source}"/>
925            <attribute name="target" default="${javac.target}"/>
926            <attribute name="release" default="${release}"/>
927            <attribute name="full.version" default="${full.version}"/>
928            <attribute name="plugin.options" default=""/>
929            <sequential>
930                <echo level="verbose" message="build-classes: excludes=@{excludes}"/>
931                <echo level="verbose" message="build-classes: bootclasspath.opt=@{bootclasspath.opt}"/>
932                <echo level="verbose" message="build-classes: classpath=@{classpath}"/>
933                <echo level="verbose" message="build-classes: sourcepath=@{sourcepath}"/>
934                <mkdir dir="@{gensrc.dir}"/>
935                <mkdir dir="@{classes.dir}"/>
936                <pcompile srcdir="${src.classes.dir}"
937                          destdir="@{gensrc.dir}"
938                          includes="@{includes}"/>
939                <copy todir="@{gensrc.dir}">
940                    <fileset dir="${src.classes.dir}" includes="@{includes}"/>
941                    <globmapper from="*.properties-template" to="*.properties"/>
942                    <filterset begintoken="$(" endtoken=")">
943                        <filter token="JDK_VERSION" value="${jdk.version}"/>
944                        <filter token="RELEASE" value="@{release}"/>
945                        <filter token="FULL_VERSION" value="@{full.version}"/>
946                    </filterset>
947                </copy>
948                <pcompile srcdir="@{gensrc.dir}"
949                          destdir="@{gensrc.dir}"
950                          includes="**/*.properties"/>
951                <javac fork="true"
952                       executable="@{java.home}/bin/javac"
953                       srcdir="${src.classes.dir}:@{gensrc.dir}"
954                       destdir="@{classes.dir}"
955                       includes="@{includes}"
956                       excludes="@{excludes}"
957                       sourcepath="@{sourcepath}"
958                       classpath="@{classpath}"
959                       includeAntRuntime="no"
960                       source="@{source}"
961                       target="@{target}"
962                       debug="${javac.debug}"
963                       debuglevel="${javac.debuglevel}">
964                    <compilerarg value="-implicit:none"/>
965                    <compilerarg value="-Xprefer:source"/>
966                    <compilerarg value="-J-Xbootclasspath/p:@{javac.bootclasspath}"/>
967                    <compilerarg line="@{bootclasspath.opt}"/>
968                    <compilerarg line="${javac.no.jdk.warnings}"/>
969                    <compilerarg line="${javac.version.opt}"/>
970                    <compilerarg line="${javac.lint.opts}"/>
971                    <compilerarg line="@{plugin.options}"/>
972                </javac>
973                <copy todir="@{classes.dir}" includeemptydirs="false">
974                    <fileset dir="${src.classes.dir}" includes="@{includes}" excludes="@{excludes}">
975                        <exclude name="**/*.java"/>
976                        <exclude name="**/*.properties"/>
977                        <exclude name="**/*-template"/>
978                        <exclude name="**/*.rej"/>
979                        <exclude name="**/*.orig"/>
980                        <exclude name="**/overview.html"/>
981                        <exclude name="**/package.html"/>
982                    </fileset>
983                </copy>
984            </sequential>
985        </macrodef>
986    </target>
987
988    <target name="-def-build-bootstrap-tool" depends="-check-boot.java.home,-def-build-tool">
989        <presetdef name="build-bootstrap-tool">
990            <build-tool
991                bin.dir="${build.bootstrap.dir}/bin"
992                java="${boot.java}"/>
993        </presetdef>
994    </target>
995
996    <target name="-def-build-bootstrap-jar" depends="-def-build-jar">
997        <presetdef name="build-bootstrap-jar">
998            <build-jar
999                classes.dir="${build.bootstrap.dir}/classes"
1000                lib.dir="${build.bootstrap.dir}/lib"/>
1001        </presetdef>
1002    </target>
1003
1004    <target name="-def-build-bootstrap-classes" depends="-def-build-classes">
1005        <presetdef name="build-bootstrap-classes">
1006            <build-classes
1007                source="${boot.javac.source}"
1008                target="${boot.javac.target}"
1009                gensrc.dir="${build.bootstrap.dir}/gensrc"
1010                classes.dir="${build.bootstrap.dir}/classes"
1011                javac.bootclasspath=""
1012                bootclasspath.opt="-Xbootclasspath/p:${build.bootstrap.dir}/classes"
1013                sourcepath=""
1014                release="${bootstrap.release}"
1015                full.version="${bootstrap.full.version}"
1016                excludes="${bootstrap.exclude.files} **/package-info.java"/>
1017        </presetdef>
1018    </target>
1019
1020    <target name="-def-pcompile">
1021        <mkdir dir="${build.toolclasses.dir}"/>
1022        <javac fork="true"
1023               source="${boot.javac.source}"
1024               target="${boot.javac.target}"
1025               executable="${boot.java.home}/bin/javac"
1026               srcdir="${make.tools.dir}"
1027               includes="compileproperties/* anttasks/CompileProperties*"
1028               destdir="${build.toolclasses.dir}/"
1029               classpath="${ant.core.lib}"
1030               bootclasspath="${boot.java.home}/jre/lib/rt.jar"
1031               includeantruntime="false">
1032            <compilerarg line="${javac.lint.opts}"/>
1033        </javac>
1034        <taskdef name="pcompile"
1035                 classname="anttasks.CompilePropertiesTask"
1036                 classpath="${build.toolclasses.dir}/"/>
1037    </target>
1038
1039    <target name="-def-compilecrules">
1040        <macrodef name="compilecrules">
1041            <sequential>
1042                <mkdir dir="${build.toolclasses.dir}"/>
1043                <javac fork="true"
1044                       source="${boot.javac.source}"
1045                       target="${boot.javac.target}"
1046                       executable="${boot.java.home}/bin/javac"
1047                       srcdir="${make.tools.dir}"
1048                       includes="crules/*"
1049                       destdir="${build.toolclasses.dir}/"
1050                       classpath="${ant.core.lib}"
1051                       bootclasspath="${boot.java.home}/jre/lib/rt.jar"
1052                       includeantruntime="false">
1053                    <compilerarg value="-Xbootclasspath/p:${build.bootstrap.dir}/classes"/>
1054                    <compilerarg line="${javac.lint.opts}"/>
1055                </javac>
1056                <copy todir="${build.toolclasses.dir}/" includeemptydirs="false">
1057                    <fileset dir="${make.tools.dir}">
1058                        <include name="**/*.properties"/>
1059                    </fileset>
1060                </copy>
1061            </sequential>
1062        </macrodef>
1063    </target>
1064
1065    <target name="-def-genstubs" depends="build-bootstrap-javac" if="require.import.jdk.stubs">
1066        <mkdir dir="${build.toolclasses.dir}"/>
1067        <javac fork="true"
1068               source="${boot.javac.source}"
1069               target="${boot.javac.target}"
1070               executable="${boot.java.home}/bin/javac"
1071               srcdir="${make.tools.dir}"
1072               includes="genstubs/* anttasks/GenStubs*"
1073               destdir="${build.toolclasses.dir}/"
1074               classpath="${ant.core.lib}"
1075               includeantruntime="false">
1076            <compilerarg value="-Xbootclasspath/p:${build.bootstrap.dir}/classes"/>
1077            <compilerarg line="${javac.lint.opts}"/>
1078        </javac>
1079        <taskdef name="genstubs"
1080                 classname="anttasks.GenStubsTask"
1081                 classpath="${build.toolclasses.dir}/"/>
1082    </target>
1083
1084    <target name="-def-javadoc-tool" depends="-check-target.java.home">
1085        <macrodef name="javadoc-tool">
1086            <attribute name="name"/>
1087            <attribute name="includes"/>
1088            <attribute name="options" default=""/>
1089            <attribute name="source" default="1.5"/> <!-- FIXME -->
1090            <sequential>
1091                <property name="javadoc.options" value=""/> <!-- default, can be overridden per user or per project -->
1092                <!-- Note: even with this default value, includes
1093                from src.classes.dir get javadoc'd; see packageset below -->
1094                <property name="javadoc.packagenames" value="none"/> <!-- default, can be overridden per user or per project -->
1095                <javadoc
1096                    executable="${target.java.home}/bin/javadoc"
1097                    destdir="${build.javadoc.dir}/@{name}"
1098                    source="@{source}"
1099                    windowtitle="UNOFFICIAL"
1100                    failonerror="true"
1101                    use="true"
1102                    author="false"
1103                    version="false"
1104                    packagenames="${javadoc.packagenames}" >
1105                    <header><![CDATA[<strong>Unofficial Javadoc</strong> generated from developer sources for preview purposes only]]></header>
1106                    <arg line="@{options}"/>
1107                    <bootclasspath>
1108                        <path location="${build.classes.dir}"/>
1109                        <path location="${target.java.home}/jre/lib/rt.jar"/>
1110                    </bootclasspath>
1111                    <sourcepath>
1112                        <pathelement location="${src.classes.dir}"/>
1113                    </sourcepath>
1114                    <!-- XXX just <fileset> (restricted further to **/*.java) and no <packageset> -->
1115                    <!-- means that {@link some.package} will not work, which is no good. -->
1116                    <!-- (It correctly skips excluded single classes, but not if packageset is also included, -->
1117                    <!-- which also causes duplicates in the class index for included files.) -->
1118                    <packageset dir="${src.classes.dir}" includes="@{includes}">
1119                        <or>
1120                            <filename name="java/"/>
1121                            <filename name="javax/"/>
1122                            <filename name="com/sun/javadoc/"/>
1123                            <filename name="com/sun/source/"/>
1124                        </or>
1125                    </packageset>
1126                </javadoc>
1127            </sequential>
1128        </macrodef>
1129    </target>
1130
1131    <target name="-def-jtreg" unless="jtreg.defined" depends="-check-jtreg.home,-check-target.java.home">
1132        <taskdef name="jtreg" classname="com.sun.javatest.regtest.Main$$Ant">
1133            <classpath>
1134                <pathelement location="${jtreg.home}/lib/jtreg.jar"/>
1135                <pathelement location="${jtreg.home}/lib/javatest.jar"/>
1136            </classpath>
1137        </taskdef>
1138        <macrodef name="jtreg-tool">
1139            <attribute name="name"/>
1140            <attribute name="tests"/>
1141            <attribute name="jdk" default="${target.java.home}"/>
1142            <attribute name="samevm" default="true"/>
1143            <attribute name="verbose" default="${default.jtreg.verbose}"/>
1144            <attribute name="options" default="${other.jtreg.options}"/>
1145            <attribute name="keywords" default="-keywords:!ignore"/>
1146            <attribute name="jpda.jvmargs" default=""/>
1147            <sequential>
1148                <property name="coverage.options" value=""/>              <!-- default -->
1149                <property name="coverage.classpath" value=""/>            <!-- default -->
1150                <property name="default.jtreg.verbose" value="summary"/>  <!-- default -->
1151                <property name="other.jtreg.options" value=""/>           <!-- default -->
1152                <jtreg
1153                    dir="${test.dir}"
1154                    workDir="${build.jtreg.dir}/@{name}/work"
1155                    reportDir="${build.jtreg.dir}/@{name}/report"
1156                    jdk="@{jdk}"
1157                    samevm="@{samevm}" verbose="@{verbose}"
1158                    failonerror="false" resultproperty="jtreg.@{name}.result"
1159                    javacoptions="-g"
1160                    vmoptions="${coverage.options} -Xbootclasspath/p:${coverage.classpath}${path.separator}${build.classes.dir} @{jpda.jvmargs}">
1161                    <arg line="@{keywords}"/>
1162                    <arg line="@{options}"/>
1163                    <arg line="@{tests}"/>
1164                </jtreg>
1165                <!-- the next two properties are for convenience, when only
1166                     a single instance of jtreg will be invoked. -->
1167                <condition property="jtreg.passed">
1168                    <equals arg1="${jtreg.@{name}.result}" arg2="0"/>
1169                </condition>
1170                <property name="jtreg.report" value="${build.jtreg.dir}/@{name}/report"/>
1171            </sequential>
1172        </macrodef>
1173        <property name="jtreg.defined" value="true"/>
1174    </target>
1175
1176    <target name="-def-cobertura" depends="-check-cobertura.home">
1177        <path id="cobertura.classpath">
1178            <fileset dir="${cobertura.home}">
1179                <include name="cobertura.jar"/>
1180                <include name="lib/**/*.jar"/>
1181            </fileset>
1182        </path>
1183        <taskdef classpathref="cobertura.classpath" resource="tasks.properties"/>
1184    </target>
1185
1186    <target name="-def-checkstyle" unless="checkstyle.defined"
1187        depends="-check-checkstyle.home">
1188        <taskdef resource="checkstyletask.properties">
1189            <classpath>
1190                <pathelement location="${checkstyle.home}/${checkstyle.name.version}-all.jar"/>
1191            </classpath>
1192        </taskdef>
1193        <property name="checkstyle.defined" value="true"/>
1194    </target>
1195
1196    <target name="-def-findbugs" unless="findbugs.defined"
1197        depends="-check-findbugs.home,-check-target.java.home">
1198        <taskdef name="findbugs" classname="edu.umd.cs.findbugs.anttask.FindBugsTask">
1199            <classpath>
1200                <pathelement location="${findbugs.home}/lib/findbugs.jar"/>
1201            </classpath>
1202        </taskdef>
1203        <macrodef name="findbugs-tool">
1204            <attribute name="name"/>
1205            <attribute name="output" default="emacs"/>
1206            <attribute name="outputFile" default=""/>
1207            <attribute name="reportLevel" default="high"/>
1208            <sequential>
1209                <findbugs
1210                    home="${findbugs.home}"
1211                    output="@{output}"
1212                    outputFile="@{outputFile}"
1213                    reportLevel="@{reportLevel}"
1214                    failOnError="false"
1215                    errorProperty="findbugs.@{name}.errors"
1216                    warningsProperty="findbugs.@{name}.warnings"
1217                    jvm="${target.java.home}/bin/java"
1218                    jvmargs="-Xmx512M" >
1219                    <class location="${dist.dir}/lib/@{name}.jar"/>
1220                    <auxClasspath>
1221                        <pathelement location="${build.classes.dir}"/>
1222                    </auxClasspath>
1223                    <sourcePath>
1224                        <pathelement location="${src.classes.dir}"/>
1225                    </sourcePath>
1226                </findbugs>
1227            </sequential>
1228        </macrodef>
1229        <property name="findbugs.defined" value="true"/>
1230    </target>
1231
1232    <target name="-def-vizant" unless="vizant.defined" depends="-check-vizant">
1233        <taskdef name="vizant" classname="net.sourceforge.vizant.Vizant" classpath="${vizant.jar}"/>
1234        <property name="vizant.defined" value="true"/>
1235    </target>
1236
1237    <target name="-def-check">
1238        <macrodef name="check">
1239            <attribute name="name"/>
1240            <attribute name="property"/>
1241            <attribute name="marker" default=""/>
1242            <sequential>
1243                <fail message="Cannot locate @{name}: please set @{property} to its location">
1244                    <condition>
1245                        <not>
1246                            <isset property="@{property}"/>
1247                        </not>
1248                    </condition>
1249                </fail>
1250                <fail message="@{name} is not installed in ${@{property}}">
1251                    <condition>
1252                        <and>
1253                            <not>
1254                                <equals arg1="@{marker}" arg2=""/>
1255                            </not>
1256                            <not>
1257                                <available file="${@{property}}/@{marker}"/>
1258                            </not>
1259                        </and>
1260                    </condition>
1261                </fail>
1262            </sequential>
1263        </macrodef>
1264    </target>
1265
1266</project>
1267
1268