<!-- DrJava Build Script -->

<!-- This build script is based on the template located at "trunk/misc/build-template.xml"

in the DrJava Subversion repository. In general, changes made to the script should be

reflected in the template as well. -->

<project name="drjava" default="help">

<property name="readable-project-name" value="DrJava" />

<property name="src-working-dir" value="src/edu/rice/cs/drjava" />

<property name="junit-jar-to-include" value="lib/concutest-junit-4.7-withrt-nodep.jar" />

<property name="md5-temp-name" value="classes/md5.properties" />

<property name="md5-properties-path" value="edu/rice/cs/drjava/md5.properties" />

<property name="main-class" value="edu.rice.cs.drjava.DrJava" />

<property name="svn-repository" value="https://svn.code.sf.net/p/drjava/code" />

<!-- Properties loaded from a file -->

<property name="props" value="../ant.properties" />

<property file="${props}" />

<!-- Default settings for properties -->

<property name="test-spec" value="*" />

<property name="test-repeat" value="1" />

<property name="test-timeout" value="1440" />

<property name="test-formatter" value="oneline" />

<property name="findbugs-formatter" value="html" />

<property name="test-halt" value="false" />

<property name="force-server" value="no" />

<property name="findbugs-timeout" value="30" />

<property name="debug" value="void" />

<property name="plt.debug.log" value="${debug}" />

<property name="error" value="popup" />

<property name="plt.error.log" value="${error}" />

<property name="clean-can-fail" value="yes" />

<property name="link-source" value="no" />

<property name="benchmark-count" value="5" />

<property name="benchmark-skip" value="1" />

<property name="drjava.test.config" value="testFiles/drjava.basic.config" />

<property environment="env" />

<property name="java8-home" value="${env.JAVA8_HOME}" />

<property name="java7-home" value="${env.JAVA7_HOME}" />

<property name="java6-home" value="${env.JAVA6_HOME}" />

<property name="java5-home" value="${env.JAVA5_HOME}" />

<property name="launch4j-home" value="${env.LAUNCH4J_HOME}" />

<property name="clover-jar" value="${env.CLOVER_JAR}" />

<property name="findbugs-home" value="${env.FINDBUGS_HOME}" />

<property name="is-development" value="yes" /> <!-- Development or stable release -->

<property name="tag-append" value="" /> <!-- "stable", "beta", or none -->

<property name="svn-working-dir" value="${basedir}" /> <!-- svn tree base -->

<!-- Don't use or inherit the CLASSPATH environment variable for anything -->

<property name="build.sysclasspath" value="ignore" />

<!-- This property was added based on a tip found on the internet in response to many failing unit tests using Java 7 -->

<property name="run.jvmargs.ide" value=""/>

<!-- Extension that defines the "extendclasspath" task. This should be a standard feature of Ant, but

as long as it's not, we can use this extension from the Clover developers. -->

<taskdef resource="com/cenqua/ant/antlib.xml" classpath="lib/buildlib/cenquatasks.jar" />

<!-- Extension containing various tools, including "for" and "if" -->

<taskdef resource="net/sf/antcontrib/antlib.xml" classpath="lib/buildlib/ant-contrib.jar"/>

<!-- fornum task, used for test-repeat -->

<taskdef name="fornum" classname="edu.rice.cs.plt.ant.ForNumTask" classpath="lib/buildlib/plt-ant.jar" onerror="report" />

<!-- <extendclasspath path="lib/buildlib/junit.jar" /> -->

<fileset id="libs" dir="lib" includes="*.jar" /> <!-- Only include jars that are at the top level (not in buildlib) -->

<!-- Use ConcJUnit if use-concjunit is not defined and we are not running Java 7. -->

<!-- ConcJUnit is currently incompatible with Java 7. -->

<if>

<contains string="${java.version}" substring="1.7"/>

<then>

<echo message="ConcJUnit is currently incompatible with Java 7."/>

<property name="use-concjunit" value="false" />

</then>

<else>

<property name="use-concjunit" value="true" />

</else>

</if>

<!-- ************

Help Targets

************ -->

<target name="help" description="Print general build script information">

<echo message="----------------------------------------------------------------------" />

<echo message="${readable-project-name} Build Scripts" />

<echo message="----------------------------------------------------------------------" />

<echo message="Type 'ant -projecthelp' or 'ant -p' to see the list of targets." />

<echo message="Type 'ant options' to see the list of customizable options." />

<echo message="" />

<echo message="For this build file to function properly, the following environment" />

<echo message="variables may need to be defined (depending on the target invoked):" />

<echo message="PATH: The 'javac' command is used for compilation;" />

<echo message=" the 'java' command is used by default in testing/running; " />

<echo message=" the 'svn' command is used to generate version numbers and " />

<echo message=" in Subversion targets" />

<echo message="JAVA5_HOME: Home folder of the Java 5 JRE or JDK (required for" />

