/[cvs]/jsr166/build.xml
ViewVC logotype

Diff of /jsr166/build.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.28 by tim, Wed May 28 13:37:59 2003 UTC revision 1.42 by tim, Mon Jun 9 14:11:43 2003 UTC
# Line 1  Line 1 
1  <project name="jsr166" default="usage">  <project name="jsr166" default="usage">
2    
3    <description>    <description>
4      Build file for JSR-166  ------------------------------------------------------------------------------
5      Build file for JSR-166
6    
7      JUnit 3.8 or better must be in ${ant.home}/lib for the test target to work.    Usage: ant [target]
   </description>  
8    
9      User-specific settings are read from user.properties.
10      See user.properties.sample for an explanation of some useful settings.
11    ------------------------------------------------------------------------------
12      </description>
13    
14    <target name="usage" description="Prints this message">    <target name="usage" description="Advises user to run with -projecthelp">
15      <echo>      <echo>Run "ant -projecthelp" for full usage information.</echo>
 ant [target], where target is one of:  
   
  usage       (default) Prints this message  
  compile     Compiles all sources to build folder  
  jar         Builds library jar from compiled sources  
  test        Runs all tests (requires JUnit 1.8 in ${ant.home}/lib)  
  docs        Builds javadocs with custom tags to build folder  
  dist-docs   Builds javadocs without custom tags to dist folder  
  dist        Puts all distributable products in single hierarchy  
   
  clean       Removes all build products  
  dist-clean  Removes all build and distribution products  
   
  checkstyle  Reports on style errors in Java source (verbose, mostly chaff)  
  doccheck    Reports on javadoc style errors (not working yet)  
     </echo>  
16    </target>    </target>
17    
18    
19    <!-- User-specific settings -->    <!-- User-specific settings -->
20    <property file="user.properties"/>    <property file="user.properties"/>
21    
   <!-- Set build.warnings in user.properties to turn on -warnunchecked -->  
   <!-- <property name="build.warnings" value=""/> -->  
   
22    
23    <!-- Compilation options -->    <!-- Compilation options -->
24    <property name="build.sourcelevel"    value="1.5"/>    <property name="build.sourcelevel"    value="1.5"/>
# Line 68  ant [target], where target is one of: Line 54  ant [target], where target is one of:
54    
55    <!-- Jar locations -->    <!-- Jar locations -->
56    <property name="product.jar"          location="${build.lib.dir}/jsr166.jar"/>    <property name="product.jar"          location="${build.lib.dir}/jsr166.jar"/>
   <property name="javac.jar"            location="${lib.dir}/javac.jar"/>  
   <property name="collect.jar"          location="${lib.dir}/collect.jar"/>  
57    <property name="junit.jar"            location="${lib.dir}/junit.jar"/>    <property name="junit.jar"            location="${lib.dir}/junit.jar"/>
58    <property name="rt.jar"               location="${java.home}/lib/rt.jar"/>    <property name="rt.jar"               location="${java.home}/lib/rt.jar"/>
59    
60    
61    
62    <!--    <!-- Files excluded from dist-docs and emulation jar -->
63     ! Bootclasspath munging for source compilation.    <patternset id="unsafe.exclusion">
    -->  
   
   <path id="javac.bootclasspath.prefix">  
     <!-- <pathelement location="${src.dir}"/> -->  
     <pathelement location="${javac.jar}"/>  
   </path>  
   
   <path id="javac.bootclasspath">  
     <!-- <pathelement location="${src.dir}"/> -->  
     <pathelement location="${collect.jar}"/>  
     <pathelement location="${rt.jar}"/>  
   </path>  
   
   <!-- Flatten bootclasspath prefix into a platform-appropriate string -->  
   <property name="javac.bootclasspath.prefix" refid="javac.bootclasspath.prefix"/>  
   
   <!-- Turn the flattened bootclasspath prefix into a javac argument -->  
   <property name="javac.args" value='-J-Xbootclasspath/p:${javac.bootclasspath.prefix}'/>  
   
   
   
   <!--  
    ! Bootclasspath munging for testing, so JUnit can test our local  
    ! modifications to java.*.  
    -->  
   
   <path id="test.classpath">  
     <pathelement location="${product.jar}"/>  
     <pathelement location="${build.testcases.dir}"/>  
     <pathelement location="${junit.jar}"/>  
   </path>  
   
   <!-- Flatten test classpath into a platform-appropriate string -->  
   <property name="test.classpath" refid="test.classpath"/>  
   
   <!-- Turn the flattened test classpath into a javac argument -->  
   <property name="test.javac.args" value='-Xbootclasspath/p:${test.classpath}'/>  
   
   
   
   <!-- Files excluded from emulation and dist-docs -->  
   <patternset id="emulation.excludes">  
64      <exclude name="java/util/Random.*"/>      <exclude name="java/util/Random.*"/>
65      <exclude name="sun/misc/Unsafe.*"/>      <exclude name="sun/misc/Unsafe.*"/>
66    </patternset>    </patternset>
67    
68      <!-- Files excludes from emulation jar -->
69      <patternset id="atomic.exclusion">
70        <exclude name="java/util/concurrent/atomic/AtomicBoolean*"/>
71        <exclude name="java/util/concurrent/atomic/AtomicInteger*"/>
72        <exclude name="java/util/concurrent/atomic/AtomicLong*"/>
73        <exclude name="java/util/concurrent/atomic/AtomicReference*"/>
74      </patternset>
75    
76    
77    
78    <!-- Main targets -->    <!-- Main targets -->
79    
80    <target name="compile"    <target name="compile"
81            depends="init"            depends="init, configure-compiler, prepare-src"
82            description="Compiles main sources to build folder">            description="Compiles main sources to build folder">
83    
84        <property name="prepare.src.dir" value="${src.dir}"/>
85    
86      <mkdir dir="${build.classes.dir}"/>      <mkdir dir="${build.classes.dir}"/>
87    
88      <javac srcdir="${src.dir}"  <!--
89        <echo>javac ${gjc.args}</echo>
90        <echo>bootclasspath=${compile.bootclasspath}</echo>
91    -->
92    
93        <javac srcdir="${prepare.src.dir}"
94            destdir="${build.classes.dir}"            destdir="${build.classes.dir}"
95              debug="${build.debug}"              debug="${build.debug}"
96         debuglevel="${build.debuglevel}"         debuglevel="${build.debuglevel}"
# Line 141  ant [target], where target is one of: Line 98  ant [target], where target is one of:
98             source="${build.sourcelevel}"             source="${build.sourcelevel}"
99               fork="true">               fork="true">
100    
101        <bootclasspath refid="javac.bootclasspath"/>        <compilerarg    line="${gjc.args}"/>
102        <compilerarg line="${javac.args} ${build.warnings.option}"/>        <bootclasspath refid="compile.bootclasspath"/>
103    
104      </javac>      </javac>
105    
# Line 150  ant [target], where target is one of: Line 107  ant [target], where target is one of:
107    
108    
109    <target name="jar"    <target name="jar"
110            depends="native-jar, emulation-jar"            depends="configure-emulation, init-jar, native-jar, emulation-jar"
111            description="Builds library jar from compiled sources"/>            description="Builds library jar from compiled sources"/>
112    
113    
114    <target name="test"    <target name="test"
115            depends="init, check-junit, report-tests"            depends="init, configure-tests, report-tests"
116            description="Runs all tests (requires JUnit 3.8+ in ${ant.home}/lib)" />            description="Runs all tests (requires JUnit 3.8.1 in ${ant.home}/lib)" />
117    
118    
119    <target name="checkstyle"    <target name="checkstyle"
# Line 203  ant [target], where target is one of: Line 160  ant [target], where target is one of:
160                source="${build.docsourcelevel}">                source="${build.docsourcelevel}">
161    
162        <tag name="revised" description="Last revised:"/>        <tag name="revised" description="Last revised:"/>
163        <tag name="spec" description="Specified by:"/>        <tag name="spec"    description="Specified by:"/>
164        <tag name="editor" description="Last edited by:"/>        <tag name="editor"  description="Last edited by:"/>
165        <tag name="fixme" description="FIX ME:"/>        <tag name="fixme"   description="FIX ME:"/>
166    
167        <packageset dir="${build.filter.src.dir}"/>        <packageset dir="${build.filter.src.dir}"/>
168    
169      </javadoc>      </javadoc>
# Line 213  ant [target], where target is one of: Line 171  ant [target], where target is one of:
171    </target>    </target>
172    
173    
   <!--  
    # javac -s doesn't reliably generate compilable code. It generates  
    # bridge methods (marked as "synthetic") that can have identical  
    # signatures to existing methods except for the return value.  
    -->  
