1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!--
   3  Copyright (c) 2007, 2014, Oracle and/or its affiliates. All rights reserved.
   4  DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   5 
   6  This code is free software; you can redistribute it and/or modify it
   7  under the terms of the GNU General Public License version 2 only, as
   8  published by the Free Software Foundation.  Oracle designates this
   9  particular file as subject to the "Classpath" exception as provided
  10  by Oracle in the LICENSE file that accompanied this code.
  11 
  12  This code is distributed in the hope that it will be useful, but WITHOUT
  13  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15  version 2 for more details (a copy is included in the LICENSE file that
  16  accompanied this code).
  17 
  18  You should have received a copy of the GNU General Public License version
  19  2 along with this work; if not, write to the Free Software Foundation,
  20  Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  21 
  22  Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  23  or visit www.oracle.com if you need additional information or have any
  24  questions.
  25 -->
  26 
  27 <!--
  28  This is a convenience build file supporting development in the langtools
  29  repository. It can be run either standalone, or from IDEs. This build script
  30  is for a developer use only, it is not used to build the production version
  31  of javac or other langtools tools.
  32 
  33  External dependencies are specified via properties. These can be given
  34  on the command line, or by providing a local build.properties file.
  35  (They can also be edited into make/build.properties, although that is not
  36  recommended.)  At a minimum, boot.java.home must be set to the installed
  37  location of the version of JDK used to build this repository. Additional
  38  properties may be required, depending on the targets that are built.
  39  For example, to run any of the jtreg tests you must set jtreg.home,
  40  to run findbugs on the code you must set findbugs.home, and so on.
  41 
  42  The main build happens in two phases:
  43  - First, javac is built using ${boot.java.home}. (This implies a constraint
  44    on the source code that they can be compiled with the previous version of JDK.
  45  - Second, all required classes are compiled with the latest javac, created
  46    in the previous step.
  47  The build generally builds one module at time.
  48 
  49  For more details on the stub generator, see
  50     http://blogs.sun.com/jjg/entry/building_javac_for_jdk7
  51 
  52  Internal details ...
  53 
  54  Bootstrap classes are built into the build/bootstrap/<module-name>/classes directory.
  55  Final classes are built into the build/<module-name>/classes directory.
  56  Final runnable javac is in dist/bin and dist/lib. Bootstrap javac (if requested by
  57  using the build-bootstrap-javac target) is built into dist/bootstrap.
  58 
  59  This file is organized into sections as follows:
  60  - global property definitions
  61  - primary top level targets (cleaning, building, testing, producing javac)
  62  - secondary top level targets (code analysis, diagnostics, extra documentation, etc.)
  63  - utility definitions
  64  -->
  65 
  66 <project name="langtools" default="build" basedir="..">
  67     <!--
  68     **** Global property definitions.
  69     -->
  70 
  71     <!-- The following locations can be used to override default property values. -->
  72 
  73     <!-- Use this location for customizations specific to this instance of this workspace -->
  74     <property file="build.properties"/>
  75 
  76     <!-- Use this location for customizations common to all OpenJDK langtools workspaces -->
  77     <property file="${user.home}/.openjdk/${ant.project.name}-build.properties"/>
  78 
  79     <!-- Use this location for customizations common to all OpenJDK workspaces -->
  80     <property file="${user.home}/.openjdk/build.properties"/>
  81 
  82     <!-- Convenient shorthands for standard locations within the workspace. -->
  83     <property name="build.dir" location="build"/>
  84     <property name="build.crules.dir" location="${build.dir}/crules"/>
  85     <property name="build.jtreg.dir" location="${build.dir}/jtreg"/>
  86     <property name="build.toolclasses.dir" location="${build.dir}/toolclasses"/>
  87     <property name="build.javadoc.dir" location="${build.dir}/javadoc"/>
  88     <property name="dist.dir" location="dist"/>
  89     <property name="dist.bin.dir" location="${dist.dir}/bin"/>
  90     <property name="dist.lib.dir" location="${dist.dir}/lib"/>
  91     <property name="dist.findbugs.dir" location="${dist.dir}/findbugs"/>
  92     <property name="dist.checkstyle.dir" location="${dist.dir}/checkstyle"/>
  93     <property name="make.dir" location="make"/>
  94     <property name="make.conf.dir" location="${make.dir}/conf"/>
  95     <property name="make.tools.dir" location="${make.dir}/tools"/>
  96     <property name="test.dir" location="test"/>
  97 
  98     <property name="boot.build.dir" location="${build.dir}/bootstrap"/>
  99     <property name="boot.dist.dir" location="${dist.dir}/bootstrap"/>
 100     <property name="boot.dist.bin.dir" location="${boot.dist.dir}/bin"/>
 101     <property name="boot.dist.lib.dir" location="${boot.dist.dir}/lib"/>
 102 
 103     <!-- java.marker is set to a marker file to check for within a Java install dir.
 104          The best file to check for across Solaris/Linux/Windows/MacOS is one of the
 105          executables; regrettably, that is OS-specific. -->
 106     <condition property="java.marker" value="bin/java">
 107         <os family="unix"/>
 108     </condition>
 109     <condition property="java.marker" value="bin/java.exe">
 110         <os family="windows"/>
 111     </condition>
 112 
 113     <!-- Standard property values, if not overriden by earlier settings. -->
 114     <property file="${make.dir}/build.properties"/>
 115 
 116     <!-- launcher.java is used in the launcher scripts provided to run
 117         the tools' jar files.  If it has not already been set, then
 118         default it to use ${target.java.home}, if available, otherwise
 119         quietly default to simply use "java". -->
 120     <condition property="launcher.java"
 121         value="${target.java.home}/bin/java" else="java">
 122         <isset property="target.java.home"/>
 123     </condition>
 124 
 125     <!-- setup basic properties holding paths to all sources, generated source and class directories
 126          (both boot and non-boot) -->
 127     <pathconvert property="langtools.sources">
 128         <path>
 129             <pathelement path="${langtools.modules}" />
 130         </path>
 131         <map from="${basedir}/" to="${basedir}/src/" />
 132         <mapper type="glob" from="*" to="*/share/classes"/>
 133     </pathconvert>
 134     <pathconvert property="langtools.gensrc">
 135         <path>
 136             <pathelement path="${langtools.modules}" />
 137         </path>
 138         <map from="${basedir}/" to="${build.dir}/" />
 139         <mapper type="glob" from="*" to="*/gensrc"/>
 140     </pathconvert>
 141     <pathconvert property="langtools.boot.classes">
 142         <path>
 143             <pathelement path="${langtools.modules}" />
 144         </path>
 145         <map from="${basedir}/" to="${boot.build.dir}/" />
 146         <mapper type="glob" from="*" to="*/classes"/>
 147     </pathconvert>
 148     <pathconvert property="langtools.classes">
 149         <path>
 150             <pathelement path="${langtools.modules}" />
 151         </path>
 152         <map from="${basedir}/" to="${build.dir}/" />
 153         <mapper type="glob" from="*" to="*/classes"/>
 154     </pathconvert>
 155 
 156     <!--
 157         **** Primary targets
 158     -->
 159 
 160     <target name="clean" description="Delete all generated files">
 161         <delete dir="${build.dir}"/>
 162         <delete dir="${dist.dir}"/>
 163     </target>
 164 
 165     <target name="build" depends="build-all-tools">
 166     </target>
 167 
 168     <target name="build-all-tools" depends="build-all-classes,-def-build-all-module-jars,-def-build-tool">
 169         <build-all-module-jars />
 170         <build-tool name="javac"/>
 171         <build-tool name="javadoc"/>
 172         <build-tool name="javap"/>
 173         <build-tool name="javah"/>
 174         <build-tool name="sjavac"/>
 175     </target>
 176 
 177     <target name="build-all-classes" depends="-def-build-all-module-classes,build-bootstrap-javac-classes">
 178         <build-all-module-classes />
 179     </target>
 180 
 181     <target name="jtreg" depends="build-all-tools,-def-jtreg">
 182         <jtreg-tool name="all" tests="${jtreg.tests}"/>
 183     </target>
 184 
 185     <target name="javadoc" depends="build-all-classes,-def-javadoc-tool">
 186         <javadoc-tool options="${javadoc.jls.option}"/>
 187     </target>
 188 
 189     <target name="build-bootstrap-javac-classes" depends="-check-boot.java.home,-def-build-all-module-classes">
 190         <build-all-module-classes compilation.kind="boot." />
 191     </target>
 192 
 193     <!--
 194         **** Extra targets
 195     -->
 196 
 197     <target name="build-bootstrap-javac" depends="build-bootstrap-javac-classes,-def-build-all-module-jars,-def-build-tool">
 198         <build-all-module-jars compilation.kind="boot." />
 199         <build-tool name="javac" compilation.kind="boot." />
 200     </target>
 201 
 202     <target name="jtreg-bootstrap-javac" depends="build-bootstrap-javac,-def-jtreg">
 203         <jtreg-tool name="bootstrap-javac"
 204                     tests="${boot.javac.tests}"
 205                     langtools.classes="${langtools.boot.classes}"/>
 206     </target>
 207 
 208     <target name="checkstyle" depends="-def-checkstyle"
 209         description="Generates reports for code convention violations.">
 210         <mkdir dir="${dist.checkstyle.dir}"/>
 211         <checkstyle config="${make.conf.dir}/checkstyle-langtools.xml"
 212               failureProperty="checkstyle.failure"
 213               failOnViolation="false">
 214             <formatter type="xml" tofile="${dist.checkstyle.dir}/checkstyle_report.xml"/>
 215             <fileset dir="src" includes="**/*.java, **/*.properties"/>
 216         </checkstyle>
 217         <!-- transform the output to a simple html -->
 218         <xslt  in="${dist.checkstyle.dir}/checkstyle_report.xml"
 219                out="${dist.checkstyle.dir}/checkstyle_report.html"
 220                style="${checkstyle.home}/contrib/checkstyle-simple.xsl"/>
 221         <!-- transform the output to a very simple emacs friendly text file -->
 222         <xslt  in="${dist.checkstyle.dir}/checkstyle_report.xml"
 223                out="${dist.checkstyle.dir}/checkstyle_report.tmp"
 224                style="${make.conf.dir}/checkstyle-emacs.xsl"/>
 225         <!-- beautify remove extra lines -->
 226         <move file="${dist.checkstyle.dir}/checkstyle_report.tmp"
 227              toFile="${dist.checkstyle.dir}/checkstyle_report.emacs.txt">
 228             <filterchain>
 229                 <ignoreblank/>
 230                 <replaceregex byline="true" pattern="^File:" replace="${line.separator}File:"/>
 231             </filterchain>
 232         </move>
 233     </target>
 234     <!-- target can be invoked from an ide, the output of which can be used
 235          to access and fix the errors directly.
 236      -->
 237     <target name="checkstyle-ide" depends="checkstyle">
 238         <concat>
 239             <fileset file="${dist.checkstyle.dir}/checkstyle_report.emacs.txt"/>
 240         </concat>
 241     </target>
 242 
 243     <target name="findbugs" depends="-def-findbugs,build-all-tools">
 244         <property name="findbugs.reportLevel" value="medium"/>
 245         <mkdir dir="${dist.findbugs.dir}"/>
 246         <findbugs
 247             home="${findbugs.home}"
 248             projectName="JDK langtools ${full.version}"
 249             output="xml"
 250             outputFile="${dist.findbugs.dir}/findbugs.xml"
 251             reportLevel="${findbugs.reportLevel}"
 252             failOnError="false"
 253             errorProperty="findbugs.all.errors"
 254             warningsProperty="findbugs.all.warnings"
 255             jvm="${target.java.home}/bin/java"
 256             jvmargs="-Xmx512M">
 257             <class location="${build.dir}/java.base/classes"/>
 258             <class location="${build.dir}/java.compiler/classes"/>
 259             <class location="${build.dir}/jdk.compiler/classes"/>
 260             <class location="${build.dir}/jdk.javadoc/classes"/>
 261             <class location="${build.dir}/jdk.dev/classes"/>
 262             <sourcePath>
 263                 <pathelement path="${langtools.sources}"/>
 264             </sourcePath>
 265         </findbugs>
 266         <exec executable="sh">
 267             <arg value="${findbugs.home}/bin/convertXmlToText"/>
 268             <arg value="-longBugCodes"/>
 269             <arg value="-html:${findbugs.home}/src/xsl/fancy.xsl"/>
 270             <arg value="${dist.findbugs.dir}/findbugs.xml"/>
 271             <redirector output="${dist.findbugs.dir}/findbugs.html"/>
 272         </exec>
 273     </target>
 274 
 275     <target name="diags-examples" depends="build-all-tools">
 276         <!-- can override the following on the command line if desired. -->
 277         <property name="diags.examples.out" location="${build.dir}/diag-examples/diags-examples.html"/>
 278         <mkdir dir="${build.dir}/diag-examples/classes"/>
 279         <javac fork="true"
 280             executable="${dist.bin.dir}/javac"
 281             srcdir="test/tools/javac/diags"
 282             destdir="${build.dir}/diag-examples/classes"
 283             includes="ArgTypeCompilerFactory.java,Example.java,FileManager.java,HTMLWriter.java,RunExamples.java,DocCommentProcessor.java"
 284             sourcepath=""
 285             classpath="${langtools.classes}"
 286             includeAntRuntime="no"
 287             debug="${javac.debug}"
 288             debuglevel="${javac.debuglevel}">
 289             <compilerarg line="${javac.lint.opts}"/>
 290         </javac>
 291         <java fork="true"
 292             jvm="${target.java.home}/bin/java"
 293             dir="test/tools/javac/diags"
 294             classpath="${build.dir}/diag-examples/classes;${langtools.classes}"
 295             classname="RunExamples">
 296             <jvmarg value="-Dtest.classes=${build.dir}/diag-examples/classes"/>
 297             <arg value="-examples"/>
 298             <arg value="examples"/>
 299             <arg value="-o"/>
 300             <arg file="${diags.examples.out}"/>
 301             <arg value="-showFiles"/>
 302             <arg value="-title"/>
 303             <arg value="Examples of javac diagnostics"/>
 304         </java>
 305     </target>
 306 
 307     <target name="doclint-api" depends="build-all-classes">
 308         <delete dir="${build.dir}/doclint/classes"/>
 309         <mkdir dir="${build.dir}/doclint/classes"/>
 310         <javac fork="true"
 311                executable="${boot.java.home}/bin/javac"
 312                destdir="${build.dir}/doclint/classes"
 313                includes="javax/lang/model/** com/sun/javadoc/** com/sun/source/**"
 314                excludes=""
 315                sourcepath=""
 316                classpath="${langtools.classes}"
 317                includeAntRuntime="no"
 318                source="${javac.source}"
 319                target="${javac.target}"
 320                debug="${javac.debug}"
 321                debuglevel="${javac.debuglevel}">
 322             <compilerarg value="-implicit:none"/>
 323             <compilerarg value="-Xprefer:source"/>
 324             <compilerarg value="-J-Xbootclasspath/p:${build.bootstrap.dir}/classes"/>
 325             <compilerarg line="${javac.extra.opts}"/>
 326             <compilerarg line="-Xdoclint:all/protected,-missing"/>
 327             <src>
 328                 <pathelement path="${langtools.sources}"/>
 329                 <pathelement path="${langtools.gensrc}"/>
 330             </src>
 331         </javac>
 332     </target>
 333 
 334     <!-- Generate API docs for "important" test classes that are used by
 335          multiple tests.
 336     -->
 337     <target name="test-framework-docs" depends="build-all-classes">
 338         <javadoc executable="${target.java.home}/bin/javadoc"
 339                 destdir="${build.dir}/testframeworkdocs">
 340             <!-- disable doclint for now; it might be good to enable -Xdoclint:missing -->
 341             <arg value="-Xdoclint:none"/>
 342             <!-- source files to be documented -->
 343             <sourcefiles>
 344                 <fileset dir="${test.dir}">
 345                     <include name="**/ToolBox.java"/>
 346                     <include name="**/*Tester.java"/>
 347                     <include name="**/*TestBase.java"/>
 348                     <include name="**/*Testing*.java"/>
 349                 </fileset>
 350             </sourcefiles>
 351             <!-- source path used for documentation -->
 352             <sourcepath>
 353                 <pathelement path="${test.dir}/lib"/>
 354                 <pathelement path="${test.dir}/lib/combo"/>
 355                 <pathelement path="${test.dir}/tools/javac/lib"/>
 356                 <pathelement path="${test.dir}/tools/javac/classfiles/attributes/LocalVariableTable"/>
 357             </sourcepath>
 358             <!-- exclude the following "packages" found by <javadoc>
 359                 on the sourcepath -->
 360             <excludepackage name="combo.tools.javac.combo"/>
 361             <excludepackage name="tools.javac.combo"/>
 362             <!-- library classes used for documentation -->
 363             <classpath>
 364                 <pathelement path="${jtreg.home}/lib/testng.jar"/>
 365             </classpath>
 366             <!-- platform classes used for documentation -->
 367             <bootclasspath>
 368                 <pathelement path="${langtools.classes}"/>
 369                 <pathelement path="${target.java.home}/jre/lib/rt.jar"/>
 370             </bootclasspath>
 371         </javadoc>
 372     </target>
 373 
 374     <target name="sanity"
 375         description="display settings of configuration values">
 376         <echo level="info">ant.home = ${ant.home}</echo>
 377         <echo level="info">boot.java.home = ${boot.java.home}</echo>
 378         <echo level="info">target.java.home = ${target.java.home}</echo>
 379         <echo level="info">jtreg.home = ${jtreg.home}</echo>
 380         <echo level="info">findbugs.home = ${findbugs.home}</echo>
 381         <echo level="info">checkstyle.home = ${checkstyle.home}</echo>
 382     </target>
 383 
 384     <target name="diagnostics">
 385         <diagnostics/>
 386     </target>
 387 
 388     <target name="jtreg-crules" depends="build-all-classes,-def-jtreg">
 389         <mkdir dir="${build.crules.dir}/classes"/>
 390         <javac fork="true"
 391                source="${boot.javac.source}"
 392                target="${boot.javac.target}"
 393                executable="${boot.java.home}/bin/javac"
 394                srcdir="${make.tools.dir}"
 395                includes="crules/*"
 396                destdir="${build.crules.dir}/classes"
 397                includeantruntime="false">
 398             <compilerarg value="-Xbootclasspath/p:${langtools.classes}"/>
 399             <compilerarg line="${javac.lint.opts}"/>
 400         </javac>
 401         <copy todir="${build.crules.dir}/classes" includeemptydirs="false">
 402             <fileset dir="${make.tools.dir}">
 403                 <include name="**/*.properties"/>
 404             </fileset>
 405         </copy>
 406         <echo file="${build.crules.dir}/classes/META-INF/services/com.sun.source.util.Plugin">crules.CodingRulesAnalyzerPlugin</echo>
 407         <jtreg-tool name="crules"
 408                     tests="${crules.tests}"
 409                     extra.jvmargs="-Xbootclasspath/a:${build.crules.dir}/classes" />
 410     </target>
 411 
 412     <!--
 413     **** IDE support
 414     -->
 415 
 416     <target name="idea">
 417         <mkdir dir=".idea"/>
 418         <copy todir=".idea" >
 419             <fileset dir="make/intellij" excludes="**/src/**"/>
 420         </copy>
 421         <condition property="jtreg.idea.home" value="${jtreg.home}" else = "[jtreg.home]">
 422             <isset property="jtreg.home"/>
 423         </condition>
 424         <replace file=".idea/ant.xml" token="@@@" value="${jtreg.idea.home}"/>
 425         <replace file=".idea/workspace.xml" token="@FILE_SEP@" value="${file.separator}"/>
 426         <replace file=".idea/workspace.xml" token="@PATH_SEP@" value="${path.separator}"/>
 427         <mkdir dir=".idea/classes"/>
 428         <javac srcdir="make/intellij/src"
 429                destdir=".idea/classes"/>
 430     </target>
 431 
 432     <!--
 433     **** Check targets.
 434     **** "-check-*" targets check that a required property is set, and set to a reasonable value.
 435     **** A user friendly message is generated if not, and the build exits.
 436     -->
 437 
 438     <target name="-check-boot.java.home" depends="-def-check">
 439         <check name="bootstrap java" property="boot.java.home" marker="${java.marker}"/>
 440     </target>
 441 
 442     <target name="-check-target.java.home" depends="-def-check">
 443         <check name="target java" property="target.java.home" marker="${java.marker}"/>
 444     </target>
 445 
 446     <target name="-check-jtreg.home" depends="-def-check">
 447         <check name="jtreg" property="jtreg.home" marker="lib/jtreg.jar"/>
 448     </target>
 449 
 450     <target name="-check-findbugs.home" depends="-def-check">
 451         <check name="findbugs" property="findbugs.home" marker="lib/findbugs.jar"/>
 452     </target>
 453 
 454     <target name="-check-checkstyle.home" depends="-def-check">
 455         <check name="checkstyle" property="checkstyle.home" marker=""/> <!--TODO: better checkstyle verification-->
 456     </target>
 457 
 458     <!-- Definitions -->
 459 
 460     <target name="-def-build-all-module-jars" depends="-def-build-module-jar">
 461         <macrodef name="build-all-module-jars">
 462             <attribute name="compilation.kind" default=""/>
 463             <sequential>
 464                 <build-module-jar module.name="java.base" compilation.kind="@{compilation.kind}" />
 465                 <build-module-jar module.name="java.compiler" compilation.kind="@{compilation.kind}" />
 466                 <build-module-jar module.name="jdk.compiler" compilation.kind="@{compilation.kind}" />
 467                 <build-module-jar module.name="jdk.javadoc" compilation.kind="@{compilation.kind}" />
 468                 <build-module-jar module.name="jdk.dev" compilation.kind="@{compilation.kind}" />
 469             </sequential>
 470         </macrodef>
 471     </target>
 472 
 473     <target name="-def-build-module-jar">
 474         <macrodef name="build-module-jar">
 475             <attribute name="module.name"/>
 476             <attribute name="compilation.kind"/>
 477             <attribute name="dependencies" default="${@{compilation.kind}@{module.name}.dependencies}"/>
 478             <attribute name="build.dir" default="${@{compilation.kind}build.dir}"/>
 479             <attribute name="lib.dir" default="${@{compilation.kind}dist.lib.dir}"/>
 480             <attribute name="classes.dir" default="@{build.dir}/@{module.name}/classes"/>
 481             <sequential>
 482                 <mkdir dir="@{lib.dir}"/>
 483                 <local name="jarclasspath" />
 484                 <pathconvert property="jarclasspath">
 485                     <path>
 486                         <pathelement path="@{dependencies}" />
 487                     </path>
 488                     <map from="${basedir}/" to="" />
 489                     <mapper type="glob" from="*" to="*.jar"/>
 490                 </pathconvert>
 491                 <jar destfile="@{lib.dir}/@{module.name}.jar"
 492                      basedir="@{classes.dir}">
 493                     <manifest>
 494                         <attribute name="Class-Path" value="@{jarclasspath}"/>
 495                     </manifest>
 496                 </jar>
 497             </sequential>
 498         </macrodef>
 499     </target>
 500 
 501     <target name="-def-build-tool">
 502         <macrodef name="build-tool">
 503             <attribute name="name"/>
 504             <attribute name="compilation.kind" default=""/>
 505             <attribute name="bin.dir" default="${@{compilation.kind}dist.bin.dir}"/>
 506             <attribute name="java" default="${launcher.java}"/>
 507             <sequential>
 508                 <mkdir dir="@{bin.dir}"/>
 509                 <copy file="${make.dir}/launcher.sh-template" tofile="@{bin.dir}/@{name}">
 510                     <filterset begintoken="#" endtoken="#">
 511                         <filter token="PROGRAM" value="@{name}"/>
 512                         <filter token="TARGET_JAVA" value="@{java}"/>
 513                         <filter token="PS" value="${path.separator}"/>
 514                     </filterset>
 515                 </copy>
 516                 <chmod file="@{bin.dir}/@{name}" perm="ugo+rx"/>
 517             </sequential>
 518         </macrodef>
 519     </target>
 520 
 521     <target name="-def-build-all-module-classes" depends="-def-build-module-classes">
 522         <macrodef name="build-all-module-classes">
 523             <attribute name="compilation.kind" default=""/>
 524             <sequential>
 525                 <build-module-classes module.name="java.base"
 526                                       compilation.kind="@{compilation.kind}" />
 527                 <build-module-classes module.name="java.compiler"
 528                                       compilation.kind="@{compilation.kind}" />
 529                 <build-module-classes module.name="jdk.compiler"
 530                                       compilation.kind="@{compilation.kind}"
 531                                       resource.includes="${javac.resource.includes}" />
 532                 <build-module-classes module.name="jdk.javadoc"
 533                                       compilation.kind="@{compilation.kind}" />
 534                 <build-module-classes module.name="jdk.dev"
 535                                       compilation.kind="@{compilation.kind}" />
 536             </sequential>
 537         </macrodef>
 538     </target>
 539 
 540     <target name="-def-build-module-classes" depends="-def-pcompile,-def-pparse">
 541         <macrodef name="build-module-classes">
 542             <attribute name="module.name"/>
 543             <attribute name="compilation.kind" default=""/>
 544             <attribute name="resource.includes" default="nonExistent" />
 545             <attribute name="dependencies" default="${@{module.name}.dependencies}"/>
 546             <attribute name="includes" default="${@{compilation.kind}javac.includes}"/>
 547             <attribute name="javac.lint.opts" default="${@{compilation.kind}javac.lint.opts}"/>
 548             <attribute name="javac.extra.opts" default="${@{compilation.kind}javac.extra.opts}"/>
 549             <attribute name="build.dir" default="${@{compilation.kind}build.dir}"/>
 550             <attribute name="excludes" default="${exclude.files} **/package-info.java"/>
 551             <attribute name="classes.dir" default="@{build.dir}/@{module.name}/classes"/>
 552             <attribute name="gensrc.dir" default="@{build.dir}/@{module.name}/gensrc"/>
 553             <attribute name="depcache.dir" default="@{build.dir}/@{module.name}/depcache"/>
 554             <attribute name="java.home" default="${boot.java.home}"/>
 555             <attribute name="source" default="${@{compilation.kind}javac.source}"/>
 556             <attribute name="target" default="${@{compilation.kind}javac.target}"/>
 557             <attribute name="release" default="${release}"/>
 558             <attribute name="full.version" default="${full.version}"/>
 559             <attribute name="plugin.options" default=""/>
 560             <sequential>
 561                 <echo level="verbose" message="build-classes: excludes=@{excludes}"/>
 562                 <echo level="verbose" message="build-classes: classpath=@{classpath}"/>
 563                 <echo level="verbose" message="build-classes: sourcepath=@{sourcepath}"/>
 564                 <echo level="verbose" message="build-classes: dependencies=@{dependencies}"/>
 565                 <local name="src.dir" />
 566                 <property name="src.dir" location="${basedir}/src/@{module.name}/share/classes"/>
 567                 <local name="classpath" />
 568                 <pathconvert property="classpath">
 569                     <path>
 570                         <pathelement path="@{dependencies}" />
 571                     </path>
 572                     <map from="${basedir}/" to="@{build.dir}/" />
 573                     <mapper type="glob" from="*" to="*/classes"/>
 574                 </pathconvert>
 575                 <local name="bootclasspath.prepend"/>
 576                 <condition property="bootclasspath.prepend" value="" else="${langtools.boot.classes}">
 577                     <equals arg1="@{compilation.kind}" arg2="boot."/>
 578                 </condition>
 579                 <mkdir dir="@{classes.dir}"/>
 580                 <mkdir dir="@{gensrc.dir}"/>
 581                 <mkdir dir="@{depcache.dir}"/>
 582                 <pcompile destdir="@{gensrc.dir}"
 583                           includes="@{includes}">
 584                     <src>
 585                         <path location="${src.dir}"/>
 586                     </src>
 587                 </pcompile>
 588                 <pparse destdir="@{gensrc.dir}"
 589                         includes="@{resource.includes}">
 590                     <src>
 591                         <path location="${src.dir}"/>
 592                     </src>
 593                 </pparse>
 594                 <copy todir="@{gensrc.dir}">
 595                     <fileset dir="${src.dir}" includes="@{includes}" />
 596                     <globmapper from="*.properties-template" to="*.properties"/>
 597                     <filterset begintoken="$(" endtoken=")">
 598                         <filter token="JDK_VERSION" value="${jdk.version}"/>
 599                         <filter token="RELEASE" value="@{release}"/>
 600                         <filter token="FULL_VERSION" value="@{full.version}"/>
 601                     </filterset>
 602                 </copy>
 603                 <pcompile destdir="@{gensrc.dir}"
 604                           includes="**/*.properties">
 605                     <src>
 606                         <pathelement location="@{gensrc.dir}"/>
 607                     </src>
 608                 </pcompile>
 609                 <antcall target="-do-depend">
 610                     <param name="src.dir" value="${src.dir}" />
 611                     <param name="classes.dir" value="@{classes.dir}" />
 612                     <param name="gensrc.dir" value="@{gensrc.dir}" />
 613                     <param name="depcache.dir" value="@{depcache.dir}" />
 614                     <param name="classpath" value="${classpath}" />
 615                 </antcall>
 616                 <javac fork="true"
 617                        executable="@{java.home}/bin/javac"
 618                        destdir="@{classes.dir}"
 619                        includes="@{includes}"
 620                        excludes="@{excludes}"
 621                        sourcepath="${src.dir}:@{gensrc.dir}"
 622                        classpath="${classpath}"
 623                        includeAntRuntime="no"
 624                        source="@{source}"
 625                        target="@{target}"
 626                        debug="${javac.debug}"
 627                        debuglevel="${javac.debuglevel}">
 628                     <compilerarg value="-implicit:none"/>
 629                     <compilerarg value="-Xprefer:source"/>
 630                     <compilerarg value="-J-Xbootclasspath/p:${bootclasspath.prepend}"/>
 631                     <compilerarg value="-Xbootclasspath/p:${classpath}"/>
 632                     <compilerarg line="@{javac.extra.opts}"/>
 633                     <compilerarg line="@{javac.lint.opts}"/>
 634                     <compilerarg line="@{plugin.options}"/>
 635                     <src>
 636                         <path location="${src.dir}"/>
 637                         <path location="@{gensrc.dir}"/>
 638                     </src>
 639                 </javac>
 640                 <copy todir="@{classes.dir}" includeemptydirs="false">
 641                     <fileset dir="${src.dir}" includes="@{includes}" excludes="@{excludes}">
 642                         <exclude name="**/*.java"/>
 643                         <exclude name="**/*.properties"/>
 644                         <exclude name="**/*-template"/>
 645                         <exclude name="**/*.rej"/>
 646                         <exclude name="**/*.orig"/>
 647                         <exclude name="**/overview.html"/>
 648                         <exclude name="**/package.html"/>
 649                     </fileset>
 650                 </copy>
 651             </sequential>
 652         </macrodef>
 653     </target>
 654 
 655     <target name="-def-pparse">
 656         <mkdir dir="${build.toolclasses.dir}"/>
 657         <copy todir="${build.toolclasses.dir}/propertiesparser" >
 658             <fileset dir="make/tools/propertiesparser" includes="**/resources/**"/>
 659         </copy>
 660         <javac fork="true"
 661                source="${boot.javac.source}"
 662                target="${boot.javac.target}"
 663                executable="${boot.java.home}/bin/javac"
 664                srcdir="${make.tools.dir}"
 665                includes="propertiesparser/* anttasks/PropertiesParser* anttasks/PathFileSet*"
 666                destdir="${build.toolclasses.dir}/"
 667                classpath="${ant.core.lib}"
 668                bootclasspath="${boot.java.home}/jre/lib/rt.jar"
 669                includeantruntime="false">
 670             <compilerarg line="${javac.lint.opts}"/>
 671         </javac>
 672         <taskdef name="pparse"
 673                  classname="anttasks.PropertiesParserTask"
 674                  classpath="${build.toolclasses.dir}/"/>
 675     </target>
 676 
 677     <target name="-do-depend" if="do.depend">
 678         <depend srcdir="${src.dir}:${gensrc.dir}" destdir="${classes.dir}" classpath="${classpath}"
 679                 cache="${depcache.dir}"/>
 680     </target>
 681 
 682     <target name="-def-pcompile">
 683         <mkdir dir="${build.toolclasses.dir}"/>
 684         <javac fork="true"
 685                source="${boot.javac.source}"
 686                target="${boot.javac.target}"
 687                executable="${boot.java.home}/bin/javac"
 688                srcdir="${make.tools.dir}"
 689                includes="compileproperties/* anttasks/CompileProperties* anttasks/PathFileSet*"
 690                destdir="${build.toolclasses.dir}/"
 691                classpath="${ant.core.lib}"
 692                bootclasspath="${boot.java.home}/jre/lib/rt.jar"
 693                includeantruntime="false">
 694             <compilerarg line="${javac.lint.opts}"/>
 695         </javac>
 696         <taskdef name="pcompile"
 697                  classname="anttasks.CompilePropertiesTask"
 698                  classpath="${build.toolclasses.dir}/"/>
 699     </target>
 700 
 701     <target name="-def-javadoc-tool" depends="-check-target.java.home">
 702         <macrodef name="javadoc-tool">
 703             <attribute name="includes" default="${javac.includes}"/>
 704             <attribute name="options" default=""/>
 705             <attribute name="source" default="${javac.source}"/>
 706             <sequential>
 707                 <property name="javadoc.options" value=""/> <!-- default, can be overridden per user or per project -->
 708                 <!-- Note: even with this default value, includes
 709                 from source directories get javadoc'd; see packageset below -->
 710                 <property name="javadoc.packagenames" value="none"/> <!-- default, can be overridden per user or per project -->
 711                 <javadoc
 712                     executable="${target.java.home}/bin/javadoc"
 713                     destdir="${build.javadoc.dir}"
 714                     source="@{source}"
 715                     windowtitle="UNOFFICIAL"
 716                     failonerror="true"
 717                     use="true"
 718                     author="false"
 719                     version="false"
 720                     packagenames="${javadoc.packagenames}" >
 721                     <header><![CDATA[<strong>Unofficial Javadoc</strong> generated from developer sources for preview purposes only]]></header>
 722                     <arg line="@{options}"/>
 723                     <bootclasspath>
 724                         <pathelement path="${langtools.classes}"/>
 725                         <path location="${target.java.home}/jre/lib/rt.jar"/>
 726                     </bootclasspath>
 727                     <sourcepath>
 728                         <pathelement path="${langtools.sources}"/>
 729                     </sourcepath>
 730                     <!-- XXX just <fileset> (restricted further to **/*.java) and no <packageset> -->
 731                     <!-- means that {@link some.package} will not work, which is no good. -->
 732                     <!-- (It correctly skips excluded single classes, but not if packageset is also included, -->
 733                     <!-- which also causes duplicates in the class index for included files.) -->
 734                     <packageset dir="${basedir}/src/java.compiler/share/classes" includes="@{includes}">
 735                         <or>
 736                             <filename name="javax/"/>
 737                         </or>
 738                     </packageset>
 739                     <packageset dir="${basedir}/src/jdk.compiler/share/classes" includes="@{includes}">
 740                         <or>
 741                             <filename name="com/sun/source/"/>
 742                         </or>
 743                     </packageset>
 744                     <packageset dir="${basedir}/src/jdk.javadoc/share/classes" includes="@{includes}">
 745                         <or>
 746                             <filename name="com/sun/javadoc/"/>
 747                         </or>
 748                     </packageset>
 749                 </javadoc>
 750             </sequential>
 751         </macrodef>
 752     </target>
 753 
 754     <target name="-def-jtreg" unless="jtreg.defined" depends="-check-jtreg.home,-check-target.java.home">
 755         <taskdef name="jtreg" classname="com.sun.javatest.regtest.Main$$Ant">
 756             <classpath>
 757                 <pathelement location="${jtreg.home}/lib/jtreg.jar"/>
 758                 <pathelement location="${jtreg.home}/lib/javatest.jar"/>
 759             </classpath>
 760         </taskdef>
 761         <macrodef name="jtreg-tool">
 762             <attribute name="name"/>
 763             <attribute name="tests"/>
 764             <attribute name="langtools.classes" default="${langtools.classes}"/>
 765             <attribute name="jdk" default="${target.java.home}"/>
 766             <attribute name="samevm" default="true"/>
 767             <attribute name="verbose" default="${default.jtreg.verbose}"/>
 768             <attribute name="options" default="${other.jtreg.options}"/>
 769             <attribute name="keywords" default="-keywords:!ignore"/>
 770             <attribute name="jpda.jvmargs" default=""/>
 771             <attribute name="extra.jvmargs" default=""/>
 772             <attribute name="build.dir" default="${build.dir}"/>
 773             <sequential>
 774                 <property name="coverage.options" value=""/>              <!-- default -->
 775                 <property name="coverage.classpath" value=""/>            <!-- default -->
 776                 <property name="default.jtreg.verbose" value="summary"/>  <!-- default -->
 777                 <property name="other.jtreg.options" value=""/>           <!-- default -->
 778                 <jtreg
 779                     dir="${test.dir}"
 780                     workDir="${build.jtreg.dir}/@{name}/work"
 781                     reportDir="${build.jtreg.dir}/@{name}/report"
 782                     jdk="@{jdk}"
 783                     samevm="@{samevm}" verbose="@{verbose}"
 784                     failonerror="false" resultproperty="jtreg.@{name}.result"
 785                     javacoptions="-g"
 786                     vmoptions="${coverage.options} -Xbootclasspath/p:${coverage.classpath}${path.separator}@{langtools.classes} @{jpda.jvmargs} @{extra.jvmargs}">
 787                     <arg line="@{keywords}"/>
 788                     <arg line="@{options}"/>
 789                     <arg line="@{tests}"/>
 790                 </jtreg>
 791                 <!-- the next two properties are for convenience, when only
 792                      a single instance of jtreg will be invoked. -->
 793                 <condition property="jtreg.passed">
 794                     <equals arg1="${jtreg.@{name}.result}" arg2="0"/>
 795                 </condition>
 796                 <property name="jtreg.report" value="${build.jtreg.dir}/@{name}/report"/>
 797             </sequential>
 798         </macrodef>
 799         <property name="jtreg.defined" value="true"/>
 800     </target>
 801 
 802     <target name="-def-checkstyle" unless="checkstyle.defined" depends="-check-checkstyle.home">
 803         <taskdef resource="checkstyletask.properties">
 804             <classpath>
 805               <fileset dir="${checkstyle.home}">
 806                 <include name="checkstyle-*-all.jar"/>
 807               </fileset>
 808             </classpath>
 809         </taskdef>
 810         <property name="checkstyle.defined" value="true"/>
 811     </target>
 812 
 813     <target name="-def-findbugs" unless="findbugs.defined"
 814         depends="-check-findbugs.home,-check-target.java.home">
 815         <taskdef name="findbugs" classname="edu.umd.cs.findbugs.anttask.FindBugsTask">
 816             <classpath>
 817                 <pathelement location="${findbugs.home}/lib/findbugs.jar"/>
 818             </classpath>
 819         </taskdef>
 820         <macrodef name="findbugs-tool">
 821             <attribute name="name"/>
 822             <attribute name="output" default="emacs"/>
 823             <attribute name="outputFile" default=""/>
 824             <attribute name="reportLevel" default="high"/>
 825             <sequential>
 826                 <findbugs
 827                     home="${findbugs.home}"
 828                     output="@{output}"
 829                     outputFile="@{outputFile}"
 830                     reportLevel="@{reportLevel}"
 831                     failOnError="false"
 832                     errorProperty="findbugs.@{name}.errors"
 833                     warningsProperty="findbugs.@{name}.warnings"
 834                     jvm="${target.java.home}/bin/java"
 835                     jvmargs="-Xmx512M" >
 836                     <class location="${dist.dir}/lib/@{name}.jar"/>
 837                     <auxClasspath>
 838                         <pathelement location="${langtools.classes}"/>
 839                     </auxClasspath>
 840                     <sourcePath>
 841                         <path refid="src.dirs"/>
 842                     </sourcePath>
 843                 </findbugs>
 844             </sequential>
 845         </macrodef>
 846         <property name="findbugs.defined" value="true"/>
 847     </target>
 848 
 849     <target name="-def-check">
 850         <macrodef name="check">
 851             <attribute name="name"/>
 852             <attribute name="property"/>
 853             <attribute name="marker" default=""/>
 854             <sequential>
 855                 <fail message="Cannot locate @{name}: please set @{property} to its location">
 856                     <condition>
 857                         <not>
 858                             <isset property="@{property}"/>
 859                         </not>
 860                     </condition>
 861                 </fail>
 862                 <fail message="@{name} is not installed in ${@{property}}">
 863                     <condition>
 864                         <and>
 865                             <not>
 866                                 <equals arg1="@{marker}" arg2=""/>
 867                             </not>
 868                             <not>
 869                                 <available file="${@{property}}/@{marker}"/>
 870                             </not>
 871                         </and>
 872                     </condition>
 873                 </fail>
 874             </sequential>
 875         </macrodef>
 876     </target>
 877 
 878 </project>
 879