<echo message=" compiling and '-5' targets)" />

<echo message="JAVA6_HOME: Home folder of the Java 6 JRE or JDK (required for" />

<echo message=" '-6' targets)" />

<echo message="JAVA7_HOME: Home folder of the Java 7 JRE or JDK (required for" />

<echo message=" '-7' targets)" />

<echo message="JAVA8_HOME: Home folder of the Java 8 JRE or JDK (required for" />

<echo message=" '-8' targets)" />

<echo message="LAUNCH4J_HOME: Location of the Launch4j installation (used to " />

<echo message=" release a Windows application)" />

<echo message="CLOVER_JAR: Location of the Clover jar file" />

<echo message="FINDBUGS_HOME: Location of the FindBugs installation" />

<echo message="" />

<echo message="For control over the version of Java used to run Ant, set JAVA_HOME." />

<echo message="Ant may also require ANT_HOME to be set. Note that the value of " />

<echo message="CLASSPATH will be ignored -- classes on the system class path will " />

<echo message="not be visible during the build process." />

</target>

<target name="options" description="Print the list of customizable options">

<echo message="----------------------------------------------------------------------" />

<echo message="${readable-project-name} Build Script Customizable Options" />

<echo message="----------------------------------------------------------------------" />

<echo message="The following properties control custom behavior. They may be defined " />

<echo message="on the command line ('-Dname=value'), in a properties file (named " />

<echo message="'../ant.properties' by default, and containing 'name=value' pairs on " />

<echo message="each line), or in the ANT_ARGS environment variable (using " />

<echo message="'-Dname=value')." />

<echo message="" />

<echo message="props: An external properties file (default: 'ant.properties')" />

<echo message="test-spec: A matching string for filtering the tests to be run; may be" />

<echo message=" comma-delimited to run multiple test sets" />

<echo message="test-repeat: The number of times the tests should be repeated" />

<echo message="test-timeout: A time limit (in minutes) for running a test set" />

<echo message="test-formatter: The kind of formatter to use for test results: one of" />

<echo message=" 'quiet', 'oneline', 'brief', 'plain', or 'xml'" />

<echo message=" (default: oneline)" />

<echo message="test-halt: Whether unit testing should stop after the *first* failure"/>

<echo message=" (default: no)" />

<echo message="skip-test: Define to indicate that testing should be silently skipped" />

<echo message="skip-clean: Define to indicate that cleaning should be silently skipped" />

<echo message="skip-tag: Define to indicate that tagging should be silently skipped" />

<echo message="skip-javadoc: Define to indicate that Javadocs should not be created" />

<echo message="force-server: Whether the '-server' option should always be used when" />

<echo message=" running or testing (Default: no)" />

<echo message="clean-can-fail: Whether the failure of a 'clean' operation can halt" />

<echo message=" the build (default: yes)" />

<echo message="findbugs-timeout: A time limit (in minutes) for running findbugs " />

<echo message=" (default: 30)" />

<echo message="findbugs-formatter: Generate XML ('xml') or HTML ('html') output?" />

<echo message=" (default: 'xml')" />

<echo message="debug: Type of the debug log when running or testing: one of 'stdout'," />

<echo message=" 'stderr', 'file', 'assert', 'popup', 'tree', or 'void'" />

<echo message=" (equivalent to setting the property 'plt.debug.log'; default: " />

<echo message=" void)" />

<echo message="error: Type of the error log when running or testing: one of 'stdout'," />

<echo message=" 'stderr', 'file', 'assert', 'popup', 'tree', or 'void'" />

<echo message=" (equivalent to setting the property 'plt.error.log'; default: " />

<echo message=" popup)" />

<echo message="benchmark-count: Number of revisions to test during benchmarking"/>

<echo message=" (default: 5)" />

<echo message="benchmark-skip: Number of 'PREV' updates to perform between benchmark" />

<echo message=" runs (default: 1)" />

<echo message="drjava.test.config: Location of the DrJava configuration file to use" />

<echo message=" in tests (default: testFiles/drjava.basic.config)" />

<echo message="use-concjunit: Set to true to test ConcJUnit instead of JUnit." />

</target>

<!-- ************

Build Target

************ -->

<target name="build" depends="test, jar" description="Shortcut for 'test' and 'jar'">

</target>

<!-- *************************

Source-generating Targets

************************* -->

<property name="code-status-source" value="${src-working-dir}/CodeStatus.orig" />

<property name="code-status-target" value="${src-working-dir}/CodeStatus.java" />

<property name="version-source" value="${src-working-dir}/Version.orig" />

<property name="version-target" value="${src-working-dir}/Version.java" />

<target name="generate-source" depends="resolve-development-value, resolve-version-tag"

description="Generate the CodeStatus and Version source files">

<filter token="DEVELOPMENT" value="${development-value}" />

<filter token="DATE" value="${DSTAMP}" />