174    <target name="strip"    <target name="strip"
175            depends="init">            depends="init, configure-compiler"
176              description="Strip generics from java source (not working yet)">
177    
178      <mkdir dir="${build.stripped.dir}"/>      <mkdir dir="${build.stripped.dir}"/>
179    
180        <!--
181         # javac -s doesn't reliably generate compilable code. It generates
182         # bridge methods (marked as "synthetic") that can have identical
183         # signatures to existing methods except for the return value.
184         -->
185      <javac srcdir="${src.dir}"      <javac srcdir="${src.dir}"
186            destdir="${build.stripped.dir}"            destdir="${build.stripped.dir}"
187              debug="${build.debug}"              debug="${build.debug}"
# Line 231  ant [target], where target is one of: Line 190  ant [target], where target is one of:
190             source="${build.sourcelevel}"             source="${build.sourcelevel}"
191               fork="true">               fork="true">
192    
193        <bootclasspath refid="javac.bootclasspath"/>        <compilerarg    line="${gjc.args} -s"/>
194        <compilerarg line="${javac.args} ${build.warnings.option} -s"/>        <bootclasspath refid="compile.bootclasspath"/>
195    
196      </javac>      </javac>
197    
# Line 243  ant [target], where target is one of: Line 202  ant [target], where target is one of:
202            depends="init, dist-clean, dist-jar, dist-docs"            depends="init, dist-clean, dist-jar, dist-docs"
203            description="Puts all distributable products in single hierarchy"/>            description="Puts all distributable products in single hierarchy"/>
204    
205      <target name="release"
206              depends="dist"
207              description="Puts entire CVS tree, plus distribution productions, in a jar">
208    
209        <delete dir="${build.dir}"/>
210    
211        <property name="release.jar" value="dist/jsr166-${version}-dist.jar"/>
212    
213        <jar basedir="${basedir}" destfile="${release.jar}">
214          <exclude name="${release.jar}"/>
215          <exclude name="user.properties"/>
216          <exclude name="etc/notes/**"/>
217        </jar>
218    
219      </target>
220    
221    <target name="clean"    <target name="clean"
222            description="Removes all build products">            description="Removes all build products">
# Line 284  ant [target], where target is one of: Line 258  ant [target], where target is one of:
258    
259    <!-- Internal targets -->    <!-- Internal targets -->
260    
   <target name="set-warnings-if" if="build.warnings">  
   
     <property name="build.warnings.option" value="-warnunchecked"/>  
   
   </target>  
   
   
   <target name="set-warnings-unless" unless="build.warnings">  
261    
262      <property name="build.warnings.option" value=""/>    <target name="init">
   
   </target>  
   
   
   <target name="init"  
           depends="set-warnings-if, set-warnings-unless">  
263    
264      <!-- Version is kept in a separate file -->      <!-- Version is kept in a separate file -->
265      <loadfile property="version" srcFile="version.properties"/>      <loadfile property="version" srcFile="version.properties"/>
# Line 316  ant [target], where target is one of: Line 276  ant [target], where target is one of:
276    
277    
278    <target name="native-jar"    <target name="native-jar"
279            depends="compile, init-jar"            depends="compile"
280            unless="build.emulation">            unless="build.emulation.true">
281    
282      <jar destfile="${product.jar}">      <jar destfile="${product.jar}">
283        <fileset dir="${build.classes.dir}"/>        <fileset dir="${build.classes.dir}"/>
# Line 326  ant [target], where target is one of: Line 286  ant [target], where target is one of:
286    </target>    </target>
287    
288    
   <target name="base-jar"  
           depends="compile, init-jar">  
   
     <jar destfile="${product.jar}">  
       <fileset dir="${build.classes.dir}">  
         <patternset refid="emulation.excludes"/>  
       </fileset>  
     </jar>  
   
   </target>  
   
   
