build.xml revision 841
4880N/A<?xml version="1.0" encoding="UTF-8"?>
0N/A<!--
0N/A Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved.
0N/A DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A
0N/A This code is free software; you can redistribute it and/or modify it
0N/A under the terms of the GNU General Public License version 2 only, as
0N/A published by the Free Software Foundation. Oracle designates this
0N/A particular file as subject to the "Classpath" exception as provided
0N/A by Oracle in the LICENSE file that accompanied this code.
0N/A
0N/A This code is distributed in the hope that it will be useful, but WITHOUT
0N/A ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A version 2 for more details (a copy is included in the LICENSE file that
0N/A accompanied this code).
0N/A
2362N/A You should have received a copy of the GNU General Public License version
2362N/A 2 along with this work; if not, write to the Free Software Foundation,
2362N/A Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
1178N/A
4892N/A Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
0N/A or visit www.oracle.com if you need additional information or have any
0N/A questions.
1178N/A-->
0N/A
0N/A<!--
0N/A This is the main build file for the complete langtools repository.
0N/A It is used when building JDK (in which case it is invoked from the
0N/A Makefile), and it can be used when working on the tools themselves,
0N/A in an IDE such as NetBeans.
0N/A
0N/A External dependencies are specified via properties. These can be given
0N/A on the command line, or by providing a local build.properties file.
0N/A (They can also be edited into make/build.properties, although that is not
0N/A recommended.) At a minimum, boot.java.home must be set to the installed
0N/A location of the version of JDK used to build this repository. Additional
0N/A properties may be required, depending on the targets that are built.
0N/A For example, to run any of the jtreg tests you must set jtreg.home,
0N/A to run findbugs on the code you must set findbugs.home, and so on.
0N/A
0N/A For the most part, javac can be built using the previous version of JDK.
0N/A However, a small number of javac files require access to the latest JDK,
0N/A which may not yet have been compiled. To compile these files, you can do
0N/A one of the following:
0N/A - Set boot.java.home to a recent build of the latest version of JDK.
0N/A - Set import.jdk to either a recent build (containing jre/lib/rt.jar)
0N/A or to jdk source repository. In the latter case, stub files will
0N/A automatically be generated and used for the required API, to avoid
0N/A unnecessary compilation of the source repository.
0N/A If you do neither, the relevant files will not be built.
0N/A
0N/A The main build happens in two phases:
0N/A - First, javac and other tools as needed are built using ${boot.java.home}.
0N/A (This implies a constraint on the source code that they can be compiled
0N/A with the previous version of JDK.
0N/A - Second, all required classes are compiled with the latest javac, created
0N/A in the previous step.
0N/A The first phase is called the bootstrap phase. All targets, properties and
0N/A tasks that are specific to that phase have "bootstrap" in their name.
0N/A
0N/A For more details on the JDK build, see
0N/A http://blogs.sun.com/kto/entry/anatomy_of_the_jdk_build
0N/A http://openjdk.java.net/groups/build/
0N/A For more details on the stub generator, see
0N/A http://blogs.sun.com/jjg/entry/building_javac_for_jdk7
4176N/A
0N/A Internal details ...
0N/A
0N/A Interim build products are created in the build/ directory.
0N/A Final build products are created in the dist/ directory.
0N/A When building JDK, the dist/directory will contain:
0N/A - A bootstrap compiler suitable for running with ${boot.java.home}
0N/A suitable for compiling downstream parts of JDK
0N/A - Source files and class files for inclusion in the JDK being built
0N/A When building standalone, the dist/directory will contain:
0N/A - Separate jar files for each of the separate langtools components
0N/A - Simple scripts to invoke the tools by executing the corresponding
0N/A jar files.
0N/A These jar files and scripts are "for developer use only".
0N/A
0N/A This file is organized into sections as follows:
0N/A - global property definitions
0N/A - general top level targets
0N/A - general diagnostic/debugging targets
0N/A - groups of targets for each tool: javac, javadoc, doclets, javah, javap, apt
0N/A Within each group, the following targets are provided, where applicable
0N/A build-bootstrap-TOOL build the bootstrap version of the tool
0N/A build-classes-TOOL build the classes for the tool
0N/A build-TOOL build the jar file and script for the tool
0N/A jtreg-TOOL build the tool and run the appropriate tests
4176N/A findbugs-TOOL run findbugs on the tool's source oode
4176N/A TOOL build the tool, run the tests, and run findbugs
4176N/A - utility definitions
4176N/A -->
4176N/A
4176N/A<project name="langtools" default="build" basedir="..">
4176N/A <!--
4880N/A **** Global property definitions.
4176N/A -->
4176N/A
4176N/A <!-- Force full debuginfo for javac if the debug.classfiles
4176N/A property is set. This must be BEFORE the include of
4176N/A build.properties because it sets javac.debuglevel. -->
1178N/A <condition property="javac.debuglevel" value="source,lines,vars">
1178N/A <equals arg1="${debug.classfiles}" arg2="true"/>
1178N/A </condition>
1178N/A
4880N/A <!-- The following locations can be used to override default property values. -->
0N/A
0N/A <!-- Use this location for customizations specific to this instance of this workspace -->
4176N/A <property file="build.properties"/>
4176N/A
4176N/A <!-- Use this location for customizations common to all OpenJDK langtools workspaces -->
4176N/A <property file="${user.home}/.openjdk/${ant.project.name}-build.properties"/>
4176N/A
4176N/A <!-- Use this location for customizations common to all OpenJDK workspaces -->
4176N/A <property file="${user.home}/.openjdk/build.properties"/>
4176N/A
4176N/A <!-- Convenient shorthands for standard locations within the workspace. -->
4176N/A <property name="build.dir" location="build"/>
4176N/A <property name="build.bootstrap.dir" location="${build.dir}/bootstrap"/>
4176N/A <property name="build.coverage.dir" location="${build.dir}/coverage"/>
1178N/A <property name="build.classes.dir" location="${build.dir}/classes"/>
1178N/A <property name="build.gensrc.dir" location="${build.dir}/gensrc"/>
1178N/A <property name="build.genstubs.dir" location="${build.dir}/genstubs"/>
1178N/A <property name="build.javadoc.dir" location="${build.dir}/javadoc"/>
4880N/A <property name="build.jtreg.dir" location="${build.dir}/jtreg"/>
0N/A <property name="build.toolclasses.dir" location="${build.dir}/toolclasses"/>
0N/A <property name="dist.dir" location="dist"/>
1178N/A <property name="dist.bin.dir" location="${dist.dir}/bin"/>
1178N/A <property name="dist.coverage.dir" location="${dist.dir}/coverage"/>
1178N/A <property name="dist.findbugs.dir" location="${dist.dir}/findbugs"/>
1178N/A <property name="dist.lib.dir" location="${dist.dir}/lib"/>
4880N/A <property name="make.dir" location="make"/>
0N/A <property name="make.tools.dir" location="${make.dir}/tools"/>
0N/A <property name="src.dir" location="src"/>
0N/A <property name="src.bin.dir" location="${src.dir}/share/bin"/>
0N/A <property name="src.classes.dir" location="${src.dir}/share/classes"/>
4176N/A <property name="test.dir" location="test"/>
4176N/A
4176N/A <!-- java.marker is set to a marker file to check for within a Java install dir.
0N/A The best file to check for across Solaris/Linux/Windows/MacOS is one of the
4176N/A executables; regrettably, that is OS-specific. -->
4176N/A <condition property="java.marker" value="bin/java">
0N/A <os family="unix"/>
0N/A </condition>
0N/A <condition property="java.marker" value="bin/java.exe">
0N/A <os family="windows"/>
4176N/A </condition>
4176N/A
1178N/A <!-- Standard property values, if not overriden by earlier settings. -->
1178N/A <property file="${make.dir}/build.properties"/>
1178N/A
1178N/A <!-- launcher.java is used in the launcher scripts provided to run
4880N/A the tools' jar files. If it has not already been set, then
0N/A default it to use ${target.java.home}, if available, otherwise
0N/A quietly default to simply use "java". -->
0N/A <condition property="launcher.java"
0N/A value="${target.java.home}/bin/java" else="java">
0N/A <isset property="target.java.home"/>
0N/A </condition>
0N/A
4176N/A <!-- Logic for handling access import jdk classes, if available.
4176N/A import.jdk should be unset, or set to jdk home (to use rt.jar)
4176N/A or to jdk repo (to use src/share/classes).
4176N/A Based on the value, if any, set up default values for javac's sourcepath,
4176N/A classpath and bootclasspath. Note: the default values are overridden
4176N/A in the build-bootstrap-classes macro. -->
4176N/A
0N/A <available property="import.jdk.src.dir" value="${import.jdk}/src/share/classes"
0N/A filepath="${import.jdk}/src/share/classes" file="java/nio/file/Path.java"/>
0N/A <available property="import.jdk.jar" value="${import.jdk}/jre/lib/rt.jar"
0N/A ignoresystemclasses="true"
0N/A classpath="${import.jdk}/jre/lib/rt.jar" classname="java.nio.file.Path"/>
0N/A
0N/A <!-- Set the default bootclasspath option used for javac.
0N/A Note that different variants of the option are used, meaning we can't just
4176N/A define the value for the option.
4176N/A Note the explicit use of the standard property ${path.separator} in the following.
4176N/A This is because Ant is not clever enough to handle direct use of : or ; -->
4176N/A <condition property="javac.bootclasspath.opt"
4176N/A value="-Xbootclasspath:${build.classes.dir}${path.separator}${import.jdk.jar}"
4176N/A else="-Xbootclasspath/p:${build.classes.dir}">
0N/A <isset property="import.jdk.jar"/>
0N/A </condition>
0N/A
0N/A <condition property="boot.java.provides.latest.jdk">
4176N/A <available
0N/A ignoresystemclasses="true"
0N/A classpath="${boot.java.home}/jre/lib/rt.jar" classname="java.nio.file.Path"/>
0N/A </condition>
4176N/A
4880N/A <condition property="bootstrap.exclude.files" value="" else="${require.latest.jdk.files}">
4880N/A <isset property="boot.java.provides.latest.jdk"/>
4880N/A </condition>
4880N/A
4880N/A <condition property="exclude.files" value="" else="${require.latest.jdk.files}">
4880N/A <or>
4880N/A <isset property="boot.java.provides.latest.jdk"/>
4880N/A <isset property="import.jdk"/>
4880N/A </or>
4880N/A </condition>
4880N/A
4880N/A <condition property="require.import.jdk.stubs">
4880N/A <and>
4880N/A <not>
4880N/A <isset property="boot.java.provides.latest.jdk"/>
0N/A </not>
0N/A <isset property="import.jdk.src.dir"/>
0N/A </and>
0N/A </condition>
0N/A
0N/A <!-- Set the default value of the sourcepath used for javac. -->
0N/A <condition property="javac.sourcepath" value="${build.genstubs.dir}" else="">
0N/A <isset property="require.import.jdk.stubs"/>
0N/A </condition>
0N/A
0N/A <!-- Set the default value of the classpath used for javac. -->
4880N/A <property name="javac.classpath" value=""/>
4880N/A
4880N/A
0N/A <!--
1178N/A **** General top level targets.
0N/A -->
0N/A
0N/A <!-- Standard target to build deliverables for JDK build. -->
4880N/A
4176N/A <target name="build" depends="build-bootstrap-tools,build-all-classes">
4176N/A <copy todir="${dist.dir}/bootstrap">
4176N/A <fileset dir="${build.bootstrap.dir}" includes="bin/,lib/"/>
4176N/A </copy>
4176N/A <chmod dir="${dist.dir}/bootstrap/bin" perm="ugo+rx">
1178N/A <include name="*"/>
1178N/A </chmod>
1178N/A <mkdir dir="${dist.lib.dir}"/>
1178N/A <jar file="${dist.lib.dir}/classes.jar" basedir="${build.classes.dir}"/>
4880N/A <zip file="${dist.lib.dir}/src.zip" basedir="${src.classes.dir}"/>
0N/A </target>
0N/A
1178N/A <target name="build-bootstrap-tools"
1178N/A depends="build-bootstrap-javac,build-bootstrap-javadoc,build-bootstrap-doclets,build-bootstrap-javah"
1178N/A />
1178N/A
4880N/A <target name="build-all-tools"
4176N/A depends="build-javac,build-javadoc,build-doclets,build-javah,build-javap,build-apt"
4176N/A />
4176N/A
4176N/A <target name="build-all-classes" depends="build-bootstrap-javac,-create-import-jdk-stubs">
4176N/A <build-classes includes="${javac.includes} ${javadoc.includes} ${doclets.includes} ${javah.includes} ${javap.includes} ${apt.includes}"/>
4176N/A </target>
0N/A
4880N/A <!-- clean -->
4880N/A
4880N/A <target name="clean" description="Delete all generated files">
4880N/A <delete dir="${build.dir}"/>
4880N/A <delete dir="${dist.dir}"/>
4880N/A </target>
0N/A
0N/A <!-- Additional targets for running tools on the build -->
0N/A
0N/A <target name="jtreg" depends="build-all-tools,-def-jtreg">
0N/A <jtreg-tool name="all" tests="${jtreg.tests}"/>
0N/A </target>
0N/A
0N/A <target name="findbugs" depends="-def-findbugs,build-all-tools">
0N/A <property name="findbugs.reportLevel" value="medium"/>
0N/A <mkdir dir="${dist.findbugs.dir}"/>
0N/A <findbugs
0N/A home="${findbugs.home}"
4880N/A projectName="JDK langtools ${full.version}"
0N/A output="xml"
0N/A outputFile="${dist.findbugs.dir}/findbugs.xml"
4176N/A reportLevel="${findbugs.reportLevel}"
4176N/A failOnError="false"
4176N/A errorProperty="findbugs.all.errors"
0N/A warningsProperty="findbugs.all.warnings"
0N/A jvm="${target.java.home}/bin/java"
0N/A jvmargs="-Xmx512M">
0N/A <class location="${build.classes.dir}"/>
1178N/A <sourcePath>
0N/A <pathelement location="${src.classes.dir}"/>
0N/A </sourcePath>
0N/A </findbugs>
4176N/A <exec executable="sh">
4176N/A <arg value="${findbugs.home}/bin/convertXmlToText"/>
4176N/A <arg value="-longBugCodes"/>
4176N/A <arg value="-html:${findbugs.home}/src/xsl/fancy.xsl"/>
4176N/A <arg value="${dist.findbugs.dir}/findbugs.xml"/>
4176N/A <redirector output="${dist.findbugs.dir}/findbugs.html"/>
4176N/A </exec>
0N/A </target>
0N/A
0N/A <target name="coverage" depends="-def-cobertura,build-all-classes,instrument-classes,jtreg,coverage-report"/>
0N/A
0N/A <target name="instrument-classes" depends="-def-cobertura">
0N/A <!-- only define the following property when we want coverage info -->
0N/A <path id="coverage.classpath">
0N/A <pathelement location="${build.coverage.dir}/classes"/>
4880N/A <path refid="cobertura.classpath"/>
4880N/A </path>
4880N/A <property name="coverage.options" value="-Dnet.sourceforge.cobertura.datafile=${build.coverage.dir}/cobertura.ser"/>
0N/A <property name="coverage.classpath" refid="coverage.classpath"/>
0N/A <mkdir dir="${build.coverage.dir}/classes"/>
0N/A <delete file="${build.coverage.dir}/cobertura.ser"/>
0N/A <cobertura-instrument todir="${build.coverage.dir}/classes"
0N/A datafile="${build.coverage.dir}/cobertura.ser">
0N/A <fileset dir="${build.classes.dir}"
0N/A includes="**/*.class" excludes="**/resources/*.class"/>
2509N/A </cobertura-instrument>
0N/A </target>
0N/A
0N/A <target name="coverage-report" depends="-def-cobertura">
0N/A <mkdir dir="${dist.coverage.dir}"/>
0N/A <cobertura-report
2509N/A srcdir="${src.classes.dir}"
0N/A destdir="${dist.coverage.dir}"
0N/A datafile="${build.coverage.dir}/cobertura.ser"/>
0N/A <cobertura-report
0N/A format="xml"
0N/A srcdir="${src.classes.dir}"
2509N/A destdir="${dist.coverage.dir}"
0N/A datafile="${build.coverage.dir}/cobertura.ser"/>
0N/A </target>
0N/A
0N/A <target name="diags-examples" depends="build-javac">
0N/A <!-- can override the following on the command line if desired. -->
0N/A <property name="diags.examples.out" location="${build.dir}/diag-examples/diags-examples.html"/>
0N/A <mkdir dir="${build.dir}/diag-examples/classes"/>
0N/A <javac fork="true"
4176N/A executable="${dist.bin.dir}/javac"
4176N/A srcdir="test/tools/javac/diags"
4176N/A destdir="${build.dir}/diag-examples/classes"
4176N/A includes="ArgTypeCompilerFactory.java,Example.java,FileManager.java,HTMLWriter.java,RunExamples.java"
0N/A sourcepath=""
4880N/A classpath="${dist.lib.dir}/javac.jar"
4892N/A includeAntRuntime="no"
4880N/A debug="${javac.debug}"
0N/A debuglevel="${javac.debuglevel}"/>
4176N/A <java fork="true"
4176N/A jvm="${target.java.home}/bin/java"
4176N/A dir="test/tools/javac/diags"
4176N/A classpath="${build.dir}/diag-examples/classes;${dist.lib.dir}/javac.jar"
4880N/A classname="RunExamples">
4176N/A <arg value="-examples"/>
0N/A <arg value="examples"/>
0N/A <arg value="-o"/>
0N/A <arg file="${diags.examples.out}"/>
0N/A <arg value="-showFiles"/>
0N/A <arg value="-title"/>
0N/A <arg value="Examples of javac diagnostics"/>
0N/A </java>
0N/A </target>
0N/A
0N/A <!-- a patching facility to speed up incorporating the langtools' classfiles
0N/A into a jdk of your choice. Either target.java.home or patch.jdk can be
4176N/A set on the command line; setting target.java.home has the advantage of
0N/A patching the jdk used for jtreg and other tests.
0N/A -->
0N/A <target name="patch" depends="build-all-classes">
0N/A <condition property="patch.jdk" value="${target.java.home}">
0N/A <available file="${target.java.home}" type="dir"/>
4176N/A </condition>
4176N/A <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">
4176N/A <condition>
4176N/A <not>
4880N/A <isset property="patch.jdk"/>
4176N/A </not>
0N/A </condition>
0N/A </fail>
0N/A <property name="patch.tools.jar" location="${patch.jdk}/lib/tools.jar"/>
0N/A <property name="patch.rt.jar" location="${patch.jdk}/jre/lib/rt.jar"/>
0N/A <fail message="patch.jdk or target.java.home must point to a valid jdk image: missing tools.jar">
0N/A <condition>
0N/A <not>
0N/A <available file="${patch.tools.jar}" type="file"/>
0N/A </not>
0N/A </condition>
0N/A </fail>
4176N/A <fail message="patch.jdk or target.java.home must point to a valid jdk image: missing rt.jar">
0N/A <condition>
0N/A <not>
0N/A <available file="${patch.rt.jar}" type="file"/>
0N/A </not>
0N/A </condition>
0N/A </fail>
1178N/A <zip zipfile="${patch.tools.jar}" update="true">
0N/A <zipfileset dir="${build.classes.dir}" includes="com/**"/>
0N/A </zip>
4176N/A <zip zipfile="${patch.rt.jar}" update="true">
4176N/A <zipfileset dir="${build.classes.dir}" includes="javax/**"/>
4176N/A </zip>
4176N/A </target>
4176N/A
4176N/A <!--
4176N/A **** Debugging/diagnostic targets.
4176N/A -->
4176N/A
4176N/A <!-- standard JDK target -->
4176N/A <target name="sanity"
4176N/A description="display settings of configuration values">
4176N/A <echo level="info">ant.home = ${ant.home}</echo>
4176N/A <echo level="info">boot.java.home = ${boot.java.home}</echo>
4176N/A <echo level="info">target.java.home = ${target.java.home}</echo>
0N/A <echo level="info">jtreg.home = ${jtreg.home}</echo>
0N/A <echo level="info">findbugs.home = ${findbugs.home}</echo>
0N/A </target>
0N/A
0N/A <target name="post-sanity" depends="-def-jtreg,sanity,build"
0N/A description="perform basic validation after a standard build">
0N/A <jtreg
0N/A dir="make/test"
0N/A workDir="${build.jtreg.dir}/post-sanity/work"
0N/A reportDir="${build.jtreg.dir}/post-sanity/report"
0N/A jdk="${target.java.home}"
0N/A verbose="summary"
0N/A failonerror="false" resultproperty="jtreg.post-sanity.result">
4880N/A </jtreg>
4880N/A </target>
4880N/A
4880N/A <!-- use vizant tool to generate graphical image of this Ant file.-->
4880N/A <target name="vizant" depends="-def-vizant">
4880N/A <mkdir dir="${build.dir}"/>
4880N/A <echo message="Generating ${build.dir}/build.dot"/>
4880N/A <vizant antfile="${make.dir}/build.xml" outfile="${build.dir}/build.dot"/>
4880N/A <echo message="Generating ${build.dir}/build.png"/>
4880N/A <exec executable="${dot}" >
4880N/A <arg value="-Tpng"/>
4880N/A <arg value="-o"/>
4880N/A <arg file="${build.dir}/build.png"/>
4880N/A <arg file="${build.dir}/build.dot"/>
4880N/A </exec>
4880N/A </target>
4880N/A
4880N/A <target name="check-import.jdk">
4880N/A <echo message="import.jdk: ${import.jdk}"/>
4892N/A <echo message="import.jdk.jar: ${import.jdk.jar}"/>
4880N/A <echo message="import.jdk.src.dir: ${import.jdk.src.dir}"/>
4880N/A </target>
4880N/A
4880N/A <target name="diagnostics">
4892N/A <diagnostics/>
4880N/A </target>
4880N/A
4880N/A
4880N/A <!--
4880N/A **** javac targets.
4880N/A -->
4880N/A
4880N/A <target name="build-bootstrap-javac"
4880N/A depends="-def-build-bootstrap-classes,-def-build-bootstrap-jar,-def-build-bootstrap-tool">
4880N/A <build-bootstrap-classes includes="${javac.includes}"/>
4880N/A <build-bootstrap-jar name="javac" includes="${javac.includes}"/>
4880N/A <build-bootstrap-tool name="javac"/>
4880N/A </target>
4880N/A
4880N/A <target name="build-classes-javac" depends="build-bootstrap-javac,-create-import-jdk-stubs">
4880N/A <build-classes includes="${javac.includes}"/>
4880N/A </target>
4880N/A
4880N/A <target name="build-javac" depends="build-classes-javac">
4880N/A <build-jar name="javac" includes="${javac.includes}"/>
4880N/A <build-tool name="javac"/>
4880N/A </target>
4880N/A
4880N/A <target name="javadoc-javac" depends="build-javac,-def-javadoc-tool">
4880N/A <javadoc-tool name="javac" includes="${javac.includes}" options="${javadoc.jls3.option}"/>
4880N/A </target>
4880N/A
4880N/A <target name="jtreg-javac" depends="build-javac,build-javap,-def-jtreg">
4880N/A <jtreg-tool name="javac" tests="${javac.tests}"/>
4880N/A </target>
4880N/A
4880N/A <target name="findbugs-javac" depends="build-javac,-def-findbugs">
4892N/A <findbugs-tool name="javac"/>
4880N/A </target>
4880N/A
0N/A <target name="javac" depends="build-javac,jtreg-javac,findbugs-javac"/>
0N/A
4880N/A
4880N/A <!--
4880N/A **** javadoc targets.
4880N/A -->
4880N/A
4880N/A <target name="build-bootstrap-javadoc" depends="build-bootstrap-javac">
4880N/A <build-bootstrap-classes includes="${javadoc.includes}"/>
4880N/A <build-bootstrap-jar name="javadoc" includes="${javadoc.includes}"
4880N/A jarclasspath="javac.jar doclets.jar"/>
4880N/A <build-bootstrap-tool name="javadoc"/>
4880N/A </target>
4880N/A
4880N/A <target name="build-classes-javadoc" depends="build-classes-javac">
4880N/A <build-classes includes="${javadoc.includes}"/>
4880N/A </target>
4880N/A
4880N/A <target name="build-javadoc" depends="build-javac,build-classes-javadoc">
4880N/A <build-jar name="javadoc" includes="${javadoc.includes}"
4880N/A jarclasspath="javac.jar doclets.jar"/>
0N/A <build-tool name="javadoc"/>
4880N/A </target>
0N/A
0N/A <target name="javadoc-javadoc" depends="build-javadoc,-def-javadoc-tool">
0N/A <javadoc-tool name="javadoc" includes="${javadoc.includes}"/>
0N/A </target>
0N/A
0N/A <target name="jtreg-javadoc" depends="build-javadoc,-def-jtreg">
0N/A <jtreg-tool name="javadoc" tests="${javadoc.tests}"/>
0N/A </target>
0N/A
0N/A <target name="findbugs-javadoc" depends="build-javadoc,-def-findbugs">
1178N/A <findbugs-tool name="javadoc"/>
0N/A </target>
0N/A
0N/A <target name="javadoc" depends="build-javadoc,jtreg-javadoc,findbugs-javadoc"/>
4176N/A
0N/A
0N/A <!--
0N/A **** doclets targets.
0N/A -->
0N/A
0N/A <target name="build-bootstrap-doclets" depends="build-bootstrap-javadoc,-def-build-bootstrap-jar">
1178N/A <build-bootstrap-classes includes="${doclets.includes}"/>
0N/A <build-bootstrap-jar name="doclets" includes="${doclets.includes}"
0N/A jarmainclass="com.sun.tools.javadoc.Main"
0N/A jarclasspath="javadoc.jar"/>
0N/A </target>
0N/A
0N/A <target name="build-classes-doclets" depends="build-classes-javadoc">
0N/A <build-classes includes="${doclets.includes}"/>
0N/A </target>
0N/A
1178N/A <target name="build-doclets" depends="build-javadoc,build-classes-doclets">
0N/A <!-- just jar, no bin for doclets -->
0N/A <build-jar name="doclets" includes="${doclets.includes}" jarclasspath="javadoc.jar"/>
0N/A </target>
1178N/A
0N/A <!-- (no javadoc for doclets) -->
4880N/A
4176N/A <target name="jtreg-doclets" depends="build-doclets,-def-jtreg">
4880N/A <jtreg-tool name="doclets" tests="${doclets.tests}"/>
4176N/A </target>
4176N/A
4176N/A <target name="findbugs-doclets" depends="build-doclets,-def-findbugs">
4176N/A <findbugs-tool name="doclets"/>
4176N/A </target>
4176N/A
4176N/A <target name="doclets" depends="build-doclets,jtreg-doclets,findbugs-doclets"/>
4176N/A
4880N/A
0N/A <!--
0N/A **** javah targets.
0N/A -->
1178N/A
0N/A <target name="build-bootstrap-javah" depends="build-bootstrap-javadoc">
0N/A <build-bootstrap-classes includes="${javah.includes}"/>
1178N/A <build-bootstrap-jar name="javah" includes="${javah.includes}"
1178N/A jarclasspath="javadoc.jar doclets.jar javac.jar"/>
1178N/A <build-bootstrap-tool name="javah"/>
1178N/A </target>
0N/A
0N/A <target name="build-javah" depends="build-javac,build-classes-javah">
1178N/A <build-jar name="javah" includes="${javah.includes}" jarclasspath="javac.jar"/>
0N/A <build-tool name="javah"/>
0N/A </target>
1178N/A
1178N/A <target name="build-classes-javah" depends="build-classes-javadoc">
1178N/A <build-classes includes="${javah.includes}"/>
4880N/A </target>
0N/A
0N/A <!-- (no javadoc for javah) -->
1178N/A
1178N/A <target name="jtreg-javah" depends="build-javah,-def-jtreg">
1178N/A <jtreg-tool name="javah" tests="${javah.tests}"/>
4880N/A </target>
0N/A
0N/A <target name="findbugs-javah" depends="build-javah,-def-findbugs">
0N/A <findbugs-tool name="javah"/>
0N/A </target>
0N/A
0N/A <target name="javah" depends="build-javah,jtreg-javah,findbugs-javah"/>
0N/A
4880N/A
0N/A <!--
0N/A **** javap targets.
0N/A -->
<target name="build-bootstrap-javap"
depends="-def-build-bootstrap-classes,-def-build-bootstrap-jar,-def-build-bootstrap-tool">
<build-bootstrap-classes includes="${javap.includes}"/>
<build-bootstrap-jar name="javap" includes="${javap.includes}"
jarmainclass="sun.tools.javap.Main"/>
<build-bootstrap-tool name="javap"/>
</target>
<target name="build-classes-javap" depends="build-classes-javac">
<build-classes includes="${javap.includes}"/>
</target>
<target name="build-javap" depends="build-javac,build-classes-javap">
<build-jar name="javap" includes="${javap.includes}"
jarmainclass="com.sun.tools.javap.Main"
jarclasspath="javac.jar"/>
<build-tool name="javap"/>
</target>
<!-- (no javadoc for javap) -->
<target name="jtreg-javap" depends="build-javap,-def-jtreg">
<jtreg-tool name="javap" tests="${javap.tests}"/>
</target>
<target name="findbugs-javap" depends="build-javap,-def-findbugs">
<findbugs-tool name="javap"/>
</target>
<target name="javap" depends="build-javap,jtreg-javap,findbugs-javap"/>
<!--
**** apt targets.
-->
<target name="build-bootstrap-apt" depends="build-bootstrap-javac">
<build-bootstrap-classes includes="${apt.includes}"/>
<build-bootstrap-jar name="apt" includes="${apt.includes}"
jarclasspath="javac.jar"/>
<build-bootstrap-tool name="apt"/>
</target>
<target name="build-apt" depends="build-javac,build-classes-apt">
<build-jar name="apt" includes="${apt.includes}" jarclasspath="javac.jar"/>
<build-tool name="apt"/>
</target>
<target name="build-classes-apt" depends="build-classes-javac">
<build-classes includes="${apt.includes}"/>
</target>
<target name="javadoc-apt" depends="build-apt,-def-javadoc-tool">
<javadoc-tool name="apt" includes="${apt.includes}"/>
</target>
<target name="jtreg-apt" depends="build-apt,-def-jtreg">
<jtreg-tool name="apt" tests="${apt.tests}"/>
</target>
<target name="findbugs-apt" depends="build-apt,-def-findbugs">
<findbugs-tool name="apt"/>
</target>
<target name="apt" depends="build-apt,jtreg-apt,findbugs-apt"/>
<!--
**** Create import JDK stubs.
-->
<target name="-create-import-jdk-stubs" depends="-def-genstubs" if="require.import.jdk.stubs">
<mkdir dir="${build.genstubs.dir}"/>
<genstubs
srcdir="${import.jdk.src.dir}" destdir="${build.genstubs.dir}"
includes="${import.jdk.stub.files}"
fork="true" classpath="${build.toolclasses.dir}:${build.bootstrap.dir}/classes:${ant.core.lib}"
/>
</target>
<!--
**** Check targets.
**** "-check-*" targets check that a required property is set, and set to a reasonable value.
**** A user friendly message is generated if not, and the build exits.
-->
<target name="-check-boot.java.home" depends="-def-check">
<check name="bootstrap java" property="boot.java.home" marker="${java.marker}"/>
</target>
<target name="-check-target.java.home" depends="-def-check">
<check name="target java" property="target.java.home" marker="${java.marker}"/>
</target>
<target name="-check-cobertura.home" depends="-def-check">
<check name="cobertura" property="cobertura.home" marker="cobertura.jar"/>
</target>
<target name="-check-findbugs.home" depends="-def-check">
<check name="findbugs" property="findbugs.home" marker="lib/findbugs.jar"/>
</target>
<target name="-check-jtreg.home" depends="-def-check">
<check name="jtreg" property="jtreg.home" marker="lib/jtreg.jar"/>
</target>
<target name="-check-vizant" depends="-def-check">
<check name="vizant" property="vizant.jar"/>
<check name="dot" property="dot"/>
</target>
<!--
**** Targets for Ant macro and task definitions.
-->
<target name="-def-build-tool">
<macrodef name="build-tool">
<attribute name="name"/>
<attribute name="bin.dir" default="${dist.bin.dir}"/>
<attribute name="java" default="${launcher.java}"/>
<sequential>
<mkdir dir="@{bin.dir}"/>
<copy file="${src.bin.dir}/launcher.sh-template" tofile="@{bin.dir}/@{name}">
<filterset begintoken="#" endtoken="#">
<filter token="PROGRAM" value="@{name}"/>
<filter token="TARGET_JAVA" value="@{java}"/>
<filter token="PS" value="${path.separator}"/>
</filterset>
</copy>
<chmod file="@{bin.dir}/@{name}" perm="ugo+rx"/>
</sequential>
</macrodef>
</target>
<target name="-def-build-jar">
<macrodef name="build-jar">
<attribute name="name"/>
<attribute name="includes"/>
<attribute name="classes.dir" default="${build.classes.dir}"/>
<attribute name="lib.dir" default="${dist.lib.dir}"/>
<attribute name="jarmainclass" default="com.sun.tools.@{name}.Main"/>
<attribute name="jarclasspath" default=""/>
<sequential>
<mkdir dir="@{lib.dir}"/>
<jar destfile="@{lib.dir}/@{name}.jar"
basedir="@{classes.dir}"
includes="@{includes}">
<manifest>
<attribute name="Main-Class" value="@{jarmainclass}"/>
<attribute name="Class-Path" value="@{jarclasspath}"/>
</manifest>
</jar>
</sequential>
</macrodef>
</target>
<target name="-def-build-classes" depends="-def-pcompile">
<macrodef name="build-classes">
<attribute name="includes"/>
<attribute name="excludes" default="${exclude.files} **/package-info.java"/>
<attribute name="classes.dir" default="${build.classes.dir}"/>
<attribute name="gensrc.dir" default="${build.gensrc.dir}"/>
<attribute name="javac.bootclasspath" default="${build.bootstrap.dir}/classes"/>
<attribute name="bootclasspath.opt" default="${javac.bootclasspath.opt}"/>
<attribute name="classpath" default="${javac.classpath}"/>
<attribute name="sourcepath" default="${javac.sourcepath}"/>
<attribute name="java.home" default="${boot.java.home}"/>
<attribute name="source" default="${javac.source}"/>
<attribute name="target" default="${javac.target}"/>
<attribute name="release" default="${release}"/>
<attribute name="full.version" default="${full.version}"/>
<sequential>
<echo level="verbose" message="build-classes: excludes=@{excludes}"/>
<echo level="verbose" message="build-classes: bootclasspath.opt=@{bootclasspath.opt}"/>
<echo level="verbose" message="build-classes: classpath=@{classpath}"/>
<echo level="verbose" message="build-classes: sourcepath=@{sourcepath}"/>
<mkdir dir="@{gensrc.dir}"/>
<mkdir dir="@{classes.dir}"/>
<pcompile srcdir="${src.classes.dir}"
destdir="@{gensrc.dir}"
includes="@{includes}"/>
<copy todir="@{gensrc.dir}">
<fileset dir="${src.classes.dir}" includes="@{includes}"/>
<globmapper from="*.properties-template" to="*.properties"/>
<filterset begintoken="$(" endtoken=")">
<filter token="JDK_VERSION" value="${jdk.version}"/>
<filter token="RELEASE" value="@{release}"/>
<filter token="FULL_VERSION" value="@{full.version}"/>
</filterset>
</copy>
<pcompile srcdir="@{gensrc.dir}"
destdir="@{gensrc.dir}"
includes="**/*.properties"/>
<javac fork="true"
executable="@{java.home}/bin/javac"
srcdir="${src.classes.dir}:@{gensrc.dir}"
destdir="@{classes.dir}"
includes="@{includes}"
excludes="@{excludes}"
sourcepath="@{sourcepath}"
classpath="@{classpath}"
includeAntRuntime="no"
source="@{source}"
target="@{target}"
debug="${javac.debug}"
debuglevel="${javac.debuglevel}">
<compilerarg value="-implicit:none"/>
<compilerarg value="-Xprefer:source"/>
<compilerarg value="-J-Xbootclasspath/p:@{javac.bootclasspath}"/>
<compilerarg line="@{bootclasspath.opt}"/>
<compilerarg line="${javac.no.jdk.warnings}"/>
<compilerarg line="${javac.version.opt}"/>
<compilerarg line="${javac.lint.opts}"/>
</javac>
<copy todir="@{classes.dir}" includeemptydirs="false">
<fileset dir="${src.classes.dir}" includes="@{includes}" excludes="@{excludes}">
<exclude name="**/*.java"/>
<exclude name="**/*.properties"/>
<exclude name="**/*-template"/>
<exclude name="**/package.html"/>
</fileset>
</copy>
</sequential>
</macrodef>
</target>
<target name="-def-build-bootstrap-tool" depends="-check-boot.java.home,-def-build-tool">
<presetdef name="build-bootstrap-tool">
<build-tool
bin.dir="${build.bootstrap.dir}/bin"
java="${boot.java}"/>
</presetdef>
</target>
<target name="-def-build-bootstrap-jar" depends="-def-build-jar">
<presetdef name="build-bootstrap-jar">
<build-jar
classes.dir="${build.bootstrap.dir}/classes"
lib.dir="${build.bootstrap.dir}/lib"/>
</presetdef>
</target>
<target name="-def-build-bootstrap-classes" depends="-def-build-classes">
<presetdef name="build-bootstrap-classes">
<build-classes
source="${boot.javac.source}"
target="${boot.javac.target}"
gensrc.dir="${build.bootstrap.dir}/gensrc"
classes.dir="${build.bootstrap.dir}/classes"
javac.bootclasspath=""
bootclasspath.opt="-Xbootclasspath/p:${build.bootstrap.dir}/classes"
sourcepath=""
release="${bootstrap.release}"
full.version="${bootstrap.full.version}"
excludes="${bootstrap.exclude.files} **/package-info.java"/>
</presetdef>
</target>
<target name="-def-pcompile">
<mkdir dir="${build.toolclasses.dir}"/>
<javac fork="true"
source="${boot.javac.source}"
target="${boot.javac.target}"
executable="${boot.java.home}/bin/javac"
srcdir="${make.tools.dir}/CompileProperties"
destdir="${build.toolclasses.dir}/"
classpath="${ant.core.lib}"
includeantruntime="false"/>
<taskdef name="pcompile"
classname="CompilePropertiesTask"
classpath="${build.toolclasses.dir}/"/>
</target>
<target name="-def-genstubs" depends="build-bootstrap-javac" if="require.import.jdk.stubs">
<mkdir dir="${build.toolclasses.dir}"/>
<javac fork="true"
source="${boot.javac.source}"
target="${boot.javac.target}"
executable="${boot.java.home}/bin/javac"
srcdir="${make.tools.dir}/GenStubs"
destdir="${build.toolclasses.dir}/"
classpath="${build.bootstrap.dir}/classes:${ant.core.lib}"
includeantruntime="false"/>
<taskdef name="genstubs"
classname="GenStubs$$Ant"
classpath="${build.toolclasses.dir}/"/>
</target>
<target name="-def-javadoc-tool" depends="-check-target.java.home">
<macrodef name="javadoc-tool">
<attribute name="name"/>
<attribute name="includes"/>
<attribute name="options" default=""/>
<attribute name="source" default="1.5"/> <!-- FIXME -->
<sequential>
<property name="javadoc.options" value=""/> <!-- default, can be overridden per user or per project -->
<!-- Note: even with this default value, includes
from src.classes.dir get javadoc'd; see packageset below -->
<property name="javadoc.packagenames" value="none"/> <!-- default, can be overridden per user or per project -->
<javadoc
executable="${target.java.home}/bin/javadoc"
destdir="${build.javadoc.dir}/@{name}"
source="@{source}"
windowtitle="UNOFFICIAL"
failonerror="true"
use="true"
author="false"
version="false"
packagenames="${javadoc.packagenames}" >
<header><![CDATA[<strong>Unofficial Javadoc</strong> generated from developer sources for preview purposes only]]></header>
<arg line="@{options}"/>
<bootclasspath>
<path location="${build.classes.dir}"/>
<path location="${target.java.home}/jre/lib/rt.jar"/>
</bootclasspath>
<sourcepath>
<pathelement location="${src.classes.dir}"/>
</sourcepath>
<!-- XXX just <fileset> (restricted further to **/*.java) and no <packageset> -->
<!-- means that {@link some.package} will not work, which is no good. -->
<!-- (It correctly skips excluded single classes, but not if packageset is also included, -->
<!-- which also causes duplicates in the class index for included files.) -->
<packageset dir="${src.classes.dir}" includes="@{includes}">
<or>
<filename name="java/"/>
<filename name="javax/"/>
<filename name="com/sun/javadoc/"/>
<filename name="com/sun/mirror/"/>
<filename name="com/sun/source/"/>
</or>
</packageset>
</javadoc>
</sequential>
</macrodef>
</target>
<target name="-def-jtreg" unless="jtreg.defined" depends="-check-jtreg.home,-check-target.java.home">
<taskdef name="jtreg" classname="com.sun.javatest.regtest.Main$$Ant">
<classpath>
<pathelement location="${jtreg.home}/lib/jtreg.jar"/>
<pathelement location="${jtreg.home}/lib/javatest.jar"/>
</classpath>
</taskdef>
<macrodef name="jtreg-tool">
<attribute name="name"/>
<attribute name="tests"/>
<attribute name="jdk" default="${target.java.home}"/>
<attribute name="samevm" default="true"/>
<attribute name="verbose" default="${default.jtreg.verbose}"/>
<attribute name="options" default="${other.jtreg.options}"/>
<attribute name="keywords" default="-keywords:!ignore"/>
<attribute name="jpda.jvmargs" default=""/>
<sequential>
<property name="coverage.options" value=""/> <!-- default -->
<property name="coverage.classpath" value=""/> <!-- default -->
<property name="default.jtreg.verbose" value="summary"/> <!-- default -->
<property name="other.jtreg.options" value=""/> <!-- default -->
<jtreg
dir="${test.dir}"
workDir="${build.jtreg.dir}/@{name}/work"
reportDir="${build.jtreg.dir}/@{name}/report"
jdk="@{jdk}"
samevm="@{samevm}" verbose="@{verbose}"
failonerror="false" resultproperty="jtreg.@{name}.result"
javacoptions="-g"
vmoptions="${coverage.options} -Xbootclasspath/p:${coverage.classpath}:${build.classes.dir} @{jpda.jvmargs}">
<arg line="@{keywords}"/>
<arg line="@{options}"/>
<arg line="@{tests}"/>
</jtreg>
<!-- the next two properties are for convenience, when only
a single instance of jtreg will be invoked. -->
<condition property="jtreg.passed">
<equals arg1="${jtreg.@{name}.result}" arg2="0"/>
</condition>
<property name="jtreg.report" value="${build.jtreg.dir}/@{name}/report"/>
</sequential>
</macrodef>
<property name="jtreg.defined" value="true"/>
</target>
<target name="-def-cobertura" depends="-check-cobertura.home">
<path id="cobertura.classpath">
<fileset dir="${cobertura.home}">
<include name="cobertura.jar"/>
<include name="lib/**/*.jar"/>
</fileset>
</path>
<taskdef classpathref="cobertura.classpath" resource="tasks.properties"/>
</target>
<target name="-def-findbugs" unless="findbugs.defined"
depends="-check-findbugs.home,-check-target.java.home">
<taskdef name="findbugs" classname="edu.umd.cs.findbugs.anttask.FindBugsTask">
<classpath>
<pathelement location="${findbugs.home}/lib/findbugs.jar"/>
</classpath>
</taskdef>
<macrodef name="findbugs-tool">
<attribute name="name"/>
<attribute name="output" default="emacs"/>
<attribute name="outputFile" default=""/>
<attribute name="reportLevel" default="high"/>
<sequential>
<findbugs
home="${findbugs.home}"
output="@{output}"
outputFile="@{outputFile}"
reportLevel="@{reportLevel}"
failOnError="false"
errorProperty="findbugs.@{name}.errors"
warningsProperty="findbugs.@{name}.warnings"
jvm="${target.java.home}/bin/java"
jvmargs="-Xmx512M" >
<class location="${dist.dir}/lib/@{name}.jar"/>
<auxClasspath>
<pathelement location="${build.classes.dir}"/>
</auxClasspath>
<sourcePath>
<pathelement location="${src.classes.dir}"/>
</sourcePath>
</findbugs>
</sequential>
</macrodef>
<property name="findbugs.defined" value="true"/>
</target>
<target name="-def-vizant" unless="vizant.defined" depends="-check-vizant">
<taskdef name="vizant" classname="net.sourceforge.vizant.Vizant" classpath="${vizant.jar}"/>
<property name="vizant.defined" value="true"/>
</target>
<target name="-def-check">
<macrodef name="check">
<attribute name="name"/>
<attribute name="property"/>
<attribute name="marker" default=""/>
<sequential>
<fail message="Cannot locate @{name}: please set @{property} to its location">
<condition>
<not>
<isset property="@{property}"/>
</not>
</condition>
</fail>
<fail message="@{name} is not installed in ${@{property}}">
<condition>
<and>
<not>
<equals arg1="@{marker}" arg2=""/>
</not>
<not>
<available file="${@{property}}/@{marker}"/>
</not>
</and>
</condition>
</fail>
</sequential>
</macrodef>
</target>
</project>