<filter token="TIME" value="${TSTAMP}" />

<filter token="REVISION" value="${svn-revision}" />

<echo message="Processing ${code-status-source}" />

<copy file="${code-status-source}" tofile="${code-status-target}" filtering="yes" />

<echo message="Processing ${version-source}" />

<copy file="${version-source}" tofile="${version-target}" filtering="yes" />

<!-- Any additional files to be generated may be processed here -->

</target>

<!-- Matches source files that are generated. Search is relative to the base directory

(NOT "src", since "src-working-dir" is defined relative to the base). This is used

by "clean". -->

<patternset id="generated-sources">

<include name="${code-status-target}" />

<include name="${version-target}" />

<!-- Additional generated sources should be listed here -->

</patternset>

<!-- *******************

Compilation Targets

******************* -->

<!-- The following target assumes that javac resolves a Java 8 compiler -->

<target name="compile" depends="generate-source, do-compile, copy-resources, unjar-libs"

description="Compile all source files (after generating the source)">

</target>

<target name="do-compile" depends="resolve-java8-runtime, resolve-java8-tools">

<echo message="Compiling src directory to classes/base and classes/test with command 'javac'" />

<mkdir dir="classes/base" />

<mkdir dir="classes/test" />

<!-- Move any test classes back to base to prevent recompilation -->

<move todir="classes/base">

<fileset dir="classes/test" includes="**/*" />

</move>

<javac srcdir="src" destdir="classes/base" source="1.6" target="1.6"

bootclasspath="${java8-runtime}" sourcepath="" includeAntRuntime="no"

executable="javac" fork="yes" memoryMaximumSize="1024M"

debug="on" optimize="off" deprecation="on" >

<classpath>

<!-- TODO: Remove this dependency on tools.jar by refactoring and moving all the dependent

debugger code into the "platform" module -->

<pathelement location="${java8-tools}" />

<fileset refid="libs" />

<pathelement location="lib/buildlib/junit.jar" />

<pathelement location="lib/buildlib/netbeans-memory-leak-utils.jar" />

<pathelement location="classes/base" />

</classpath>

<compilerarg value="-Xlint" />

<!-- Ignore serial warnings, because they occur for every Throwable definition (among others) -->

<compilerarg value="-Xlint:-serial" />

<!-- Use the next line to compile against other sources, ignoring any unneeded classes.

This can be useful in creating a pruned version of a jar file for the lib directory.

(You must also clear the sourcepath="" option.)

<include name="${src-working-dir}/**/*.java" /> -->

</javac>

<mkdir dir="classes/test" /> <!-- May be deleted by the previous move -->

<move todir="classes/test">

<fileset dir="classes/base">

<include name="**/*Test.class" />

<include name="**/*Test$*.class" />

<include name="**/*TestCase.class" />

<include name="**/*TestCase$*.class" />

<!-- Additional test classes should be listed here -->

</fileset>

</move>

</target>

<!-- The following target assumes that javac resolves to a Java 6 javac compiler -->

<target name="compile-6" depends="generate-source, do-compile-6, copy-resources, unjar-libs"

description="Compile all source files (after generating the source)">

</target>

<target name="do-compile-6" depends="resolve-java6-runtime, resolve-java6-tools">

<echo message="Compiling src directory to classes/base and classes/test with command 'javac'" />

<mkdir dir="classes/base" />

<mkdir dir="classes/test" />

<!-- Move any test classes back to base to prevent recompilation -->

<move todir="classes/base">

<fileset dir="classes/test" includes="**/*" />

</move>

<javac srcdir="src" destdir="classes/base" source="1.6" target="1.6"

bootclasspath="${java6-runtime}" sourcepath="" includeAntRuntime="no"

executable="javac" fork="yes" memoryMaximumSize="1024M"

debug="on" optimize="off" deprecation="on" >

<classpath>

<!-- TODO: Remove this dependency on tools.jar by refactoring and moving all the dependent

debugger code into the "platform" module -->

<pathelement location="${java6-tools}" />

<fileset refid="libs" />

<pathelement location="lib/buildlib/junit.jar" />

<pathelement location="lib/buildlib/netbeans-memory-leak-utils.jar" />

<pathelement location="classes/base" />

</classpath>

<compilerarg value="-Xlint" />

<!-- Ignore serial warnings, because they occur for every Throwable definition (among others) -->

<compilerarg value="-Xlint:-serial" />

<!-- Use the next line to compile against other sources, ignoring any unneeded classes.

This can be useful in creating a pruned version of a jar file for the lib directory.

(You must also clear the sourcepath="" option.)

<include name="${src-working-dir}/**/*.java" /> -->

</javac>

<mkdir dir="classes/test" /> <!-- May be deleted by the previous move -->

<move todir="classes/test">

<fileset dir="classes/base">

<include name="**/*Test.class" />

