1 <?xml version="1.0"?>
   2 <!--
   3  Copyright (c) 2009, 2010, 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 <project name="jaxp" default="all" basedir=".">
  28    
  29     <!-- For 'ant -p' or 'ant -projecthelp' -->
  30     
  31     <description>
  32     Ant build script for the ${ant.project.name} part of the jdk.
  33 
  34     Input Properties: (see build.properties for the ant defaults)
  35       bootstrap.dir        - dir with lib/javac.jar, added to javac bootclasspath
  36       javac.debug          - true or false for debug classfiles
  37       javac.target         - classfile version target
  38       javac.source         - source version
  39 
  40       Run 'make help' for help using the Makefile.
  41     </description>
  42 
  43     <!-- Project build properties. -->
  44     <property file="build.properties"/>
  45 
  46     <!-- Source dir def -->
  47     <property name="jaxp.src.dir" value="src"/>
  48     <path id="src.dir.id">
  49       <pathelement path="${jaxp.src.dir}"/>
  50     </path>
  51 
  52     <!-- Initialization of directories needed for build. -->
  53     <target name="init">
  54         <mkdir dir="${build.dir}"/>
  55         <mkdir dir="${build.classes.dir}"/>
  56         <mkdir dir="${dist.dir}"/>
  57         <mkdir dir="${dist.lib.dir}"/>
  58     </target>
  59     
  60     <!-- Sanity checks and settings -->
  61     <target name="sanity"
  62             depends="-javac-jar-exists"
  63             description="Display settings of configuration values">
  64         <echo message="${sanity.info}"/>
  65     </target>
  66 
  67      <!-- Check for bootstrap javac.jar file, warn if missing. -->
  68     <condition property="javac.jar.exists">
  69         <available file="${javac.jar}" type="file"/>
  70     </condition>
  71     <target name="-javac-jar-exists"
  72             unless="javac.jar.exists">
  73         <echo message="WARNING: Cannot find ${javac.jar}"/>
  74     </target>
  75 
  76     <!-- Creation of distribution files to jdk build process. -->
  77     <target name="dist"
  78             depends="init, build, -dist-classes-jar, -dist-src-zip"
  79             description="Create all built distribution files.">
  80     </target>
  81     <target name="-dist-classes-jar-uptodate"
  82             depends="init">
  83         <condition property="dist.classes.jar.uptodate">
  84             <and>
  85                 <available file="${dist.classes.jar}" type="file"/>
  86                 <uptodate targetfile="${dist.classes.jar}">
  87                     <srcfiles dir="${build.classes.dir}" includes="**"/>
  88                 </uptodate>
  89             </and>
  90         </condition>
  91     </target>
  92     <target name="-dist-classes-jar"
  93             depends="init, -dist-classes-jar-uptodate"
  94             unless="dist.classes.jar.uptodate">
  95         <delete file="${dist.classes.jar}"/>
  96         <jar file="${dist.classes.jar}" basedir="${build.classes.dir}"/>
  97     </target>
  98 
  99     <!-- Special build area setup. -->
 100     <target name="-build-setup" depends="init">
 101         <mkdir dir="${build.classes.dir}"/>
 102         <copy todir="${build.classes.dir}">
 103             <fileset dir="${jaxp.src.dir}"
 104                      includes="**/*.properties"/>
 105         </copy>
 106         <replaceregexp match="#(.*)$" replace="#" flags="gm">
 107             <fileset dir="${build.classes.dir}" includes="**/*.properties"/>
 108         </replaceregexp>
 109     </target>
 110 
 111     <!-- Create src.zip. -->
 112     <target name="-dist-src-zip" depends="init">
 113         <zip file="${dist.src.zip}" basedir="${jaxp.src.dir}"/>
 114     </target>
 115     
 116     <!-- Build (compilation) of sources to class files. -->
 117     <target name="build"
 118             depends="compile, -build-setup">
 119     </target>
 120     <target name="compile"
 121             depends="init">
 122         <mkdir dir="${build.classes.dir}"/>
 123         <javac 
 124              includeAntRuntime="false" 
 125              classpath="${build.classes.dir}:${tools.jar}"
 126              fork="true"
 127              destdir="${build.classes.dir}"
 128              memoryInitialSize="${javac.memoryInitialSize}"
 129              memoryMaximumSize="${javac.memoryMaximumSize}"
 130              source="${javac.source}"
 131              debug="${javac.debug}"
 132              target="${javac.target}">
 133             <compilerarg value="-J-Xbootclasspath/p:${javac.jar}"/>
 134             <compilerarg line="${javac.version.opt} ${javac.lint.opts} ${javac.no.jdk.warnings}"/>
 135             <src refid="src.dir.id"/>
 136         </javac>
 137     </target>
 138 
 139     <!-- Test. (FIXME: Need to know how to run tests.) -->
 140     <target name="test"
 141             depends="init, dist">
 142         <echo message="FIXME: How do you run the tests"/>
 143     </target>
 144     
 145     <!-- Populate source area if needed. -->
 146     <target name="source"
 147             depends="init"
 148             description="Populate all source file directories">
 149     </target>
 150 
 151     <!-- Clean up compiled files. -->
 152     <target name="clean"
 153             description="Delete all generated files">
 154         <delete dir="${build.dir}"/>
 155         <delete dir="${dist.dir}"/>
 156     </target>
 157 
 158     <!-- Clean up compiled files and all imported source files. -->
 159     <target name="clobber"
 160             depends="clean"
 161             description="Delete all generated files, including imported sources">
 162     </target>
 163 
 164     <target name="-banner">
 165         <echo message="+---------------------------------------+"/>
 166         <echo message="+ Starting ant project ${ant.project.name} +"/>
 167         <echo message="+---------------------------------------+"/>
 168     </target>
 169    
 170     <!-- Do everything but test. -->
 171     <target name="all"
 172             depends="-banner, sanity, dist"
 173             description="Build everything.">
 174         <echo message="+---------------------------------------+"/>
 175         <echo message="+ Finishing ant project ${ant.project.name}"/>
 176         <echo message="+---------------------------------------+"/>
 177     </target>
 178 
 179     <target name="javadoc" depends="init" description="Build basic Javadoc for public packages.">
 180         <property name="javadoc.options" value=""/> <!-- default, can be overridden per user or per project -->
 181         <!-- Note: even with this default value, includes/excludes
 182          from share.src.dir get javadoc'd; see packageset below -->
 183         <property name="javadoc.packagenames" value="none"/> <!-- default, can be overridden per user or per project -->
 184         <property name="javadoc.dir" value="${build.dir}/docs/api"/>
 185         <property name="includes" value="**"/>
 186         <javadoc destdir="${javadoc.dir}" source="1.5"
 187             windowtitle="UNOFFICIAL" failonerror="true" use="true"
 188             author="false" version="false"
 189             packagenames="${javadoc.packagenames}">
 190             <header><![CDATA[<strong>Unofficial Javadoc</strong> generated from developer sources for preview purposes only]]></header>
 191             <arg line="${javadoc.options}"/>
 192             <bootclasspath>
 193                 <path location="${java.home}/lib/rt.jar"/>
 194                 <path location="${build.classes.dir}"/>
 195             </bootclasspath>
 196             <sourcepath>
 197                 <pathelement location="${jaxp.src.dir}"/>
 198             </sourcepath>
 199             <!-- XXX just <fileset> (restricted further to **/*.java) and no <packageset> -->
 200             <!-- means that {@link some.package} will not work, which is no good. -->
 201             <!-- (It correctly skips excluded single classes, but not if packageset is also included, -->
 202             <!-- which also causes duplicates in the class index for included files.) -->
 203             <packageset dir="${jaxp.src.dir}" includes="${includes}" excludes="${excludes}">
 204                 <or>
 205                     <filename name="java/"/>
 206                     <filename name="javax/"/>
 207                     <filename name="org/ietf/jgss/"/>
 208                     <filename name="org/omg/"/>
 209                     <filename name="org/w3c/"/>
 210                     <filename name="org/xml/sax/"/>
 211                 </or>
 212             </packageset>
 213         </javadoc>
 214     </target>
 215     <target name="javadoc-nb" depends="javadoc" if="netbeans.home">
 216         <property name="javadoc.dir=" value="${build.dir}/docs/api"/>
 217         <nbbrowse file="${javadoc.dir}/index.html"/>
 218     </target>
 219 
 220 </project>