289    <target name="compile-emulation"    <target name="compile-emulation"
290            depends="init"            depends="init, configure-compiler"
291            if="build.emulation">            if="build.emulation.true">
292    
293      <mkdir dir="${build.emulation.dir}"/>      <mkdir dir="${build.emulation.dir}"/>
294    
# Line 352  ant [target], where target is one of: Line 300  ant [target], where target is one of:
300             source="${build.sourcelevel}"             source="${build.sourcelevel}"
301               fork="true">               fork="true">
302    
303        <bootclasspath refid="javac.bootclasspath"/>        <compilerarg    line="${gjc.args}"/>
304        <compilerarg line="${javac.args} ${build.warnings.option}"/>        <bootclasspath refid="compile.bootclasspath"/>
305    
306      </javac>      </javac>
307    
# Line 361  ant [target], where target is one of: Line 309  ant [target], where target is one of:
309    
310    
311    <target name="emulation-jar"    <target name="emulation-jar"
312            depends="base-jar, compile-emulation"            depends="compile-emulation"
313            if="build.emulation">            if="build.emulation.true">
314    
315    
316      <jar destfile="${product.jar}" update="true" duplicate="add">      <jar destfile="${product.jar}" duplicate="add">
317          <fileset dir="${build.classes.dir}">
318            <patternset refid="atomic.exclusion"/>
319            <patternset refid="unsafe.exclusion"/>
320          </fileset>
321        <fileset dir="${build.emulation.dir}"/>        <fileset dir="${build.emulation.dir}"/>
322      </jar>      </jar>
323    
# Line 399  ant [target], where target is one of: Line 352  ant [target], where target is one of:
352    
353      <copy todir="${build.filter.src.dir}">      <copy todir="${build.filter.src.dir}">
354        <fileset dir="${src.dir}">        <fileset dir="${src.dir}">
355          <patternset refid="emulation.excludes"/>          <include name="**/*.html"/>
356          </fileset>
357        </copy>
358    
359        <!-- Not needed now, used for doccheck filtering:
360        <property name="generic.declarations"
361                 value="public interface E {} public interface T {} public interface K {} public interface V {}"
362        />
363        -->
364    
365        <copy todir="${build.filter.src.dir}">
366          <fileset dir="${src.dir}">
367            <exclude name="**/*.html"/>
368            <patternset refid="unsafe.exclusion"/>
369        </fileset>        </fileset>
370        <filterchain>        <filterchain>
371    
372            <!--
373             # This filter gets rid of angle-bracketed type parameters
374             # so that javadoc can run on the result. The following
375             # heuristic seems to work:
376             #
377             # For all lines not starting with space(s)-asterisk-space(s),
378             #   replace <something> with a space, where there may be more
379             #   than one right angle bracket at the end, and "something"
380             #   must not contain parens or pipes. (This may need some
381             #   tweaking.)
382             -->
383    
384          <filterreader classname="jsr166.ant.filters.ReplaceFilter"          <filterreader classname="jsr166.ant.filters.ReplaceFilter"
385                        classpath="${build.ant.dir}">                        classpath="${build.ant.dir}">
           <!--  
            # These arguments are to get rid of angle-bracketed type  
            # parameters so that javadoc can run on the result. The  
            # following heuristic that seems to work:  
            #  
            # For all lines not starting with space(s)-asterisk-space(s),  
            #   replace <something> with a space, where there may be more  
            #   than one right angle bracket at the end, and "something"  
            #   must not contain parens or pipes. (This may need some  
            #   tweaking.)  
            -->  
386            <param name="notmatching" value="^\s+\*\s.*$"/>            <param name="notmatching" value="^\s+\*\s.*$"/>
387            <param name="pattern" value="&lt;[^|>()]+?>+"/>            <param name="pattern"     value="&lt;[^|>()]+?>+"/>
388            <param name="replacement" value=" "/>            <param name="replacement" value=" "/>
389          </filterreader>          </filterreader>
390    
391    
392            <!--
393             # This filter uncomments lines beginning with "//@" so that
394             # javadoc can see imports that are needed to resolve links
395             # but that shouldn't be in the compiled code.
396             -->
397    
398          <filterreader classname="jsr166.ant.filters.ReplaceFilter"          <filterreader classname="jsr166.ant.filters.ReplaceFilter"
399                        classpath="${build.ant.dir}">                        classpath="${build.ant.dir}">
400            <!--            <param name="matching"    value="^//@.*$"/>
401             # These arguments are to uncomment lines beginning with            <param name="pattern"     value="^//@"/>
            # "//@" so that javadoc can see imports that are needed  
            # to resolve links but that shouldn't be in the compiled  
            # code.  
            -->  
           <param name="matching" value="^//@.*$"/>  
           <param name="pattern" value="^//@"/>  