<include name="**/*Test$*.class" />

<include name="**/*TestCase.class" />

<include name="**/*TestCase$*.class" />

<!-- Additional test classes should be listed here -->

</fileset>

</move>

</target>

<!-- The following target assumes that javac resolves to a Java 7 javac compiler -->

<target name="compile-7" depends="generate-source, do-compile-7, copy-resources, unjar-libs"

description="Compile all source files (after generating the source)">

</target>

<target name="do-compile-7" depends="resolve-java7-runtime, resolve-java7-tools">

<echo message="Compiling src directory to classes/base and classes/test with command 'javac'" />

<mkdir dir="classes/base" />

<mkdir dir="classes/test" />

<!-- Move any test classes back to base to prevent recompilation -->

<move todir="classes/base">

<fileset dir="classes/test" includes="**/*" />

</move>

<javac srcdir="src" destdir="classes/base" source="1.6" target="1.6"

bootclasspath="${java7-runtime}" sourcepath="" includeAntRuntime="no"

executable="javac" fork="yes" memoryMaximumSize="1024M"

debug="on" optimize="off" deprecation="on" >

<classpath>

<!-- TODO: Remove this dependency on tools.jar by refactoring and moving all the dependent

debugger code into the "platform" module -->

<pathelement location="${java7-tools}" />

<fileset refid="libs" />

<pathelement location="lib/buildlib/junit.jar" />

<pathelement location="lib/buildlib/netbeans-memory-leak-utils.jar" />

<pathelement location="classes/base" />

</classpath>

<compilerarg value="-Xlint" />

<!-- Ignore serial warnings, because they occur for every Throwable definition (among others) -->

<compilerarg value="-Xlint:-serial" />

<!-- Use the next line to compile against other sources, ignoring any unneeded classes.

This can be useful in creating a pruned version of a jar file for the lib directory.

(You must also clear the sourcepath="" option.)

<include name="${src-working-dir}/**/*.java" /> -->

</javac>

<mkdir dir="classes/test" /> <!-- May be deleted by the previous move -->

<move todir="classes/test">

<fileset dir="classes/base">

<include name="**/*Test.class" />

<include name="**/*Test$*.class" />

<include name="**/*TestCase.class" />

<include name="**/*TestCase$*.class" />

<!-- Additional test classes should be listed here -->

</fileset>

</move>

</target>

<target name="copy-resources">

<copy todir="classes/base">

<fileset dir="src">

<include name="**/LICENSE" />

<include name="**/README" />

<include name="**/*.gif" />

<include name="**/*.png" />

<include name="**/*.jpg" />

<include name="**/*.jpeg" />

<include name="**/*.properties" />

<!-- Additional resource files should be listed here -->

</fileset>

</copy>

</target>

<target name="unjar-libs">

<antcall target="do-unjar-libs">

<param name="generate-sourcedir" value="lib" />

<param name="generate-dir" value="classes/lib" />

</antcall>

</target>

<target name="do-unjar-libs" depends="check-generate-dir-from-dir" unless="already-generated">

<echo message="Unjarring jar files in the lib directory" />

<!-- Delete "classes/lib" in case it exists (but is out of date) -->

<delete dir="classes/lib" />

<mkdir dir="classes/lib" />

<unjar dest="classes/lib">

<fileset refid="libs" />

<patternset excludes="META-INF/**" />

</unjar>

</target>

<!-- ***************

Testing Targets

*************** -->

<target name="test" depends="compile, resolve-current-tools" unless="skip-test"

description="Run all tests (after compiling); use -Dtest-spec=... to filter">

<antcall target="iterate-tests">

<param name="test-jvm" value="java" />

<param name="test-tools" value="${current-tools}" />

<param name="test-force-disable-concjunit" value="false" />

</antcall>

</target>

<target name="test-8" depends="compile, resolve-java8-exec, resolve-java8-tools" unless="skip-test"

description="Run all tests under Java 8 (after compiling); use -Dtest-spec=... to filter">

<echo message="ConcJUnit is currently incompatible with Java 7."/>

<antcall target="iterate-tests">

<param name="test-jvm" value="${java8-exec}" />

<param name="test-tools" value="${java8-tools}" />

<param name="test-force-disable-concjunit" value="true" />

</antcall>

</target>

<target name="test-7" depends="compile, resolve-java7-exec, resolve-java7-tools" unless="skip-test"

description="Run all tests under Java 7 (after compiling); use -Dtest-spec=... to filter">

<echo message="ConcJUnit is currently incompatible with Java 7."/>

<antcall target="iterate-tests">

<param name="test-jvm" value="${java7-exec}" />

<param name="test-tools" value="${java7-tools}" />

<param name="test-force-disable-concjunit" value="true" />

</antcall>

</target>

<target name="test-6" depends="compile, resolve-java6-exec, resolve-java6-tools" unless="skip-test"

