ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/jsr166/jsr166/build.xml
(Generate patch)

Comparing jsr166/build.xml (file contents):
Revision 1.30 by tim, Wed May 28 14:19:25 2003 UTC vs.
Revision 1.49 by tim, Sat Aug 2 02:38:24 2003 UTC

# Line 7 | Line 7
7    Usage: ant [target]
8  
9    User-specific settings are read from user.properties.
10 <  See user.properties.sample for examples.
10 >  See user.properties.sample for an explanation of some useful settings.
11   ------------------------------------------------------------------------------
12    </description>
13  
# Line 39 | Line 39
39    <property name="build.reports.dir"    location="${build.dir}/reports"/>
40    <property name="build.doccheck.dir"   location="${build.dir}/doccheck"/>
41    <property name="build.filter.src.dir" location="${build.dir}/filtersrc"/>
42 +  <property name="build.filter.doccheck.dir" location="${build.dir}/filterdocchk"/>
43  
44    <!-- Source locations -->
45    <property name="src.dir"              location="${basedir}/src/main"/>
# Line 54 | Line 55
55  
56    <!-- Jar locations -->
57    <property name="product.jar"          location="${build.lib.dir}/jsr166.jar"/>
57  <property name="javac.jar"            location="${lib.dir}/javac.jar"/>
58  <property name="collect.jar"          location="${lib.dir}/collect.jar"/>
58    <property name="junit.jar"            location="${lib.dir}/junit.jar"/>
59    <property name="rt.jar"               location="${java.home}/lib/rt.jar"/>
60 +  <property name="sinjdoc.jar"          location="${lib.dir}/sinjdoc.jar"/>
61  
62  
63 <
64 <  <!--
65 <   ! Bootclasspath munging for source compilation.
66 <   -->
67 <
68 <  <path id="javac.bootclasspath.prefix">
69 <    <!-- <pathelement location="${src.dir}"/> -->
70 <    <pathelement location="${javac.jar}"/>
71 <  </path>
72 <
73 <  <path id="javac.bootclasspath">
74 <    <!-- <pathelement location="${src.dir}"/> -->
75 <    <pathelement location="${collect.jar}"/>
76 <    <pathelement location="${rt.jar}"/>
77 <  </path>
78 <
79 <  <!-- Flatten bootclasspath prefix into a platform-appropriate string -->
80 <  <property name="javac.bootclasspath.prefix" refid="javac.bootclasspath.prefix"/>
81 <
82 <  <!-- Turn the flattened bootclasspath prefix into a javac argument -->
83 <  <property name="javac.args" value='-J-Xbootclasspath/p:${javac.bootclasspath.prefix}'/>
84 <
85 <
86 <
87 <  <!--
88 <   ! Bootclasspath munging for testing, so JUnit can test our local
89 <   ! modifications to java.*.
90 <   -->
91 <
92 <  <path id="test.classpath">
93 <    <pathelement location="${product.jar}"/>
94 <    <pathelement location="${build.testcases.dir}"/>
95 <    <pathelement location="${junit.jar}"/>
96 <  </path>
97 <
98 <  <!-- Flatten test classpath into a platform-appropriate string -->
99 <  <property name="test.classpath" refid="test.classpath"/>
100 <
101 <  <!-- Turn the flattened test classpath into a javac argument -->
102 <  <property name="test.javac.args" value='-Xbootclasspath/p:${test.classpath}'/>
103 <
104 <
105 <
106 <  <!-- Files excluded from emulation and dist-docs -->
107 <  <patternset id="emulation.excludes">
63 >  <!-- Files excluded from dist-docs and emulation jar -->
64 >  <patternset id="unsafe.exclusion">
65      <exclude name="java/util/Random.*"/>
66      <exclude name="sun/misc/Unsafe.*"/>
67    </patternset>
68  
69 +  <!-- Files excludes from emulation jar -->
70 +  <patternset id="atomic.exclusion">
71 +    <exclude name="java/util/concurrent/atomic/AtomicBoolean*"/>
72 +    <exclude name="java/util/concurrent/atomic/AtomicInteger*"/>
73 +    <exclude name="java/util/concurrent/atomic/AtomicLong*"/>
74 +    <exclude name="java/util/concurrent/atomic/AtomicReference*"/>
75 +  </patternset>
76 +
77  
78  
79    <!-- Main targets -->
80  
81    <target name="compile"
82 <          depends="init"
82 >          depends="init, configure-compiler, prepare-src"
83            description="Compiles main sources to build folder">
84  
85 +    <property name="prepare.src.dir" value="${src.dir}"/>
86 +
87      <mkdir dir="${build.classes.dir}"/>
88  
89 <    <javac srcdir="${src.dir}"
89 > <!--
90 >    <echo>javac ${gjc.args}</echo>
91 >    <echo>bootclasspath=${compile.bootclasspath}</echo>
92 > -->
93 >
94 >    <javac srcdir="${prepare.src.dir}"
95            destdir="${build.classes.dir}"
96              debug="${build.debug}"
97         debuglevel="${build.debuglevel}"
# Line 127 | Line 99
99             source="${build.sourcelevel}"
100               fork="true">
101  
102 <      <bootclasspath refid="javac.bootclasspath"/>
103 <      <compilerarg line="${javac.args} ${build.warnings.option}"/>
102 >      <compilerarg    line="${gjc.args}"/>
103 >      <bootclasspath refid="compile.bootclasspath"/>
104  
105      </javac>
106  
# Line 136 | Line 108
108  
109  
110    <target name="jar"
111 <          depends="check-emulation, init-jar, native-jar, emulation-jar"
111 >          depends="configure-emulation, init-jar, native-jar, emulation-jar"
112            description="Builds library jar from compiled sources"/>
113  
114  
115    <target name="test"
116 <          depends="init, check-junit, report-tests"
116 >          depends="init, configure-tests, report-tests"
117            description="Runs all tests (requires JUnit 3.8.1 in ${ant.home}/lib)" />
118  
119  
# Line 161 | Line 133
133  
134  
135    <target name="doccheck"
136 <          depends="filter-src"
137 <          description="Reports on javadoc style errors (not working yet)">
136 >          depends="filter-doccheck"
137 >          description="Reports on javadoc style errors">
138  
139      <delete dir="${build.doccheck.dir}"/>
140      <mkdir dir="${build.doccheck.dir}"/>
# Line 170 | Line 142
142      <javadoc doclet="com.sun.tools.doclets.doccheck.DocCheck"
143           docletpath="${lib.dir}/doccheck.jar"
144              destdir="${build.doccheck.dir}">
145 <      <packageset dir="${build.filter.src.dir}"/>
145 >      <packageset dir="${build.filter.doccheck.dir}"/>
146      </javadoc>
147  
148 +    <echo>DocCheck output is in ${build.doccheck.dir}</echo>
149 +
150    </target>
151  
152  
# Line 200 | Line 174
174    </target>
175  
176  
177 <  <!--
178 <   # javac -s doesn't reliably generate compilable code. It generates
179 <   # bridge methods (marked as "synthetic") that can have identical
180 <   # signatures to existing methods except for the return value.
181 <   -->
177 >  <target name="sinjdocs"
178 >          depends="configure-tests"
179 >          description="Builds javadocs with custom tags to build folder">
180 >
181 >    <delete dir="${build.javadocs.dir}"/>
182 >    <mkdir dir="${build.javadocs.dir}"/>
183 >
184 >    <java classname="net.cscott.sinjdoc.Main" fork="true">
185 >
186 >      <jvmarg value="-Xbootclasspath/p:${test.run.bootclasspath}"/>
187 >
188 >      <classpath>
189 >        <pathelement location="${sinjdoc.jar}"/>
190 >        <path refid="test.classpath"/>
191 >      </classpath>
192 >
193 >      <!-- <arg value="-link"/>       <arg value="http://java.sun.com/j2se/1.4.1/docs/api"/> -->
194 >
195 >      <arg value="-d"/>          <arg value="${build.javadocs.dir}"/>
196 >      <arg value="-sourcepath"/> <arg value="${src.dir}"/>
197 >      <arg value="-overview"/>   <arg value="${src.dir}/intro.html"/>
198 >      <arg value="-source"/>     <arg value="1.5"/>
199 >      <arg value="-verbose"/>
200 >      <arg value="java.util"/>
201 >
202 >      <!--
203 >      <arg value="-help"/>
204 >      -->
205 >
206 >    </java>
207 >
208 >  </target>
209 >
210 >
211    <target name="strip"
212 <          depends="init">
212 >          depends="init, configure-compiler"
213 >          description="Strip generics from java source (not working yet)">
214  
215      <mkdir dir="${build.stripped.dir}"/>
216  
217 +    <!--
218 +     # javac -s doesn't reliably generate compilable code. It generates
219 +     # bridge methods (marked as "synthetic") that can have identical
220 +     # signatures to existing methods except for the return value.
221 +     -->
222      <javac srcdir="${src.dir}"
223            destdir="${build.stripped.dir}"
224              debug="${build.debug}"
# Line 218 | Line 227
227             source="${build.sourcelevel}"
228               fork="true">
229  
230 <      <bootclasspath refid="javac.bootclasspath"/>
231 <      <compilerarg line="${javac.args} ${build.warnings.option} -s"/>
230 >      <compilerarg    line="${gjc.args} -s"/>
231 >      <bootclasspath refid="compile.bootclasspath"/>
232  
233      </javac>
234  
# Line 230 | Line 239
239            depends="init, dist-clean, dist-jar, dist-docs"
240            description="Puts all distributable products in single hierarchy"/>
241  
242 +  <target name="release"
243 +          depends="dist"
244 +          description="Puts entire CVS tree, plus distribution productions, in a jar">
245 +
246 + <!--
247 +    #keep build dir? - dl
248 +    <delete dir="${build.dir}"/>
249 + -->
250 +    <property name="release.jar" value="dist/jsr166-${version}-dist.jar"/>
251 +
252 +    <jar basedir="${basedir}" destfile="${release.jar}">
253 +      <exclude name="${release.jar}"/>
254 +      <exclude name="user.properties"/>
255 +      <exclude name="etc/notes/**"/>
256 +      <exclude name="lib/gjc/2.1/**"/>
257 +      <exclude name="**/SyntaxTest.java"/>
258 +    </jar>
259 +
260 +  </target>
261  
262    <target name="clean"
263            description="Removes all build products">
# Line 271 | Line 299
299  
300    <!-- Internal targets -->
301  
274  <target name="set-warnings-if" if="build.warnings">
275
276    <property name="build.warnings.option" value="-warnunchecked"/>
277
278  </target>
279
280
281  <target name="set-warnings-unless" unless="build.warnings">
282
283    <property name="build.warnings.option" value=""/>
284
285  </target>
286
302  
303 <  <target name="init"
289 <          depends="set-warnings-if, set-warnings-unless">
303 >  <target name="init">
304  
305      <!-- Version is kept in a separate file -->
306      <loadfile property="version" srcFile="version.properties"/>
# Line 314 | Line 328
328  
329  
330    <target name="compile-emulation"
331 <          depends="init"
331 >          depends="init, configure-compiler"
332            if="build.emulation.true">
333  
334      <mkdir dir="${build.emulation.dir}"/>
# Line 327 | Line 341
341             source="${build.sourcelevel}"
342               fork="true">
343  
344 <      <bootclasspath refid="javac.bootclasspath"/>
345 <      <compilerarg line="${javac.args} ${build.warnings.option}"/>
344 >      <compilerarg    line="${gjc.args}"/>
345 >      <bootclasspath refid="compile.bootclasspath"/>
346  
347      </javac>
348  
# Line 342 | Line 356
356  
357      <jar destfile="${product.jar}" duplicate="add">
358        <fileset dir="${build.classes.dir}">
359 <        <patternset refid="emulation.excludes"/>
359 >        <patternset refid="atomic.exclusion"/>
360 >        <patternset refid="unsafe.exclusion"/>
361        </fileset>
362        <fileset dir="${build.emulation.dir}"/>
363      </jar>
# Line 378 | Line 393
393  
394      <copy todir="${build.filter.src.dir}">
395        <fileset dir="${src.dir}">
396 <        <patternset refid="emulation.excludes"/>
396 >        <include name="**/*.html"/>
397 >      </fileset>
398 >    </copy>
399 >
400 >    <copy todir="${build.filter.src.dir}">
401 >      <fileset dir="${src.dir}">
402 >        <exclude name="**/*.html"/>
403 >        <patternset refid="unsafe.exclusion"/>
404        </fileset>
405        <filterchain>
406 +
407 +        <!--
408 +         # This filter gets rid of angle-bracketed type parameters
409 +         # so that javadoc can run on the result. The following
410 +         # heuristic seems to work:
411 +         #
412 +         # For all lines not starting with space(s)-asterisk-space(s),
413 +         #   replace <something> with a space, where there may be more
414 +         #   than one right angle bracket at the end, and "something"
415 +         #   must not contain parens or pipes. (This may need some
416 +         #   tweaking.)
417 +         -->
418 +
419          <filterreader classname="jsr166.ant.filters.ReplaceFilter"
420                        classpath="${build.ant.dir}">
386          <!--
387           # These arguments are to get rid of angle-bracketed type
388           # parameters so that javadoc can run on the result. The
389           # following heuristic that seems to work:
390           #
391           # For all lines not starting with space(s)-asterisk-space(s),
392           #   replace <something> with a space, where there may be more
393           #   than one right angle bracket at the end, and "something"
394           #   must not contain parens or pipes. (This may need some
395           #   tweaking.)
396           -->
421            <param name="notmatching" value="^\s+\*\s.*$"/>
422 <          <param name="pattern" value="&lt;[^|>()]+?>+"/>
422 >          <param name="pattern"     value="&lt;[^|>()]+?>+"/>
423            <param name="replacement" value=" "/>
424          </filterreader>
425 +
426 +
427 +        <!--
428 +         # This filter uncomments lines beginning with "//@" so that
429 +         # javadoc can see imports that are needed to resolve links
430 +         # but that shouldn't be in the compiled code.
431 +         -->
432 +
433          <filterreader classname="jsr166.ant.filters.ReplaceFilter"
434                        classpath="${build.ant.dir}">
435 <          <!--
436 <           # These arguments are to uncomment lines beginning with
405 <           # "//@" so that javadoc can see imports that are needed
406 <           # to resolve links but that shouldn't be in the compiled
407 <           # code.
408 <           -->
409 <          <param name="matching" value="^//@.*$"/>
410 <          <param name="pattern" value="^//@"/>
435 >          <param name="matching"    value="^//@.*$"/>
436 >          <param name="pattern"     value="^//@"/>
437            <param name="replacement" value=""/>
438          </filterreader>
439        </filterchain>
# Line 416 | Line 442
442    </target>
443  
444  
445 +
446 +
447 +  <target name="filter-doccheck"
448 +          depends="filter-src">
449 +
450 +    <mkdir dir="${build.filter.doccheck.dir}"/>
451 +
452 +    <copy todir="${build.filter.doccheck.dir}">
453 +      <fileset dir="${build.filter.src.dir}">
454 +        <include name="**/*.html"/>
455 +      </fileset>
456 +    </copy>
457 +
458 +    <property name="generic.declarations"
459 +             value="/** Fake type parameter. */ public interface E {} /** Fake type parameter. */ public interface T {} /** Fake type parameter. */ public interface K {} /** Fake type parameter. */ public interface V {}"
460 +    />
461 +
462 +    <copy todir="${build.filter.doccheck.dir}">
463 +      <fileset dir="${build.filter.src.dir}">
464 +        <exclude name="**/*.html"/>
465 +      </fileset>
466 +      <filterchain>
467 +        <!--
468 +         # These two filters try to make the source look like
469 +         # something that doccheck can process. The first removes
470 +         # -source 1.4 assertions and the second adds in a bunch
471 +         # of single letter public nested marker interfaces so that
472 +         # the generic type parameters are recognized.
473 +         -->
474 +
475 +        <filterreader classname="jsr166.ant.filters.ReplaceFilter"
476 +                      classpath="${build.ant.dir}">
477 +          <param name="matching"    value="^\s*assert[\s ].*$"/>
478 +          <param name="pattern"     value="assert"/>
479 +          <param name="replacement" value="//assert"/>
480 +        </filterreader>
481 +
482 +        <filterreader classname="jsr166.ant.filters.ReplaceFilter"
483 +                      classpath="${build.ant.dir}">
484 +          <param name="matching"    value="^([^*]*(class|interface|implements) .*|)\{.*$"/>
485 +          <param name="pattern"     value="$"/>
486 +          <param name="replacement" value=" ${generic.declarations}"/>
487 +        </filterreader>
488 +
489 +      </filterchain>
490 +    </copy>
491 +
492 +  </target>
493 +
494 +
495    <target name="compile-tests"
496            depends="jar">
497  
498      <mkdir dir="${build.testcases.dir}"/>
499  
500 + <!--
501 +    <echo>javac ${gjc.args}</echo>
502 +    <echo>bootclasspath=${test.compile.bootclasspath}</echo>
503 +    <echo>classpath="${test.classpath}"</echo>
504 + -->
505 +
506      <javac srcdir="${test.src.dir}"
507            destdir="${build.testcases.dir}"
508              debug="${build.debug}"
# Line 429 | Line 511
511             source="${build.sourcelevel}"
512               fork="true">
513  
514 <      <bootclasspath refid="javac.bootclasspath"/>
515 <      <compilerarg line="${javac.args} ${build.warnings.option}"/>
516 <      <classpath refid="test.classpath"/>
514 >      <compilerarg    line="${gjc.args}"/>
515 >      <bootclasspath refid="test.compile.bootclasspath"/>
516 >      <classpath     refid="test.classpath"/>
517  
518      </javac>
519  
# Line 453 | Line 535
535                      dir="${build.reports.dir}"
536                     fork="true">
537  
538 <      <jvmarg value="${test.javac.args}"/>
538 >      <jvmarg value="-Xbootclasspath/p:${test.run.bootclasspath}"/>
539  
540        <formatter type="xml"/>
541  
# Line 494 | Line 576
576    </target>
577  
578  
579 <  <target name="check-junit">
579 >  <target name="configure-compiler">
580  
581 <    <!-- junit.framework.Protectable is in JUnit 3.8.1 but not in 3.7 -->
582 <    <available property="junit.available"
501 <               classname="junit.framework.Protectable"/>
581 >    <property name="gjc.version"
582 >             value="2.2"/>
583  
584 <    <fail message="Need JUnit 3.8.1 in ${ant.home}${file.separator}lib to run tests"
585 <          unless="junit.available"/>
584 >    <condition property="novariance.arg" value="-novariance">
585 >      <and>
586 >        <equals arg1="${gjc.version}" arg2="2.0"/>
587 >        <or>
588 >          <not><isset property="gjc.novariance"/></not>
589 >          <istrue value="${gjc.novariance}"/>
590 >        </or>
591 >      </and>
592 >    </condition>
593 >
594 >    <property name="novariance.arg"
595 >             value=""/>
596 >
597 >    <property name="gjc.dir"
598 >             value="${lib.dir}/gjc"/>
599 >
600 >    <property name="javac.jar"
601 >          location="${gjc.dir}/${gjc.version}/javac.jar"/>
602 >
603 >    <property name="collect.jar"
604 >          location="${gjc.dir}/${gjc.version}/collect${novariance.arg}.jar"/>
605 >
606 >
607 >    <condition property="warnunchecked.arg" value="-warnunchecked">
608 >      <istrue value="${gjc.warnunchecked}"/>
609 >    </condition>
610 >
611 >    <property name="warnunchecked.arg" value=""/>
612 >
613 >    <condition property="prepare.src.dir" value="${build.dir}/prepare-src">
614 >      <istrue value="${build.nothreads}"/>
615 >    </condition>
616 >
617 >
618 >    <!--
619 >     ! Bootclasspath munging for source compilation.
620 >     -->
621 >
622 >    <path id="pre.bootclasspath">
623 >      <pathelement location="${javac.jar}"/>
624 >    </path>
625 >
626 >    <path id="compile.bootclasspath">
627 >      <pathelement location="${build.classes.dir}"/>
628 >      <pathelement location="${collect.jar}"/>
629 >      <pathelement location="${rt.jar}"/>
630 >    </path>
631 >
632 >    <!-- Flatten paths into platform-appropriate strings -->
633 >    <property name="pre.bootclasspath"     refid="pre.bootclasspath"/>
634 >    <property name="compile.bootclasspath" refid="compile.bootclasspath"/>
635 >
636 >
637 >    <!-- Common options in javac invocations -->
638 >    <property name="gjc.args"
639 >             value="-J-Xbootclasspath/p:${pre.bootclasspath} ${warnunchecked.arg} ${novariance.arg}"
640 >    />
641  
642    </target>
643  
644  
645 <  <target name="check-emulation">
645 >  <target name="prepare-src"
646 >          depends="configure-compiler"
647 >          if="prepare.src.dir">
648 >
649 >    <mkdir dir="${prepare.src.dir}"/>
650 >    <copy todir="${prepare.src.dir}">
651 >      <fileset dir="${src.dir}">
652 >        <exclude name="java/lang/**"/>
653 >      </fileset>
654 >    </copy>
655 >
656 >  </target>
657 >
658 >
659 >  <target name="configure-emulation">
660 >
661      <condition property="build.emulation.true">
662        <or>
663 <        <isset property="build.emulation"/>
664 <        <os family="windows"/>
663 >        <and>
664 >          <os family="windows"/>
665 >          <not>
666 >            <isset property="build.emulation"/>
667 >          </not>
668 >        </and>
669 >        <istrue value="${build.emulation}"/>
670        </or>
671      </condition>
672 +
673 +  </target>
674 +
675 +
676 +  <target name="configure-tests"
677 +       depends="configure-compiler">
678 +
679 +    <!-- junit.framework.Protectable is in JUnit 3.8.1 but not in 3.7 -->
680 +    <available property="junit.available"
681 +               classname="junit.framework.Protectable"/>
682 +
683 +    <fail message="Need JUnit 3.8.1 in ${ant.home}${file.separator}lib to run tests"
684 +          unless="junit.available"/>
685 +
686 +
687 +    <!--
688 +     ! Bootclasspath munging for testing, so JUnit can test our local
689 +     ! modifications to java.*.
690 +     -->
691 +
692 +    <path id="test.classpath">
693 +      <pathelement location="${product.jar}"/>
694 +      <pathelement location="${build.testcases.dir}"/>
695 +      <pathelement location="${junit.jar}"/>
696 +    </path>
697 +
698 +    <path id="test.compile.bootclasspath">
699 +      <pathelement location="${javac.jar}"/>
700 +      <pathelement location="${collect.jar}"/>
701 +      <pathelement location="${rt.jar}"/>
702 +    </path>
703 +
704 +    <path id="test.run.bootclasspath">
705 +      <pathelement location="${javac.jar}"/>
706 +      <path refid="test.classpath"/>
707 +    </path>
708 +
709 +    <!-- Flatten test classpaths into platform-appropriate strings -->
710 +    <property name="test.classpath"             refid="test.classpath"/>
711 +    <property name="test.compile.bootclasspath" refid="test.compile.bootclasspath"/>
712 +    <property name="test.run.bootclasspath"     refid="test.run.bootclasspath"/>
713 +
714    </target>
715  
716  
# Line 542 | Line 740
740    </target>
741  
742  
743 +  <target name="ng" depends="test">
744 +    <java classname="SuperfluousAbstract" fork="true">
745 +
746 +      <jvmarg value="-Xbootclasspath/p:${test.run.bootclasspath}"/>
747 +
748 +    </java>
749 +  </target>
750 +
751 +
752   </project>

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines