@@ -24,7 +24,7 @@
<body>
<h2><a name="resource">Resources</a> </h2>
<h2 id="resource">Resources </h2>
<p>
A file-like entity can be abstracted to the concept of a <i>resource</i>.
In addition to providing access to file-like attributes, a resource
@@ -53,7 +53,7 @@ explicit use beginning in <b>Ant 1.7</b>.
<li><a href="#zipentry">zipentry</a> - an entry in a zip file.</li>
</ul>
<h4><a name="basic">resource</a> </h4>
<h4 id="basic">resource </h4>
<p>A basic resource. Other resource types derive from this basic
type; as such all its attributes are available, though in most cases
@@ -62,7 +62,7 @@ implementations are also usable as single-element
<a href="#collection">Resource Collections</a>.
</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -95,11 +95,11 @@ implementations are also usable as single-element
</tr>
</table>
<h4><a name="file">file</a> </h4>
<h4 id="file">file </h4>
<p>Represents a file accessible via local filesystem conventions.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -119,11 +119,11 @@ implementations are also usable as single-element
</tr>
</table>
<h4><a name="javaresource">javaresource</a> </h4>
<h4 id="javaresource">javaresource </h4>
<p>Represents a resource loadable via a Java classloader.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -167,13 +167,12 @@ implementations are also usable as single-element
where <b><classpath></b> is a <a
href="../using.html#path">path-like structure</a>.</p>
<h4><a name="javaconstant">javaconstant</a></h4>
<p>Loads the value of a java constant. As a specialisation of
<h4 id="javaconstant">javaconstant</h4>
<p>Loads the value of a java constant. As a specialisation of
<a href="#javaresource">javaresource</a> all of its attributes and nested elements are
supported. A constant must be specified as <tt>public static</tt> otherwise it could not be loaded.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -206,15 +205,14 @@ of that constant (<tt>build.xml</tt>).
<javaconstant name="org.apache.tools.ant.Main.DEFAULT_BUILD_FILENAME"/>
</copy></code></pre>
<h4><a name="zipentry">zipentry</a></h4>
<h4 id="zipentry">zipentry</h4>
<p>Represents an entry in a ZIP archive. The archive can be specified
using the archive attribute or a nested single-element resource
collection. <code>zipentry</code> only supports file system resources
as nested elements.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -239,13 +237,13 @@ as nested elements.</p>
</tr>
</table>
<h4><a name="tarentry">tarentry</a> </h4>
<h4 id="tarentry">tarentry </h4>
<p>Represents an entry in a TAR archive. The archive can be specified
using the archive attribute or a nested single-element resource
collection.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -264,21 +262,21 @@ collection.</p>
</tr>
</table>
<h4><a name="gzipresource">gzipresource</a> </h4>
<h4 id="gzipresource">gzipresource </h4>
<p>This is not a stand-alone resource, but a wrapper around another
resource providing compression of the resource's contents on the fly.
A single element resource collection must be specified as a nested
element.</p>
<h4><a name="bzip2resource">bzip2resource</a> </h4>
<h4 id="bzip2resource">bzip2resource </h4>
<p>This is not a stand-alone resource, but a wrapper around another
resource providing compression of the resource's contents on the fly.
A single element resource collection must be specified as a nested
element.</p>
<h4><a name="xzresource">xzresource</a> </h4>
<h4 id="xzresource">xzresource </h4>
<p>This is not a stand-alone resource, but a wrapper around another
resource providing compression of the resource's contents on the fly.
@@ -290,11 +288,11 @@ depends on external libraries not included in the Ant distribution.
See <a href="../install.html#librarydependencies">Library
Dependencies</a> for more information.</p>
<h4><a name="url">url</a> </h4>
<h4 id="url">url </h4>
<p>Represents a URL.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -321,12 +319,12 @@ Dependencies</a> for more information.</p>
</tr>
</table>
<h4><a name="string">string</a> </h4>
<h4 id="string">string </h4>
<p>Represents a Java String. It can be written to, but only once, after which
it will be an error to write to again.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -346,14 +344,12 @@ it will be an error to write to again.</p>
self.log("Ant version =${ant.version}");
</string>
</pre>
</p>
<h4><a name="propertyresource">propertyresource</a> </h4>
<h4 id="propertyresource">propertyresource</h4>
<p>Represents an Ant property.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -366,12 +362,13 @@ it will be an error to write to again.</p>
</tr>
</table>
<hr>
<h2><a name="collection">Resource Collections</a> </h2>
<hr/ >
<h2 id="collection">Resource Collections </h2>
<p>
A Resource Collection is an abstraction of an entity that groups
together a number of <a href="#resource">resources</a>. Several of
Ant's "legacy" datatypes have been modified to behave as Resource Collections:
</p>
<ul>
<li><a href="fileset.html">fileset</a>,
<a href="dirset.html">dirset</a>,
@@ -392,8 +389,7 @@ Ant's "legacy" datatypes have been modified to behave as Resource Collections:
exposes <a href="#propertyresource">property</a> resources
</li>
</ul>
</p>
<p>Strangely, some tasks can even legitimately behave as resource collections:
<p>Strangely, some tasks can even legitimately behave as resource collections:</p>
<ul>
<li><a href="../Tasks/concat.html">concat</a>
exposes a concatenated resource, and adds e.g.
@@ -401,7 +397,6 @@ Ant's "legacy" datatypes have been modified to behave as Resource Collections:
to Ant's resource-related capabilities.
</li>
</ul>
</p>
<h3>The additional built-in resource collections are:</h3>
<ul>
<li><a href="#resources">resources</a> - generic resource collection</li>
@@ -434,7 +429,8 @@ Ant's "legacy" datatypes have been modified to behave as Resource Collections:
<li><a href="#resourcelist">resourcelist</a> - a collection of
resources whose names have been read from another resource.</li>
</ul>
<h4><a name="resources">resources</a></h4>
<h4 id="resources">resources</h4>
<p>A generic resource collection, designed for use with
<a href="../using.html#references">references</a>.
For example, if a third-party Ant task generates a Resource Collection
@@ -445,7 +441,7 @@ Ant's "legacy" datatypes have been modified to behave as Resource Collections:
duplicate resources (contrast with <a href="#union">union</a>).
</p>
<blockquote>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -459,7 +455,7 @@ Ant's "legacy" datatypes have been modified to behave as Resource Collections:
</table>
</blockquote>
<h4><a name="files">files</a> </h4>
<h4 id="files">files </h4>
<p>A group of files. These files are matched by <b>absolute</b> patterns
taken from a number of <a href="patternset.html">PatternSets</a>.
These can be specified as nested <code><patternset></code>
@@ -483,7 +479,7 @@ Ant's "legacy" datatypes have been modified to behave as Resource Collections:
the file has been included based on pattern-based selection.
</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -532,17 +528,16 @@ Ant's "legacy" datatypes have been modified to behave as Resource Collections:
</tr>
</table>
<p><a name="symlink"><b>Note</b></a >: All files/directories for which
<p id="symlink"><b>Note</b >: All files/directories for which
the canonical path is different from its path are considered symbolic
links. On Unix systems this usually means the file really is a
symbolic link but it may lead to false results on other
platforms.
</p>
<h4><a name="restrict">restrict</a> </h4>
<h4 id="restrict">restrict </h4>
<p>Restricts a nested resource collection using resource selectors:
<blockquote>
<table border="1" cellpadding="2" cellspacing="0">
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -555,11 +550,11 @@ platforms.
<td valign="top" align="center">No, default <i>true</i></td>
</tr>
</table>
<h4>Parameters specified as nested elements</h4 >
<h5>Parameters specified as nested elements</h5 >
<p>A single resource collection is required.</p>
<p>Nested resource selectors are used to "narrow down" the included
resources, combined via a logical <i>AND</i>. These are patterned
after <a href="selectors.html">file selectors</a> but are,
resources, combined via a logical <i>AND</i>. These are patterned
after <a href="selectors.html">file selectors</a> but are,
unsurprisingly, targeted to resources.
Several built-in resource selectors are available in the internal
<a href="antlib.html">antlib</a>
@@ -583,7 +578,7 @@ platforms.
by a majority of nested resource selectors.</li>
<li><a href="selectors.html#modified">modified</a> - select resources which
content has changed.</li>
<li><a href="selectors.html#containsselect">contains</a> - select resources
<li><a href="selectors.html#containsselect">contains</a> - select resources
containing a particular text string.</li>
<li><a href="selectors.html#regexpselect">containsregexp</a> - select
resources whose contents match a particular regular expression.</li>
@@ -595,9 +590,9 @@ platforms.
Select files (resources must be files) if they are writable.</li>
</ul>
<h4><a name="rsel.name">name</a></h4 >
<h5 id="rsel.name">name</h5 >
<p>Selects resources by name.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -626,17 +621,17 @@ platforms.
resource name or name attribute as a / for the purposes of
matching. This attribute can be true or false, the default is
false.
<em>Since Ant 1.8.0. </em>
<em>Since Ant 1.8.0</em>
<td align="center" valign="top">No</td>
</tr>
</table>
<h4><a name="rsel.exists">exists</a></h4 >
<h5 id="rsel.exists">exists</h5 >
<p>Selects existing resources.</p>
<h4><a name="rsel.date">date</a></h4 >
<h5 id="rsel.date">date</h5 >
<p>Selects resources by date.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -675,9 +670,9 @@ platforms.
</tr>
</table>
<h4><a name="rsel.type">type</a></h4 >
<h5 id="rsel.type">type</h5 >
<p>Selects resources by type (file or directory).</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -685,14 +680,14 @@ platforms.
</tr>
<tr>
<td valign="top">type</td>
<td valign="top">One of "file", "dir", "any" (since Ant 1.8)</td>
<td valign="top">One of "file", "dir", "any" (<em> since Ant 1.8</em> )</td>
<td align="center" valign="top">Yes</td>
</tr>
</table>
<h4><a name="rsel.size">size</a></h4 >
<h5 id="rsel.size">size</h5 >
<p>Selects resources by size.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -711,9 +706,9 @@ platforms.
</tr>
</table>
<h4><a name="rsel.instanceof">instanceof</a></h4 >
<h5 id="rsel.instanceof">instanceof</h5 >
<p>Selects resources by type.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -736,25 +731,25 @@ platforms.
</tr>
</table>
<h4><a name="rsel.and">and</a></h4 >
<h5 id="rsel.and">and</h5 >
<p>Selects a resource if it is selected by all nested resource selectors.</p>
<h4><a name="rsel.or">or</a></h4 >
<h5 id="rsel.or">or</h5 >
<p>Selects a resource if it is selected
by at least one nested resource selector.</p>
<h4><a name="rsel.not">not</a></h4 >
<h5 id="rsel.not">not</h5 >
<p>Negates the selection result of the single
nested resource selector allowed.</p>
<h4><a name="rsel.none">none</a></h4 >
<h5 id="rsel.none">none</h5 >
<p>Selects a resource if it is selected
by no nested resource selectors.</p>
<h4><a name="rsel.majority">majority</a></h4 >
<h5 id="rsel.majority">majority</h5 >
<p>Selects a resource if it is selected
by the majority of nested resource selectors.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -768,10 +763,10 @@ platforms.
</tr>
</table>
<h4><a name="rsel.compare">compare</a></h4 >
<h5 id="rsel.compare">compare</h5 >
<p>Selects a resource based on its comparison to one or more "control"
resources using nested <a href="#rcmp">resource comparators</a>.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -790,15 +785,15 @@ platforms.
<td valign="top">No, default "all"</td>
</tr>
</table>
<h4>Parameters specified as nested elements</h4 >
<h6>Parameters specified as nested elements</h6 >
<p>The resources against which comparisons will be made must be specified
using the nested <control> element, which denotes a
<a href="#resources">resources</a> collection.</p>
<h4>Examples</h4 >
<p>Assuming the namespace settings
<h6>Examples</h6 >
<p>Assuming the namespace settings</p>
<pre><code> rsel="antlib:org.apache.tools.ant.types.resources.selectors"
rcmp="antlib:org.apache.tools.ant.types.resources.comparators"
</code></pre></p>
</code></pre>
<pre>
<restrict>
<fileset dir="src" includes="a,b,c,d,e,f,g" />
@@ -858,15 +853,12 @@ platforms.
which are not present. Finally we use the <i>toString:</i> <a href="../using.html#pathshortcut">pathshortcut</a> for
getting them in a readable form: <tt>[echo] These files are missed: ....foo.txt;....bar.txt</tt></p>
</blockquote>
<h4><a name="sort">sort</a></h4>
<h4 id="sort">sort</h4>
<p>Sorts a nested resource collection according to the resources'
natural order, or by one or more nested <a href="#rcmp">resource
comparators</a>:</p>
<blockquote>
<table border="1" cellpadding="2" cellspacing="0">
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -879,7 +871,7 @@ platforms.
<td valign="top" align="center">No, default <i>true</i></td>
</tr>
</table>
<h4>Parameters specified as nested elements</h4 >
<h5>Parameters specified as nested elements</h5 >
<p>A single resource collection is required.</p>
<p>The sort can be controlled and customized by specifying one or more
resource comparators. Resources can be sorted according to multiple
@@ -888,7 +880,7 @@ platforms.
are available in the internal <a href="antlib.html">antlib</a>
<code>org.apache.tools.ant.types.resources.comparators</code>:
</p>
<h4><a name="rcmp">Resource Comparators:</a></h4 >
<h5 id="rcmp">Resource Comparators:</h5 >
<ul>
<li><a href="#rcmp.name">name</a> - sort resources by name</li>
<li><a href="#rcmp.exists">exists</a> - sort resources by existence</li>
@@ -900,26 +892,26 @@ platforms.
or that of a single nested resource comparator</li>
</ul>
<h4><a name="rcmp.name">name</a></h4 >
<h6 id="rcmp.name">name</h6 >
<p>Sort resources by name.</p>
<h4><a name="rcmp.exists">exists</a></h4 >
<h6 id="rcmp.exists">exists</h6 >
<p>Sort resources by existence.
Not existing is considered "less than" existing.</p>
<h4><a name="rcmp.date">date</a></h4 >
<h6 id="rcmp.date">date</h6 >
<p>Sort resources by date.</p>
<h4><a name="rcmp.type">type</a></h4 >
<h6 id="rcmp.type">type</h6 >
<p>Sort resources by type (file or directory).
Because directories contain files, they are considered "greater".</p>
<h4><a name="rcmp.size">size</a></h4 >
<h6 id="rcmp.size">size</h6 >
<p>Sort resources by size.</p>
<h4><a name="rcmp.content">content</a></h4 >
<h6 id="rcmp.content">content</h6 >
<p>Sort resources by content.</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -928,16 +920,16 @@ platforms.
<tr>
<td valign="top">binary</td>
<td valign="top">Whether content should be compared in binary mode.
If <i>false<i>, content will be compared without regard to
If <i>false</ i>, content will be compared without regard to
platform-specific line-ending conventions.</td>
<td valign="top">No, default <i>true</i></td>
</tr>
</table>
<h4><a name="rcmp.reverse">reverse</a></h4 >
<h6 id="rcmp.reverse">reverse</h6 >
<p>Reverse the natural sort order, or that of a single nested comparator.</p>
<h4>Examples</h4 >
<h5>Examples</h5 >
<pre>
<property name="eol" value="${line.separator}" />
<pathconvert property="sorted" pathsep="${eol}">
@@ -948,10 +940,10 @@ platforms.
</tokens>
</sort>
</pathconvert></pre>
<p>The resource of type string "foo bar etc baz" is split into four tokens by
<p>The resource of type string "foo bar etc baz" is split into four tokens by
the stringtokenizer. These tokens are sorted and there <i>sorted</i> gets the value
of "bar baz etc foo".</p>
<pre>
<sort>
<fileset dir="foo" />
@@ -966,15 +958,12 @@ platforms.
their namespace must be set explicitly.
</p>
</blockquote>
<h4><a name="first">first</a></h4>
<h4 id="first">first</h4>
<p>Includes the first <i>count</i> resources from a nested resource collection.
This can be used in conjunction with the <a href="#sort">sort</a> collection,
for example, to select the first few oldest, largest, etc. resources from a
larger collection.</p>
<blockquote>
<table border="1" cellpadding="2" cellspacing="0">
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -992,17 +981,15 @@ larger collection.</p>
<td valign="top" align="center">No, default <i>true</i></td>
</tr>
</table>
<h4>Parameters specified as nested elements</h4 >
<h5>Parameters specified as nested elements</h5 >
<p>A single resource collection is required.</p>
</blockquote>
<h4><a name="last">last</a> </h4>
<h4 id="last">last </h4>
<p>Includes the last <i>count</i> resources from a nested resource collection.
This can be used in conjunction with the <a href="#sort">sort</a> collection,
for example, to select the last few oldest, largest, etc. resources from a
larger collection. <strong>Since Ant 1.7.1</strong>.</p>
<blockquote>
<table border="1" cellpadding="2" cellspacing="0">
larger collection. <em>Since Ant 1.7.1</em></p>
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -1020,18 +1007,16 @@ larger collection. <strong>Since Ant 1.7.1</strong>.</p>
<td valign="top" align="center">No, default <i>true</i></td>
</tr>
</table>
<h4>Parameters specified as nested elements</h4 >
<h5>Parameters specified as nested elements</h5 >
<p>A single resource collection is required.</p>
</blockquote>
<h4><a name="allbutfirst">allbutfirst</a> </h4>
<h4 id="allbutfirst">allbutfirst </h4>
<p>Includes all elements except for the first <i>count</i> resources
from a nested resource collection. This can be used in conjunction
with the <a href="#sort">sort</a> collection, for example, to select
all but the first few oldest, largest, etc. resources from a larger
collection. <strong>Since Ant 1.9.5</strong>.</p>
<blockquote>
<table border="1" cellpadding="2" cellspacing="0">
collection. <em>Since Ant 1.9.5</em></p>
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -1049,18 +1034,16 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
<td valign="top" align="center">No, default <i>true</i></td>
</tr>
</table>
<h4>Parameters specified as nested elements</h4 >
<h5>Parameters specified as nested elements</h5 >
<p>A single resource collection is required.</p>
</blockquote>
<h4><a name="allbutlast">allbutlast</a> </h4>
<h4 id="allbutlast">allbutlast </h4>
<p>Includes all elements except for the last <i>count</i> resources
from a nested resource collection. This can be used in conjunction
with the <a href="#sort">sort</a> collection, for example, to select
all but the last few oldest, largest, etc. resources from a larger
collection. <strong>Since Ant 1.9.5</strong>.</p>
<blockquote>
<table border="1" cellpadding="2" cellspacing="0">
collection. <em>Since Ant 1.9.5</em></p>
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -1078,19 +1061,17 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
<td valign="top" align="center">No, default <i>true</i></td>
</tr>
</table>
<h4>Parameters specified as nested elements</h4 >
<h5>Parameters specified as nested elements</h5 >
<p>A single resource collection is required.</p>
</blockquote>
<h4><a name="tokens">tokens</a> </h4>
<h4 id="tokens">tokens </h4>
<p>Includes the <a href="#string">string</a> tokens gathered from a nested
resource collection. Uses the same tokenizers supported by the
<a href="filterchain.html#tokenfilter">TokenFilter</a>. Imaginative
use of this resource collection can implement equivalents for such Unix
functions as <code>sort</code>, <code>grep -c</code>, <code>wc</code> and
<code>wc -l</code>.</p>
<blockquote>
<table border="1" cellpadding="2" cellspacing="0">
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -1108,14 +1089,14 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
<td valign="top" align="center">No, default <i>true</i></td>
</tr>
</table>
<h4>Parameters specified as nested elements</h4 >
<h5>Parameters specified as nested elements</h5 >
<ul>
<li>A single resource collection is required.</li>
<li>One nested tokenizer may be specified. If omitted, a
<a href="filterchain.html#linetokenizer">LineTokenizer</a> will be used.
</li>
</ul>
<h4>Examples</h4 >
<h5>Examples</h5 >
<pre><concat>
<union>
<sort>
@@ -1128,10 +1109,8 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
</concat>
</pre>
<p>Implements Unix <i>sort -u</i> against resource collection <i>input</i>.</p>
</blockquote>
<h4><a name="setlogic">Set operations</a></h4>
<blockquote>
<h4 id="setlogic">Set operations</h4>
<p>The following resource collections implement set operations:</p>
<ul>
<li><a href="#union">union</a></li>
@@ -1139,18 +1118,18 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
<li><a href="#difference">difference</a></li>
</ul>
<h4><a name="union">union</a> </h4>
<h4 id="union">union </h4>
<p>Union of nested resource collections.</p>
<h4><a name="intersect">intersect</a> </h4>
<h4 id="intersect">intersect </h4>
<p>Intersection of nested resource collections.</p>
<h4><a name="difference">difference</a> </h4>
<h4 id="difference">difference </h4>
<p>Difference of nested resource collections.</p>
<p>The following attributes apply to all set-operation resource collections:
</p>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -1163,8 +1142,8 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
<td valign="top" align="center">No, default <i>true</i></td>
</tr>
</table>
<h4>Examples</h4 >
<h5>Examples</h5 >
<pre>
<resources id="A">
<string value="a"/>
@@ -1186,9 +1165,8 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
difference: ${toString:difference} = a;c
</echo>
</pre>
</blockquote>
<h4><a name="mappedresources">mappedresources</a> </h4>
<h4 id="mappedresources">mappedresources </h4>
<p><em>Since Ant 1.8.0</em></p>
@@ -1201,10 +1179,9 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
use <em>mappedresources</em> with tasks that only allow file-system
based resources.</p>
<blockquote>
<h4>Parameters specified as attributes</h4>
<h5>Parameters specified as attributes</h5>
<table border="1" cellpadding="2" cellspacing="0" >
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -1222,18 +1199,18 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
If true the the collection will use all the mappings for a
given source path. If false the it will only process the first
resource.
<em>since Ant 1.8.1</em>. </td>
<em>since Ant 1.8.1</em></td>
<td align="center">No - defaults to false.</td>
</tr>
</table>
<h4>Parameters specified as nested elements</h4 >
<h5>Parameters specified as nested elements</h5 >
<p>A single resource collection is required.</p>
<p>A single <a href="mapper.html">mapper</a> can be used to map
names. If no mapper has been given (which doesn't make any sense,
honestly), an identity mapper will be used.</p>
<h4>Examples</h4 >
<h5>Examples</h5 >
<p>Copies all files from a given directory to a target directory
adding ".bak" as an extension. Note this could be done with a
@@ -1265,10 +1242,9 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
</chainedmapper>
</mappedresources>
</war>
</pre>
</blockquote>
</pre>
<h4><a name="archives">archives</a> </h4>
<h4 id="archives">archives </h4>
<p><em>Since Ant 1.8.0</em></p>
@@ -1284,8 +1260,7 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
<p><em>archives</em> doesn't support any attributes.</p>
<blockquote>
<h4>Parameters specified as nested elements</h4>
<h5>Parameters specified as nested elements</h5>
<p><code><archives></code> has two nested
elements <code><zips></code> and
@@ -1296,7 +1271,7 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
<p>The nested resources of <zips> are treated as ZIP archives,
the nested resources of <tars> as TAR archives.</p>
<h4>Examples</h4 >
<h5>Examples</h5 >
<p>Copies all files from all jars that are on the classpath
to <code>${target}</code>.</p>
@@ -1313,9 +1288,8 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
</archives>
</copy>
</pre>
</blockquote>
<h4><a name="resourcelist">resourcelist</a> </h4>
<h4 id="resourcelist">resourcelist </h4>
<p><em>Since Ant 1.8.0</em></p>
@@ -1335,8 +1309,7 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
<p><code><resourcelist></code> is a generalization
of <a href="filelist.html"><code><filelist></code></a>.</p>
<blockquote>
<table border="1" cellpadding="2" cellspacing="0">
<table>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
@@ -1348,10 +1321,8 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
<td valign="top" align="center">No, default is platform default</td>
</tr>
</table>
</blockquote>
<blockquote>
<h4>Parameters specified as nested elements</h4>
<h5>Parameters specified as nested elements</h5>
<p><code><resourcelist></code> accepts arbitrary many
resource(collection)s as nested elements.</p>
@@ -1362,7 +1333,7 @@ collection. <strong>Since Ant 1.9.5</strong>.</p>
expanded. Such a nested element corresponds to
a <a href="filterchain.html">filterchain</a>.</p>
<h4>Examples</h4 >
<h5>Examples</h5 >
<p>The following example copies a file from the first URL of
several alternatives that can actually be reached. It assumes
@@ -1375,7 +1346,7 @@ http://second.best.mirror.example.org/mirror/of/best/
https://yet.another.mirror/
http://the.original.site/
</pre>
<pre>
<copy todir="${target}">
<first>
@@ -1388,7 +1359,6 @@ http://the.original.site/
</first>
</copy>
</pre>
</blockquote>
</body>
</html>
Gintas Grigelionis