description="Run all tests under Java 6 (after compiling); use -Dtest-spec=... to filter">

<antcall target="iterate-tests">

<param name="test-jvm" value="${java6-exec}" />

<param name="test-tools" value="${java6-tools}" />

<param name="test-force-disable-concjunit" value="false" />

</antcall>

</target>

<target name="test-5" depends="compile, resolve-java5-exec, resolve-java5-tools" unless="skip-test"

description="Run all tests under Java 5 (after compiling); use -Dtest-spec=... to filter">

<antcall target="iterate-tests">

<param name="test-jvm" value="${java5-exec}" />

<param name="test-tools" value="${java5-tools}" />

<param name="test-force-disable-concjunit" value="false" />

</antcall>

</target>

<target name="iterate-tests" depends="resolve-test-formatter-class">

<!-- Calls do-test, unless that is overridden by the caller -->

<property name="do-test-target" value="do-test" />

<condition property="test-iteration-message">

<not>

<equals arg1="${test-repeat}" arg2="1" />

</not>

</condition>

<condition property="test-output-to-file" value="yes" else="no">

<equals arg1="${test-formatter}" arg2="xml" />

</condition>

<!-- Repeat tests 'test-repeat' times. -->

<fornum count="${test-repeat}" param="iteration">

<sequential>

<trycatch property="test-failure" reference="test-failure-ref">

<try>

<for list="${test-spec}" param="test-filter-string-iter">

<sequential>

<limit minutes="${test-timeout}" failonerror="true">

<antcall target="${do-test-target}">

<param name="test-filter-string" value="@{test-filter-string-iter}" />

</antcall>

</limit>

</sequential>

</for>

<if>

<istrue value="${test-output-to-file}" />

<then>

<mkdir dir="testResults/@{iteration}" />

</then>

</if>

</try>

<catch>

<if>

<istrue value="${test-halt}" />

<then>

<throw refid="test-failure-ref" />

</then>

</if>

</catch>

<finally>

<if>

<istrue value="${test-output-to-file}" />

<then>

<move todir="testResults/@{iteration}">

<fileset dir="${basedir}">

<include name="TEST*" />

</fileset>

</move>

</then>

</if>

</finally>

</trycatch>

<if>

<isset property="test-iteration-message" />

<then>

<math result="iteration1" datatype="int"

operand1="@{iteration}" operation="+" operand2="1" />

<echo message="" />

<echo message="Completed test iteration ${iteration1} of ${test-repeat}" />

</then>

</if>

</sequential>

</fornum>

<!-- Handle errors where test-halt is false -->

<if>

<isset property="test-failure" />

<then>

<!-- Using 'if="test-failure"' here doesn't seem to work -->

<throw refid="test-failure-ref" />

</then>

</if>

</target>

<target name="do-test" depends="resolve-jvm-args, resolve-junit-jar">

<echo message="Running all tests matching '${test-filter-string}' with command '${test-jvm}', using '${junit-jar}' and '${test-tools}'" />

<extendclasspath path="${junit-jar}" />

<junit haltonfailure="${test-halt}" failureproperty="test-failed"

fork="yes" forkmode="perTest" maxmemory="2G" jvm="${test-jvm}" dir="${basedir}">

<classpath>

<pathelement location="${test-tools}" />

<pathelement location="${junit-jar}" />

<pathelement location="lib/buildlib/plt-ant.jar" /> <!-- required for custom formatter -->

<pathelement location="lib/buildlib/netbeans-memory-leak-utils.jar" />

<pathelement location="${clover-jar}" />

<pathelement location="classes/test" />

<pathelement location="classes/base" />

<pathelement location="classes/lib" />

</classpath>

<assertions>

<enable />

</assertions>

<syspropertyset>

<propertyref prefix="plt." />

<propertyref prefix="drjava." />

<!-- Add any properties that should be passed on -->

</syspropertyset>

<jvmarg line="${jvm-args} ${concjunit-bootclasspath}" />

<formatter classname="${test-formatter-class}" usefile="${test-output-to-file}" />

<batchtest>

<fileset dir="classes/test">

<filename name="**/*${test-filter-string}*/**" />

<filename name="**/*Test.class" />

</fileset>

</batchtest>

</junit>

<fail if="test-failed" message="One or more unit tests failed."/>

</target>

<target name="run" depends="compile" description="Run the main class (after compiling)">

<antcall target="do-run">

<param name="run-jvm" value="java" />

</antcall>

</target>

<target name="run-8" depends="compile, resolve-java8-exec"

description="Run the main class under Java 8 (after compiling)">

<antcall target="do-run">

<param name="run-jvm" value="${java8-exec}" />

</antcall>

</target>

<target name="run-7" depends="compile, resolve-java7-exec"

description="Run the main class under Java 7 (after compiling)">

<antcall target="do-run">

<param name="run-jvm" value="${java7-exec}" />

</antcall>

</target>

<target name="run-6" depends="compile, resolve-java6-exec"

description="Run the main class under Java 6 (after compiling)">

<antcall target="do-run">

<param name="run-jvm" value="${java6-exec}" />

</antcall>

</target>

<target name="run-5" depends="compile, resolve-java5-exec"

description="Run the main class under Java 5 (after compiling)">

<antcall target="do-run">

<param name="run-jvm" value="${java5-exec}" />

</antcall>

</target>

<target name="do-run" depends="resolve-jvm-args">

<echo message="Running ${main-class} with command '${run-jvm}'" />

<java classname="${main-class}" jvm="${run-jvm}" fork="yes" spawn="yes">

<classpath>

<pathelement location="classes/base" />

<pathelement location="classes/lib" />

</classpath>

<assertions>

<enable />

</assertions>

<syspropertyset>

<propertyref prefix="plt." />

<propertyref prefix="drjava." />

<!-- Add any properties that should be passed on -->

</syspropertyset>

<jvmarg line="${jvm-args}" />

</java>

</target>

<target name="run-jar" depends="jar" description="Run the jar file (after building it)">

<antcall target="do-run-jar">

<param name="run-jvm" value="java" />

</antcall>

</target>

<target name="run-jar-8" depends="jar, resolve-java8-exec"

description="Run the jar file under Java 7 (after building it)">

<antcall target="do-run-jar">

<param name="run-jvm" value="${java8-exec}" />

</antcall>

</target>

<target name="run-jar-7" depends="jar, resolve-java7-exec"

description="Run the jar file under Java 7 (after building it)">

<antcall target="do-run-jar">

<param name="run-jvm" value="${java7-exec}" />

</antcall>

</target>

<target name="run-jar-6" depends="jar, resolve-java6-exec"

description="Run the jar file under Java 6 (after building it)">

<antcall target="do-run-jar">

<param name="run-jvm" value="${java6-exec}" />

</antcall>

</target>

<target name="run-jar-5" depends="jar, resolve-java5-exec"

description="Run the jar file under Java 5 (after building it)">

<antcall target="do-run-jar">

<param name="run-jvm" value="${java5-exec}" />

</antcall>

</target>

<target name="do-run-jar" depends="resolve-jvm-args">

<echo message="Running ${ant.project.name}.jar with command '${run-jvm}'" />

<java jar="${ant.project.name}.jar" jvm="${run-jvm}" fork="yes" spawn="yes">

<assertions>

<enable />

</assertions>

<syspropertyset>

<propertyref prefix="plt." />

<propertyref prefix="drjava." />

<!-- Add any properties that should be passed on -->

</syspropertyset>

<jvmarg line="${jvm-args}" />

</java>

</target>

<!-- ***********

Jar Targets

*********** -->

<target name="jar" depends="compile, resolve-version-tag"

description="Create the jar file with all classes and libs (compiling first)">

<available property="junit-jar-to-include-exists" file="${junit-jar-to-include}" />

<fail message="Can't find ${junit-jar-to-include}"

unless="junit-jar-to-include-exists" />

<jar jarfile="${ant.project.name}.jar">

<manifest>

<attribute name="Main-Class" value="${main-class}" />

<attribute name="Built-By" value="${user.name}" />

<attribute name="Build-Version" value="${version-tag}" />

<!-- put the right version stamp into the jar file -->

<attribute name="Created-By" value="${java.version}"/>

</manifest>

<fileset dir="classes/lib" excludes="about.html"/>

<fileset dir="classes/base" />

<!-- Include the specified version of JUnit and rename it to junit.jar -->

<zipfileset dir="." includes="${junit-jar-to-include}" fullpath="junit.jar" />

<zipfileset dir="." includes="${md5-temp-name}"

fullpath="${md5-properties-path}" />

</jar>

</target>

<target name="jar-base" depends="compile, resolve-version-tag"

description="Create the jar file without any support libs (compiling first)">

<jar jarfile="${ant.project.name}-base.jar">

<manifest>

<attribute name="Main-Class" value="${main-class}" />

<attribute name="Built-By" value="${user.name}" />

<attribute name="Build-Version" value="${version-tag}" />

<!-- put the right version stamp into the jar file -->

<attribute name="Created-By" value="${java.version}"/>

</manifest>

<fileset dir="classes/base" />

</jar>

</target>

<!-- *********************

Documentation Targets

********************* -->

<target name="javadoc" depends="generate-source, resolve-java6-tools, resolve-version-tag"

description="Generate javadocs from the source folder (after generating the source)"

unless="skip-javadoc">

<antcall target="do-javadoc">

<param name="generate-sourcedir" value="src" />

<param name="generate-dir" value="docs/javadoc" />

</antcall>

</target>

<target name="do-javadoc" depends="check-generate-dir-from-dir" unless="already-generated">

<echo message="Generating javadocs" />

