@@ -25,7 +25,7 @@
<li>Dave Walend (<a href="mailto:dwalend@cs.tufts.edu">dwalend@cs.tufts.edu</a>)</li>
<li>Dave Walend (<a href="mailto:dwalend@cs.tufts.edu">dwalend@cs.tufts.edu</a>)</li>
</ul>
</ul>
<p>Version 1.2 - 2000/08/10 </p>
<p>Version 1.2 - 2000/09/07 </p>
<hr>
<hr>
<h2>Table of Contents</h2>
<h2>Table of Contents</h2>
@@ -444,8 +444,7 @@ location attributes of its own, so</p>
<classpath path="${classpath}" />
<classpath path="${classpath}" />
</pre>
</pre>
<p>In addition, <a href="#fileset">FileSet</a>s can be specified via
<p>In addition, <a href="#fileset">FileSet</a>s can be specified via
nested <code><fileset></code> and
<code><filesetref></code> elements. The order in which the files
nested <code><fileset></code> elements. The order in which the files
building up FileSet are added to the PATH like structure is not
building up FileSet are added to the PATH like structure is not
defined.</p>
defined.</p>
<pre>
<pre>
@@ -746,7 +745,7 @@ directory based task that constitutes an implicit FileSet. In addition
<p>Builds a set of patterns, that matches all <code>.java</code> files
<p>Builds a set of patterns, that matches all <code>.java</code> files
that do not contain the text <code>Test</code> in their name. This set
that do not contain the text <code>Test</code> in their name. This set
can be <a href="#references">referred</a> to via
can be <a href="#references">referred</a> to via
<code><patternsetref refid="non.test.sources"
<code><patternset refid="non.test.sources"
/></code> by tasks that support this feature or by FileSets.</p>
/></code> by tasks that support this feature or by FileSets.</p>
<h3><a name="fileset">FileSets</a></h3>
<h3><a name="fileset">FileSets</a></h3>
<p>FileSets are groups of files. These files can be found in a
<p>FileSets are groups of files. These files can be found in a
@@ -756,7 +755,7 @@ href="#patternset">PatternSets</a>. FileSets can appear inside task
that support this feature or at the same level as <code>target</code>
that support this feature or at the same level as <code>target</code>
- i.e. as children of <code>project</code>.</p>
- i.e. as children of <code>project</code>.</p>
<p>PatternSets can be specified as nested
<p>PatternSets can be specified as nested
<code><patternset></code> or <code><patternsetref></code>
<code><patternset></code>
elements. In addition FileSet holds an implicit PatternSet and
elements. In addition FileSet holds an implicit PatternSet and
supports the nested <code><include></code> and
supports the nested <code><include></code> and
<code><exclude></code> elements of PatternSet directly as well
<code><exclude></code> elements of PatternSet directly as well
@@ -817,7 +816,7 @@ source files and don't have the text <code>Test</code> in their
name.</p>
name.</p>
<blockquote><pre>
<blockquote><pre>
<fileset dir="${client.src}" >
<fileset dir="${client.src}" >
<patternsetref refid="non.test.sources" />
<patternset refid="non.test.sources" />
</fileset>
</fileset>
</pre></blockquote>
</pre></blockquote>
<p>Groups all files in directory <code>${client.src}</code> using the
<p>Groups all files in directory <code>${client.src}</code> using the
@@ -998,8 +997,7 @@ write patterns.</p>
<p>This task holds an implicit <a href="#fileset">FileSet</a> and
<p>This task holds an implicit <a href="#fileset">FileSet</a> and
supports all of FileSet's attributes and nested elements
supports all of FileSet's attributes and nested elements
directly. More FileSets can be specified using nested
directly. More FileSets can be specified using nested
<code><fileset></code> or <code><filesetref></code>
elements.</p>
<code><fileset></code> elements.</p>
<h3>Parameters</h3>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<tr>
@@ -1088,7 +1086,7 @@ readable and executable for anyone on a UNIX system.</p>
<fileset dir="shared/sources1" >
<fileset dir="shared/sources1" >
<exclude name="**/trial/**" />
<exclude name="**/trial/**" />
</fileset>
</fileset>
<filesetref refid="other.shared.sources" />
<fileset refid="other.shared.sources" />
</chmod>
</chmod>
</pre>
</pre>
</blockquote>
</blockquote>
@@ -1113,9 +1111,8 @@ inclusion/exclusion of files works, and how to write patterns.</p>
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code>
supports all attributes of <code><fileset></code>
(<code>dir</code> becomes <code>src</code>) as well as the nested
(<code>dir</code> becomes <code>src</code>) as well as the nested
<code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
<code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<h3>Parameters</h3>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<tr>
@@ -1326,9 +1323,8 @@ href="#directorybasedtasks">directory based tasks</a>, on how the
inclusion/exclusion of files works, and how to write patterns.</p>
inclusion/exclusion of files works, and how to write patterns.</p>
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code> as well as the
supports all attributes of <code><fileset></code> as well as the
nested <code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
nested <code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<h3>Parameters</h3>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<tr>
@@ -1558,8 +1554,7 @@ the command is only executed when Ant is run on one of the specified operating
systems.</p>
systems.</p>
<p>The files and/or directories of a number of <a
<p>The files and/or directories of a number of <a
href="#fileset">FileSet</a>s are passed as arguments to the system
href="#fileset">FileSet</a>s are passed as arguments to the system
command. At least one nested <code><fileset></code> or
<code><filesetref></code> is required.</p>
command. At least one nested <code><fileset></code> is required.</p>
<h3>Parameters</h3>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<tr>
@@ -1619,11 +1614,10 @@ command. At least one nested <code><fileset></code> or
</tr>
</tr>
</table>
</table>
<h3>Parameters specified as nested elements</h3>
<h3>Parameters specified as nested elements</h3>
<h4>fileset and filesetref </h4>
<h4>fileset</h4>
<p>You can use any number of nested <code><fileset></code>
<p>You can use any number of nested <code><fileset></code>
elements to define the files for this task and refer to
elements to define the files for this task and refer to
<code><fileset></code>s defined elsewhere via
<code><filesetref></code> elements.</p>
<code><fileset></code>s defined elsewhere.</p>
<h4>arg</h4>
<h4>arg</h4>
<p>Command line arguments should be specified as nested
<p>Command line arguments should be specified as nested
<code><arg></code> elements. See <a
<code><arg></code> elements. See <a
@@ -1644,7 +1638,7 @@ description in the section about <a href="#env">exec</a></p>
<exclude name="**/*.txt" />
<exclude name="**/*.txt" />
</patternset>
</patternset>
</fileset>
</fileset>
<filesetref refid="other.files" />
<fileset refid="other.files" />
</execon>
</execon>
</pre></blockquote>
</pre></blockquote>
<p>invokes <code>ls -l</code>, adding the absolute filenames of all
<p>invokes <code>ls -l</code>, adding the absolute filenames of all
@@ -1698,9 +1692,8 @@ inclusion/exclusion of files works, and how to write patterns.</p>
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code>
supports all attributes of <code><fileset></code>
(<code>dir</code> becomes <code>srcdir</code>) as well as the nested
(<code>dir</code> becomes <code>srcdir</code>) as well as the nested
<code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
<code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<h3>Parameters</h3>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<tr>
@@ -2075,9 +2068,8 @@ inclusion/exclusion of files works, and how to write patterns.</p>
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code>
supports all attributes of <code><fileset></code>
(<code>dir</code> becomes <code>basedir</code>) as well as the nested
(<code>dir</code> becomes <code>basedir</code>) as well as the nested
<code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
<code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<p>You can also use nested file sets for more flexibility, and specify
<p>You can also use nested file sets for more flexibility, and specify
multiple ones to merge together different trees of files into one JAR.
multiple ones to merge together different trees of files into one JAR.
See the <a href="#zip">Zip</a> task for more details and examples.</p>
See the <a href="#zip">Zip</a> task for more details and examples.</p>
@@ -2424,9 +2416,8 @@ inclusion/exclusion of files works, and how to write patterns.</p>
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code>
supports all attributes of <code><fileset></code>
(<code>dir</code> becomes <code>srcdir</code>) as well as the nested
(<code>dir</code> becomes <code>srcdir</code>) as well as the nested
<code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
<code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<h4>src, classpath, bootclasspath and extdirs</h4>
<h4>src, classpath, bootclasspath and extdirs</h4>
<p><code>Javac</code>'s <em>srcdir</em>, <em>classpath</em>,
<p><code>Javac</code>'s <em>srcdir</em>, <em>classpath</em>,
<em>bootclasspath</em> and <em>extdirs</em> attributes are <a
<em>bootclasspath</em> and <em>extdirs</em> attributes are <a
@@ -3161,9 +3152,8 @@ must use a nested <code><replacetoken></code> element.</p>
<h3>Parameters specified as nested elements</h3>
<h3>Parameters specified as nested elements</h3>
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code> as well as the
supports all attributes of <code><fileset></code> as well as the
nested <code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
nested <code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<p>If either the text you want to replace or the replacement text
<p>If either the text you want to replace or the replacement text
cross line boundaries, you can use nested elements to specify
cross line boundaries, you can use nested elements to specify
them.</p>
them.</p>
@@ -3206,9 +3196,8 @@ inclusion/exclusion of files works, and how to write patterns.</p>
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code>
supports all attributes of <code><fileset></code>
(<code>dir</code> becomes <code>base</code>) as well as the nested
(<code>dir</code> becomes <code>base</code>) as well as the nested
<code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
<code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<h3>Parameters</h3>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<tr>
@@ -3399,9 +3388,8 @@ inclusion/exclusion of files works, and how to write patterns.</p>
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code>
supports all attributes of <code><fileset></code>
(<code>dir</code> becomes <code>basedir</code>) as well as the nested
(<code>dir</code> becomes <code>basedir</code>) as well as the nested
<code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
<code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<p>Note that this task does not perform compression. You might want to use the <a href="#gzip">GZip</a>
<p>Note that this task does not perform compression. You might want to use the <a href="#gzip">GZip</a>
task to come up with a .tar.gz package.</p>
task to come up with a .tar.gz package.</p>
<h3>Parameters</h3>
<h3>Parameters</h3>
@@ -3576,9 +3564,8 @@ inclusion/exclusion of files works, and how to write patterns.</p>
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code>
supports all attributes of <code><fileset></code>
(<code>dir</code> becomes <code>basedir</code>) as well as the nested
(<code>dir</code> becomes <code>basedir</code>) as well as the nested
<code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
<code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<h3>Parameters</h3>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<tr>
@@ -3734,16 +3721,14 @@ inclusion/exclusion of files works, and how to write patterns.
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code>
supports all attributes of <code><fileset></code>
(<code>dir</code> becomes <code>basedir</code>) as well as the nested
(<code>dir</code> becomes <code>basedir</code>) as well as the nested
<code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
<code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<p>Or, you may place within it nested file sets, or references to file sets.
<p>Or, you may place within it nested file sets, or references to file sets.
In this case <code>basedir</code> is optional; the implicit file set is <em>only used</em>
In this case <code>basedir</code> is optional; the implicit file set is <em>only used</em>
if <code>basedir</code> is set. You may use any mixture of the implicit file set
if <code>basedir</code> is set. You may use any mixture of the implicit file set
(with <code>basedir</code> set, and optional attributes like <code>includes</code>
(with <code>basedir</code> set, and optional attributes like <code>includes</code>
and optional subelements like <code><include></code>); explicit nested
and optional subelements like <code><include></code>); explicit nested
<code><fileset></code> elements; and nested <code><filesetref></code>
elements; so long as at least one fileset total is specified. The ZIP file will
<code><fileset></code> elements so long as at least one fileset total is specified. The ZIP file will
only reflect the relative paths of files <em>within</em> each fileset.</p>
only reflect the relative paths of files <em>within</em> each fileset.</p>
<p>The <code>whenempty</code> parameter controls what happens when no files match.
<p>The <code>whenempty</code> parameter controls what happens when no files match.
If <code>skip</code> (the default), the ZIP is not created and a warning is issued.
If <code>skip</code> (the default), the ZIP is not created and a warning is issued.
@@ -3864,9 +3849,8 @@ write patterns.</p>
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code>
supports all attributes of <code><fileset></code>
(<code>dir</code> becomes <code>basedir</code>) as well as the nested
(<code>dir</code> becomes <code>basedir</code>) as well as the nested
<code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
<code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<h3>Parameters:</h3>
<h3>Parameters:</h3>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<tr>
@@ -4193,9 +4177,8 @@ inclusion/exclusion of files works, and how to write patterns.</p>
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
<p>This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code>
supports all attributes of <code><fileset></code>
(<code>dir</code> becomes <code>srcdir</code>) as well as the nested
(<code>dir</code> becomes <code>srcdir</code>) as well as the nested
<code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
<code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<h3>Parameters:</h3>
<h3>Parameters:</h3>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
@@ -4443,9 +4426,8 @@ inclusion/exclusion of files works, and how to write patterns.
This task forms an implicit <a href="#fileset">FileSet</a> and
This task forms an implicit <a href="#fileset">FileSet</a> and
supports all attributes of <code><fileset></code>
supports all attributes of <code><fileset></code>
(<code>dir</code> becomes <code>srcDir</code>) as well as the nested
(<code>dir</code> becomes <code>srcDir</code>) as well as the nested
<code><include></code>, <code><exclude></code>,
<code><patternset></code> and <code><patternsetref></code>
elements.</p>
<code><include></code>, <code><exclude></code> and
<code><patternset></code> elements.</p>
<h3>Parameters:</h3>
<h3>Parameters:</h3>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<tr>