402            <param name="replacement" value=""/>            <param name="replacement" value=""/>
403          </filterreader>          </filterreader>
404    
405    
406            <!--
407             # The next two filters try to make the source look like
408             # something that doccheck can process. The first removes
409             # -source 1.4 assertions and the second adds in a bunch
410             # of single letter public nested marker interfaces so that
411             # the generic type parameters are recognized.
412             #
413             # Currently commented out because doccheck doesn't work. :-(
414             -->
415    
416            <!--
417            <filterreader classname="jsr166.ant.filters.ReplaceFilter"
418                          classpath="${build.ant.dir}">
419              <param name="matching"    value="^\s*assert[\s ].*$"/>
420              <param name="pattern"     value="assert"/>
421              <param name="replacement" value="//assert"/>
422            </filterreader>
423    
424            <filterreader classname="jsr166.ant.filters.ReplaceFilter"
425                          classpath="${build.ant.dir}">
426              <param name="matching"    value="^(.*(class|interface|implements) .*|)\{.*$"/>
427              <param name="pattern"     value="$"/>
428              <param name="replacement" value=" ${generic.declarations}"/>
429            </filterreader>
430            -->
431    
432        </filterchain>        </filterchain>
433      </copy>      </copy>
434    
# Line 442  ant [target], where target is one of: Line 440  ant [target], where target is one of:
440    
441      <mkdir dir="${build.testcases.dir}"/>      <mkdir dir="${build.testcases.dir}"/>
442    
443    <!--
444        <echo>javac ${gjc.args}</echo>
445        <echo>bootclasspath=${test.compile.bootclasspath}</echo>
446        <echo>classpath="${test.classpath}"</echo>
447    -->
448    
449      <javac srcdir="${test.src.dir}"      <javac srcdir="${test.src.dir}"
450            destdir="${build.testcases.dir}"            destdir="${build.testcases.dir}"
451              debug="${build.debug}"              debug="${build.debug}"
# Line 450  ant [target], where target is one of: Line 454  ant [target], where target is one of:
454             source="${build.sourcelevel}"             source="${build.sourcelevel}"
455               fork="true">               fork="true">
456    
457        <bootclasspath refid="javac.bootclasspath"/>        <compilerarg    line="${gjc.args}"/>
458        <compilerarg line="${javac.args} ${build.warnings.option}"/>        <bootclasspath refid="test.compile.bootclasspath"/>
459        <classpath refid="test.classpath"/>        <classpath     refid="test.classpath"/>
460    
461      </javac>      </javac>
462    
# Line 474  ant [target], where target is one of: Line 478  ant [target], where target is one of:
478                      dir="${build.reports.dir}"                      dir="${build.reports.dir}"
479                     fork="true">                     fork="true">
480    
481        <jvmarg value="${test.javac.args}"/>        <jvmarg value="-Xbootclasspath/p:${test.run.bootclasspath}"/>
482    
483        <formatter type="xml"/>        <formatter type="xml"/>
484    
# Line 515  ant [target], where target is one of: Line 519  ant [target], where target is one of:
519    </target>    </target>
520    
521    
522    <target name="check-junit">    <target name="configure-compiler">
523    
524        <property name="gjc.version"
525                 value="2.0"/>
526    
527        <condition property="novariance.arg" value="-novariance">
528          <and>
529            <equals arg1="${gjc.version}" arg2="2.0"/>
530            <or>
531              <not><isset property="gjc.novariance"/></not>
532              <istrue value="${gjc.novariance}"/>
533            </or>
534          </and>
535        </condition>
536    
537        <property name="novariance.arg"
538                 value=""/>
539    
540        <property name="gjc.dir"
541                 value="${lib.dir}/gjc"/>
542    
543        <property name="javac.jar"
544              location="${gjc.dir}/${gjc.version}/javac.jar"/>
545    
546        <property name="collect.jar"
547              location="${gjc.dir}/${gjc.version}/collect${novariance.arg}.jar"/>
548    
549    
550        <condition property="warnunchecked.arg" value="-warnunchecked">
551          <istrue value="${gjc.warnunchecked}"/>
552        </condition>
553    
554        <property name="warnunchecked.arg" value=""/>
555    
556        <condition property="prepare.src.dir" value="${build.dir}/prepare-src">
557          <istrue value="${build.nothreads}"/>
558        </condition>
559    
560    
561        <!--
562         ! Bootclasspath munging for source compilation.
563         -->
564    
565        <path id="pre.bootclasspath">
566          <pathelement location="${javac.jar}"/>
567        </path>
568    
569        <path id="compile.bootclasspath">
570          <pathelement location="${build.classes.dir}"/>
571          <pathelement location="${collect.jar}"/>
572          <pathelement location="${rt.jar}"/>
573        </path>
574    
575        <!-- Flatten paths into platform-appropriate strings -->
576        <property name="pre.bootclasspath"     refid="pre.bootclasspath"/>
577        <property name="compile.bootclasspath" refid="compile.bootclasspath"/>
578    
579    
580        <!-- Common options in javac invocations -->
581        <property name="gjc.args"
582                 value="-J-Xbootclasspath/p:${pre.bootclasspath} ${warnunchecked.arg} ${novariance.arg}"
583        />
584    
585      </target>
586    
587    
588      <target name="prepare-src"
589              depends="configure-compiler"
590              if="prepare.src.dir">
591    
592        <mkdir dir="${prepare.src.dir}"/>
593        <copy todir="${prepare.src.dir}">
594          <fileset dir="${src.dir}">
595            <exclude name="java/lang/**"/>
596          </fileset>
597        </copy>
598    
599      </target>
600    
601    
602      <target name="configure-emulation">
603    
604        <condition property="build.emulation.true">
605          <or>
606            <and>
607              <os family="windows"/>
608              <not>
609                <isset property="build.emulation"/>
610              </not>
611            </and>
612            <istrue value="${build.emulation}"/>
613          </or>
614        </condition>
615    
616      </target>
617    
618    
619      <target name="configure-tests"
620           depends="configure-compiler">
621    
622      <!-- junit.framework.Protectable is in JUnit 3.8.1 but not in 3.7 -->      <!-- junit.framework.Protectable is in JUnit 3.8.1 but not in 3.7 -->
623      <available property="junit.available"      <available property="junit.available"
# Line 524  ant [target], where target is one of: Line 626  ant [target], where target is one of:
626      <fail message="Need JUnit 3.8.1 in ${ant.home}${file.separator}lib to run tests"      <fail message="Need JUnit 3.8.1 in ${ant.home}${file.separator}lib to run tests"
627            unless="junit.available"/>            unless="junit.available"/>
628    
629    
630        <!--
631         ! Bootclasspath munging for testing, so JUnit can test our local
632         ! modifications to java.*.
633         -->
634    
635        <path id="test.classpath">
636          <pathelement location="${product.jar}"/>
637          <pathelement location="${build.testcases.dir}"/>
638          <pathelement location="${junit.jar}"/>
639        </path>
640    
641        <path id="test.compile.bootclasspath">
642          <pathelement location="${javac.jar}"/>
643          <pathelement location="${collect.jar}"/>
644          <pathelement location="${rt.jar}"/>
645        </path>
646    
647        <path id="test.run.bootclasspath">
648          <pathelement location="${javac.jar}"/>
649          <path refid="test.classpath"/>
650        </path>
651    
652        <!-- Flatten test classpaths into platform-appropriate strings -->
653        <property name="test.classpath"             refid="test.classpath"/>
654        <property name="test.compile.bootclasspath" refid="test.compile.bootclasspath"/>
655        <property name="test.run.bootclasspath"     refid="test.run.bootclasspath"/>
656    
657    </target>    </target>
658    
659    
Legend:
Removed from v.1.28  
changed lines
  Added in v.1.42
dl@cs.oswego.edu
 ViewVC Help
Powered by ViewVC 1.1.27