<delete dir="docs/javadoc" />

<mkdir dir="docs/javadoc" />

<javadoc sourcepath="src" packagenames="*" destdir="docs/javadoc" maxmemory="512M"

access="private" Use="yes" Version="yes" Author="yes" Windowtitle="${readable-project-name} API (${version-tag})" linksource="${link-source}">

<classpath>

<pathelement location="${java6-tools}" />

<fileset refid="libs" />

<pathelement location="lib/buildlib/junit.jar" />

<pathelement location="lib/buildlib/netbeans-memory-leak-utils.jar" />

</classpath>

<link href="http://docs.oracle.com/javase/6/docs/api/"/>

<link href="http://junit.org/junit/javadoc/3.8.1" />

<link href="http://drjava.org/javadoc/plt" />

<link href="http://drjava.org/javadoc/javalanglevels" />

<link href="http://drjava.org/javadoc/dynamicjava" />

<!-- Additional external library APIs may be listed here -->

</javadoc>

</target>

<target name="clover" depends="clean, setup-clover, test, report-clover"

description="Generate a Clover test coverage report" />

<target name="clover-7" depends="clean, setup-clover, test-7, report-clover"

description="Generate a Clover test coverage report under Java 7" />

<target name="clover-6" depends="clean, setup-clover, test-6, report-clover"

description="Generate a Clover test coverage report under Java 6" />

<target name="clover-5" depends="clean, setup-clover, test-5, report-clover"

description="Generate a Clover test coverage report under Java 5" />

<target name="report-clover" depends="resolve-version-tag">

<echo message="Generating Clover report" />

<clover-report>

<current outfile="docs/clover" title="${readable-project-name} Test Coverage (${version-tag})">

<format type="html" />

</current>

</clover-report>

<antcall target="clean-intermediate"> <!-- Remove instrumented class files -->

<param name="clean-can-fail" value="no" />

</antcall>

</target>

<target name="setup-clover" depends="assert-clover-jar-exists">

<extendclasspath path="${clover-jar}" />

<taskdef resource="clovertasks" classpath="${clover-jar}" />

<mkdir dir="cloverdb" />

<clover-setup initString="cloverdb/clover.db">

<files>

<exclude name="**/*Test.java" />

<exclude name="**/*TestCase.java" />

<!-- Additional test sources should be listed here -->

</files>

</clover-setup>

</target>

<target name="findbugs" depends="assert-findbugs-exists, compile, resolve-java6-tools"

description="Generate a findbugs report (after compiling)">

<taskdef name="findbugs" classpath="lib/buildlib/findbugs-ant.jar"

classname="edu.umd.cs.findbugs.anttask.FindBugsTask" />

<delete file="docs/findbugs.html" />

<mkdir dir="docs" />

<math result="findbugs-timeout-ms" datatype="int"

operand1="${findbugs-timeout}" operation="*" operand2="60000" />

<!-- Add any bug codes to ignore here -->

<property name="findbugs-excludes" value="Nm,Se,Bx,UPM,UrF,UuF,DLS" />

<property name="findbugs-excludes-match"

value="&lt;Match&gt;&lt;Bug code='${findbugs-excludes}'/&gt;&lt;/Match&gt;" />

<echo file="findbugs-excludes.xml"

message="&lt;FindBugsFilter&gt;${findbugs-excludes-match}&lt;/FindBugsFilter&gt;" />

<findbugs home="${findbugs-home}" output="${findbugs-formatter}" jvmargs="-Xmx512M" failOnError="true"

outputFile="docs/findbugs.${findbugs-formatter}" timeout="${findbugs-timeout-ms}"

excludeFilter="findbugs-excludes.xml">

<sourcepath path="src" />

<class location="classes/base" />

<class location="classes/test" />

<auxclasspath>

<pathelement location="${java6-tools}" />

<pathelement location="classes/lib" />

<pathelement location="lib/buildlib/junit.jar" />

<pathelement location="lib/buildlib/netbeans-memory-leak-utils.jar" />

</auxclasspath>

</findbugs>

<delete file="findbugs-excludes.xml" />

</target>

<target name="benchmark" depends="benchmark-current, benchmark-previous, benchmark-report"

description="Generate a test performance report">

</target>

<target name="benchmark-current" depends="resolve-is-modified" if="is-modified">

<echo message="*****************************************" />

<echo message="Running benchmark tests on the local copy" />

<echo message="*****************************************" />

<mkdir dir="benchmarkResults/local" />

<trycatch>

<try>

<antcall target="compile" />

<antcall target="iterate-tests">

<param name="test-jvm" value="java" />

<param name="test-formatter" value="xml" />

</antcall>

</try>

<catch /> <!-- Continue despite any test failures -->

</trycatch>

<move todir="benchmarkResults/local" file="testResults" failonerror="no" />

</target>

<target name="benchmark-previous">

<mkdir dir="benchmarkSources" />

<echo message="Checking out the Subversion head revision" />

<exec executable="svn" failonerror="yes">

<arg value="checkout" />

<arg value="--quiet" />

<arg value="--revision" />

<arg value="HEAD" />

<arg value="${svn-repository}/trunk/${ant.project.name}" />

<arg value="benchmarkSources" />

</exec>

<antcall target="benchmark-single-previous">

<param name="svn-working-dir" location="benchmarkSources" />

</antcall>

<math result="remaining-benchmark-count" datatype="int"

operand1="${benchmark-count}" operation="-" operand2="1" />

<fornum count="${remaining-benchmark-count}" param="iteration">

<sequential>

<antcall target="benchmark-revert" />

<antcall target="benchmark-single-previous">

<param name="svn-working-dir" location="benchmarkSources" />

</antcall>

</sequential>

</fornum>

<delete dir="benchmarkSources" />

</target>

<target name="benchmark-single-previous" depends="resolve-svn-revision">

<echo message="*****************************************" />

<echo message="Running benchmark tests on revision ${svn-revision}" />

<echo message="*****************************************" />

<!-- Change the build script text for builds that don't support test-output-to-file -->

<replaceregexp file="benchmarkSources/build.xml" flags="g"

match="&lt;formatter[^&gt;]*/&gt;"

replace="&lt;formatter type=&quot;xml&quot; usefile=&quot;true&quot;/&gt;" />

<!-- Eliminate taskdefs, which are apparently inherited (Ant complains otherwise) -->

<replaceregexp file="benchmarkSources/build.xml" flags="gs"

match="&lt;taskdef[^&gt;]*/&gt;" replace="" />

<mkdir dir="benchmarkResults/${svn-revision}" />

<trycatch property="benchmark-error">

<try>

<!-- Must iterate tests *here* to support scripts that don't do test-repeat -->

<antcall target="iterate-tests">

<param name="do-test-target" value="do-test-previous" />

<param name="test-formatter" value="xml" />

<!-- test-output-to-file is not inferred in some build scripts -->

<param name="test-output-to-file" value="yes" />

</antcall>

</try>

<catch>

<echo message="Error occured during benchmark testing:${line.separator}${benchmark-error}" />

</catch>

</trycatch>

<!-- Restore sources to their original state -->

<trycatch>

<try>

<ant dir="benchmarkSources" target="clean" />

</try>

<catch />

</trycatch>

<exec executable="svn" dir="benchmarkSources" failonerror="yes">

<arg value="revert" />

<arg value="--quiet" />

<arg value="build.xml" />

</exec>

<move todir="benchmarkResults/${svn-revision}" file="testResults" failonerror="no" />

</target>

<target name="do-test-previous">

<trycatch>

<try>

<ant dir="benchmarkSources">

<!-- compile in case it doesn't happen automatically -->

<target name="compile" />

<target name="test" />

<!-- Iteration is managed here, so don't do it there -->

<property name="test-spec" value="${test-filter-string}" />

<property name="test-repeat" value="1" />

</ant>

</try>

<finally>

<move todir="${basedir}">

<fileset dir="benchmarkSources">

<include name="TEST*" />

<include name="testResults/**/TEST*" />

</fileset>

</move>

</finally>

</trycatch>

</target>

<target name="benchmark-revert">

<echo message="Updating benchmarkSources to a previous revision" />

<fornum count="${benchmark-skip}" param="iteration">

<sequential>

<exec executable="svn" dir="benchmarkSources" failonerror="yes">

<arg value="update" />

<arg value="--revision" />

<arg value="PREV" />

</exec>

</sequential>

</fornum>

</target>

<target name="benchmark-report">

<mkdir dir="docs/benchmark" />

<!-- TODO - implement this. Report should be generated in docs/benchmark. -->

<echo message="Report generation not yet implemented" />

<!-- <delete dir="benchmarkResults" /> -->

</target>

<!-- *************

Clean Targets

************* -->

<target name="clean" depends="clean-intermediate, clean-products, clean-concjunit"

description="Remove all build products; the result should match the intended Subversion contents">

</target>

<target name="clean-intermediate" unless="skip-clean">

<echo message="Deleting all intermediate build products" />

<delete dir="classes" failonerror="${clean-can-fail}" />

<delete dir="cloverdb" failonerror="${clean-can-fail}" />

<delete dir="benchmarkSources" failonerror="${clean-can-fail}" />

<delete dir="benchmarkResults" failonerror="${clean-can-fail}" />

<delete includeemptydirs="true" failonerror="${clean-can-fail}">

<fileset dir="testFiles">

<exclude name="**" />

<!-- Additional test output files should be listed here -->

</fileset>

<fileset dir="${basedir}">

<patternset refid="generated-sources" />

</fileset>

<fileset dir="${basedir}" defaultexcludes="no">

<include name="TEST*" />