@@ -113,9 +113,9 @@ the <code>antlr-all.jar</code> target of the Makefile provided with the download | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3 id="nested">Nested Elements</h3> | |||||
<h3 id="nested">Parameters specified as nested elements</h3> | |||||
<p><code>ANTLR</code> supports a nested <code><classpath></code> element, that represents | |||||
<p>The task supports a nested <code><classpath></code> element, that represents | |||||
a <a href="../using.html#path">path-like structure</a>. It is given as a convenience if you have to | a <a href="../using.html#path">path-like structure</a>. It is given as a convenience if you have to | ||||
specify the original ANTLR directory. In most cases, dropping the appropriate ANTLR jar in the | specify the original ANTLR directory. In most cases, dropping the appropriate ANTLR jar in the | ||||
normal Ant lib repository will be enough.</p> | normal Ant lib repository will be enough.</p> | ||||
@@ -263,16 +263,18 @@ standard input.</p> | |||||
<h4>fileset</h4> | <h4>fileset</h4> | ||||
<p>You can use any number of nested <code><fileset></code> elements to define the files for | <p>You can use any number of nested <code><fileset></code> elements to define the files for | ||||
this task and refer to <code><fileset></code>s defined elsewhere.</p> | this task and refer to <code><fileset></code>s defined elsewhere.</p> | ||||
<h4>filelist</h4> | <h4>filelist</h4> | ||||
<p><em>Since Ant 1.6</em></p> | <p><em>Since Ant 1.6</em></p> | ||||
<p>You can use any number of nested <code><filelist></code> elements to define the files for | <p>You can use any number of nested <code><filelist></code> elements to define the files for | ||||
this task and refer to <code><filelist></code>s defined elsewhere.</p> | this task and refer to <code><filelist></code>s defined elsewhere.</p> | ||||
<h4>dirset</h4> | <h4>dirset</h4> | ||||
<p><em>Since Ant 1.6</em></p> | <p><em>Since Ant 1.6</em></p> | ||||
<p>You can use any number of nested <code><dirset></code> elements to define the directories | <p>You can use any number of nested <code><dirset></code> elements to define the directories | ||||
for this task and refer to <code><dirset></code>s defined elsewhere.</p> | for this task and refer to <code><dirset></code>s defined elsewhere.</p> | ||||
<h4>Any other <a href="../Types/resources.html#collection">Resource Collection</a></h4> | |||||
<h4>Any other <a href="../Types/resources.html#collection">resource collection</a></h4> | |||||
<p><em>Since Ant 1.7</em></p> | <p><em>Since Ant 1.7</em></p> | ||||
<p>You can use any number of nested resource collections.</p> | <p>You can use any number of nested resource collections.</p> | ||||
@@ -281,14 +283,16 @@ for this task and refer to <code><dirset></code>s defined elsewhere.</p> | |||||
attribute for dependency checking. If the <var>dest</var> attribute is specified it will be used as | attribute for dependency checking. If the <var>dest</var> attribute is specified it will be used as | ||||
a base directory for resolving relative pathnames returned by the mapper. At least one | a base directory for resolving relative pathnames returned by the mapper. At least one | ||||
<code><fileset></code> or <code><filelist></code> is required.</p> | <code><fileset></code> or <code><filelist></code> is required.</p> | ||||
<h4>arg</h4> | <h4>arg</h4> | ||||
<p>Command line arguments should be specified as nested <code><arg></code> | <p>Command line arguments should be specified as nested <code><arg></code> | ||||
elements. See <a href="../using.html#arg">Command line arguments</a>.</p> | elements. See <a href="../using.html#arg">Command line arguments</a>.</p> | ||||
<h4>srcfile</h4> | <h4>srcfile</h4> | ||||
<p>By default the file names of the source files will be added to the end of the command line | <p>By default the file names of the source files will be added to the end of the command line | ||||
(unless you set addsourcefile to <q>false</q>). If you need to place it somewhere different, use a | |||||
nested <code><srcfile></code> element between your <code><arg></code> elements to mark | |||||
the insertion point.</p> | |||||
(unless you set <var>addsourcefile</var> to <q>false</q>). If you need to place it somewhere | |||||
different, use a nested <code><srcfile></code> element between your <code><arg></code> | |||||
elements to mark the insertion point.</p> | |||||
<table class="attr"> | <table class="attr"> | ||||
<tr> | <tr> | ||||
<th>Attribute</th> | <th>Attribute</th> | ||||
@@ -38,7 +38,7 @@ nested <code><fileset></code>, <code><dirset></code> and <code><f | |||||
elements.</p> | elements.</p> | ||||
<p><em>Since Ant 1.7</em>, this task supports | <p><em>Since Ant 1.7</em>, this task supports | ||||
arbitrary <a href="../Types/resources.html#collection">Resource Collection</a>s as nested | |||||
arbitrary <a href="../Types/resources.html#collection">resource collections</a> as nested | |||||
elements.</p> | elements.</p> | ||||
<!--p>By default this task will use a single invocation of the underlying | <!--p>By default this task will use a single invocation of the underlying | ||||
@@ -168,7 +168,7 @@ Architecture Standard Algorithm Name Documentation</a></p> | |||||
</table> | </table> | ||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>resource collection</h4> | |||||
<h4>resource collections</h4> | |||||
<p><a href="../Types/resources.html#collection">Resource collections</a> are used to select files | <p><a href="../Types/resources.html#collection">Resource collections</a> are used to select files | ||||
for which checksums should be generated.</p> | for which checksums should be generated.</p> | ||||
@@ -38,7 +38,7 @@ nested <code><fileset></code>, <code><dirset></code> and <code><f | |||||
elements.</p> | elements.</p> | ||||
<p><em>Since Ant 1.7</em>, this task supports | <p><em>Since Ant 1.7</em>, this task supports | ||||
arbitrary <a href="../Types/resources.html#collection">Resource Collection</a>s as nested | |||||
arbitrary <a href="../Types/resources.html#collection">resource collections</a> as nested | |||||
elements.</p> | elements.</p> | ||||
<p>By default this task will use a single invocation of the underlying <code>chgrp</code> command. | <p>By default this task will use a single invocation of the underlying <code>chgrp</code> command. | ||||
@@ -41,7 +41,7 @@ elements.</p> | |||||
nested <a href="../Types/filelist.html">filelist</a>s.</p> | nested <a href="../Types/filelist.html">filelist</a>s.</p> | ||||
<p><em>Since Ant 1.7</em>, this task supports | <p><em>Since Ant 1.7</em>, this task supports | ||||
arbitrary <a href="../Types/resources.html#collection">Resource Collection</a>s as nested | |||||
arbitrary <a href="../Types/resources.html#collection">resource collections</a> as nested | |||||
elements.</p> | elements.</p> | ||||
<p>By default this task will use a single invocation of the underlying <code>chmod</code> command. | <p>By default this task will use a single invocation of the underlying <code>chmod</code> command. | ||||
@@ -38,7 +38,7 @@ nested <code><fileset></code>, <code><dirset></code> and <code><f | |||||
elements.</p> | elements.</p> | ||||
<p><em>Since Ant 1.7</em>, this task supports | <p><em>Since Ant 1.7</em>, this task supports | ||||
arbitrary <a href="../Types/resources.html#collection">Resource Collection</a>s as nested | |||||
arbitrary <a href="../Types/resources.html#collection">resource collections</a> as nested | |||||
elements.</p> | elements.</p> | ||||
<p>By default this task will use a single invocation of the underlying <code>chown</code> command. | <p>By default this task will use a single invocation of the underlying <code>chown</code> command. | ||||
@@ -33,12 +33,12 @@ | |||||
list is empty and <var>ignoreempty</var> is <q>true</q>.</p> | list is empty and <var>ignoreempty</var> is <q>true</q>.</p> | ||||
<p><em>Since Apache Ant 1.7.1</em>, this task can be used as | <p><em>Since Apache Ant 1.7.1</em>, this task can be used as | ||||
a <a href="../Types/resources.html#collection">Resource Collection</a> that will return | |||||
a <a href="../Types/resources.html#collection">resource collection</a> that will return | |||||
exactly one <a href="../Types/resources.html">resource</a>.</p> | exactly one <a href="../Types/resources.html">resource</a>.</p> | ||||
<p><a href="../Types/resources.html#collection">Resource Collection</a>s are used to select | |||||
<p><a href="../Types/resources.html#collection">Resource collections</a> are used to select | |||||
which resources are to be concatenated. There is no singular attribute to specify a single | which resources are to be concatenated. There is no singular attribute to specify a single | ||||
resource to <code>cat</code>.</p> | |||||
resource to <code>concat</code>.</p> | |||||
<h3>Parameters</h3> | <h3>Parameters</h3> | ||||
@@ -141,15 +141,15 @@ | |||||
</table> | </table> | ||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>Resource Collection</h4> | |||||
<h4>resource collection</h4> | |||||
<p><em>Since Ant 1.7</em>.</p> | <p><em>Since Ant 1.7</em>.</p> | ||||
<p>Any of the various <a href="../Types/resources.html#collection">Resource Collection</a> types | |||||
<p>Any of the various <a href="../Types/resources.html#collection">resource collection</a> types | |||||
can specify the resources to be concatenated.</p> | can specify the resources to be concatenated.</p> | ||||
<h4>filterchain</h4> | <h4>filterchain</h4> | ||||
<p><em>Since Ant 1.6</em>.</p> | <p><em>Since Ant 1.6</em>.</p> | ||||
<p>The concat task supports nested <a href="../Types/filterchain.html">FilterChain</a>s.</p> | |||||
<p>The task supports nested <a href="../Types/filterchain.html">FilterChain</a>s.</p> | |||||
<h4>header, footer</h4> | <h4>header, footer</h4> | ||||
<p><em>Since Ant 1.6</em>.</p> | <p><em>Since Ant 1.6</em>.</p> | ||||
@@ -30,7 +30,7 @@ | |||||
copied if the source file is newer than the destination file, or when the destination file does not | copied if the source file is newer than the destination file, or when the destination file does not | ||||
exist. However, you can explicitly overwrite files with the <var>overwrite</var> attribute.</p> | exist. However, you can explicitly overwrite files with the <var>overwrite</var> attribute.</p> | ||||
<p><a href="../Types/resources.html#collection">Resource Collection</a>s are used to select a group | |||||
<p><a href="../Types/resources.html#collection">Resource collections</a> are used to select a group | |||||
of files to copy. To use a resource collection, the <var>todir</var> attribute must be | of files to copy. To use a resource collection, the <var>todir</var> attribute must be | ||||
set. <strong>Note</strong> that some resources (for example | set. <strong>Note</strong> that some resources (for example | ||||
the <a href="../Types/resources.html#file">file</a> resource) return absolute paths as names and the | the <a href="../Types/resources.html#file">file</a> resource) return absolute paths as names and the | ||||
@@ -152,8 +152,8 @@ note</a></em>.</p> | |||||
</table> | </table> | ||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>fileset or any other resource collection</h4> | |||||
<p><a href="../Types/resources.html#collection">Resource Collection</a>s are used to select groups | |||||
<h4>any filesystem based resource collection</h4> | |||||
<p><a href="../Types/resources.html#collection">Resource collections</a> are used to select groups | |||||
of files to copy. To use a resource collection, the <var>todir</var> attribute must be set.</p> | of files to copy. To use a resource collection, the <var>todir</var> attribute must be set.</p> | ||||
<p>Prior to Ant 1.7, only <code><fileset></code> has been supported as a nested element.</p> | <p>Prior to Ant 1.7, only <code><fileset></code> has been supported as a nested element.</p> | ||||
@@ -34,7 +34,7 @@ A task to manage arbitrary dependencies between resources. | |||||
the sources has been modified more recently than any of the target files, all of the target files | the sources has been modified more recently than any of the target files, all of the target files | ||||
are removed.</p> | are removed.</p> | ||||
<p>Sources and target files are specified via | <p>Sources and target files are specified via | ||||
nested <a href="../Types/resources.html#collection">Resource Collection</a>s; sources can be | |||||
nested <a href="../Types/resources.html#collection">resource collections</a>; sources can be | |||||
resources of any type, while targets are restricted to files only. At least one set of sources and | resources of any type, while targets are restricted to files only. At least one set of sources and | ||||
one set of targets is required.</p> | one set of targets is required.</p> | ||||
<p>Use a FileSet when you want to use wildcard include or exclude patterns and don't care about | <p>Use a FileSet when you want to use wildcard include or exclude patterns and don't care about | ||||
@@ -62,7 +62,7 @@ well as other stylesheets imported by the main stylesheet.</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Parameters Specified as Nested Elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<h4>sources</h4> | <h4>sources</h4> | ||||
@@ -244,7 +244,7 @@ attribute to a value other than its default, <q>add</q>.</strong></p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Nested elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<h4>metainf</h4> | <h4>metainf</h4> | ||||
<p>The nested <code>metainf</code> element specifies | <p>The nested <code>metainf</code> element specifies | ||||
@@ -391,9 +391,9 @@ stopped.</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Nested Elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<p>The wlrun task supports nested <code><classpath></code> | |||||
<p>The <code>wlrun</code> task supports nested <code><classpath></code> | |||||
and <code><wlclasspath></code> elements to set the respective classpaths.</p> | and <code><wlclasspath></code> elements to set the respective classpaths.</p> | ||||
<h3>Examples</h3> | <h3>Examples</h3> | ||||
@@ -473,7 +473,7 @@ the <var>BEAHome</var> to have this task work correctly under 6.0</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Nested Element</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<p>The classpath of the <code>wlstop</code> task can be set by a <code><classpath></code> | <p>The classpath of the <code>wlstop</code> task can be set by a <code><classpath></code> | ||||
nested element.</p> | nested element.</p> | ||||
@@ -711,7 +711,7 @@ not, <code>ejbjar</code> will drop back to the behaviour corresponding to the va | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Nested Elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<p>In addition to the vendor specific nested elements, the <code>ejbjar</code> task provides three | <p>In addition to the vendor specific nested elements, the <code>ejbjar</code> task provides three | ||||
nested elements.</p> | nested elements.</p> | ||||
@@ -134,7 +134,7 @@ the request is relayed to the proxy.</p> | |||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>any resource collection</h4> | <h4>any resource collection</h4> | ||||
<p><a href="../Types/resources.html#collection">Resource Collection</a>s are used to select groups | |||||
<p><a href="../Types/resources.html#collection">resource collections</a> are used to select groups | |||||
of URLs to download. If the collection contains more than one resource, the <var>dest</var> | of URLs to download. If the collection contains more than one resource, the <var>dest</var> | ||||
attribute must point to a directory if it exists or a directory will be created if it doesn't exist. | attribute must point to a directory if it exists or a directory will be created if it doesn't exist. | ||||
The destination file name use the last part of the path of the source URL unless you also specify a | The destination file name use the last part of the path of the source URL unless you also specify a | ||||
@@ -89,7 +89,7 @@ the <code>input</code> task.</p> | |||||
<td>No</td> | <td>No</td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Parameters Specified as Nested Elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<h4>Handler</h4> | <h4>Handler</h4> | ||||
<p><em>Since Ant 1.7</em>, a nested <code><handler></code> element can be used to specify | <p><em>Since Ant 1.7</em>, a nested <code><handler></code> element can be used to specify | ||||
an <code>InputHandler</code>, so that different <code>InputHandler</code>s may be used among | an <code>InputHandler</code>, so that different <code>InputHandler</code>s may be used among | ||||
@@ -308,7 +308,7 @@ e.g. decreasing the size by deleting 'same' classes from the versions-branches, | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Nested elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<h4>metainf</h4> | <h4>metainf</h4> | ||||
<p>The nested <code>metainf</code> element specifies | <p>The nested <code>metainf</code> element specifies | ||||
a <a href="../Types/fileset.html">FileSet</a>. All files included in this fileset will end up in | a <a href="../Types/fileset.html">FileSet</a>. All files included in this fileset will end up in | ||||
@@ -101,7 +101,7 @@ default the task writes its report to the standard output.</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3 id="nested">Nested Elements</h3> | |||||
<h3 id="nested">Parameters specified as nested elements</h3> | |||||
<p><code>jdepend</code> supports four nested | <p><code>jdepend</code> supports four nested | ||||
elements: <code><classpath></code>, <code><classespath></code> | elements: <code><classpath></code>, <code><classespath></code> | ||||
@@ -223,7 +223,7 @@ the following string patterns:</p> | |||||
"junit.framework.JUnit4TestAdapter" | "junit.framework.JUnit4TestAdapter" | ||||
" more"</pre> | " more"</pre> | ||||
<h3 id="nested">Nested Elements</h3> | |||||
<h3 id="nested">Parameters specified as nested elements</h3> | |||||
<p>The <code><junit></code> task supports a nested <code><classpath></code> element that | <p>The <code><junit></code> task supports a nested <code><classpath></code> element that | ||||
represents a <a href="../using.html#path">PATH like structure</a>.</p> | represents a <a href="../using.html#path">PATH like structure</a>.</p> | ||||
@@ -498,11 +498,11 @@ to <samp><i>java-tmp-dir</i>/FailedTests</samp>.</p> | |||||
<p>Define a number of tests based on pattern matching.</p> | <p>Define a number of tests based on pattern matching.</p> | ||||
<p><code>batchtest</code> collects the included <a href="../Types/resources.html">resources</a> from | <p><code>batchtest</code> collects the included <a href="../Types/resources.html">resources</a> from | ||||
any number of nested <a href="../Types/resources.html#collection">Resource Collection</a>s. It then | |||||
any number of nested <a href="../Types/resources.html#collection">resource collections</a>. It then | |||||
generates a test class name for each resource that ends in <samp>.java</samp> | generates a test class name for each resource that ends in <samp>.java</samp> | ||||
or <samp>.class</samp>.</p> | or <samp>.class</samp>.</p> | ||||
<p>Any type of Resource Collection is supported as a nested element, prior to Ant 1.7 | |||||
<p>Any type of resource collection is supported as a nested element, prior to Ant 1.7 | |||||
only <code><fileset></code> has been supported.</p> | only <code><fileset></code> has been supported.</p> | ||||
<table class="attr"> | <table class="attr"> | ||||
@@ -72,7 +72,7 @@ for quite some time.</p> | |||||
<td>No; defaults to current directory</td> | <td>No; defaults to current directory</td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3 id="nested">Nested Elements</h3> | |||||
<h3 id="nested">Parameters specified as nested elements</h3> | |||||
<h4>fileset</h4> | <h4>fileset</h4> | ||||
<p><code>junitreport</code> collects individual xml files generated by the <code>JUnit</code> task | <p><code>junitreport</code> collects individual xml files generated by the <code>JUnit</code> task | ||||
using the nested <a href="../Types/fileset.html"><code><FileSet></code></a> element.</p> | using the nested <a href="../Types/fileset.html"><code><FileSet></code></a> element.</p> | ||||
@@ -28,7 +28,7 @@ | |||||
<p><em>Since Apache Ant 1.6.3</em></p> | <p><em>Since Apache Ant 1.6.3</em></p> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
<p>Display or set a property containing length information for a string, a file, or one or more | <p>Display or set a property containing length information for a string, a file, or one or more | ||||
nested <a href="../Types/resources.html#collection">Resource Collection</a>s. Can also be used as | |||||
nested <a href="../Types/resources.html#collection">resource collections</a>. Can also be used as | |||||
a <code>condition</code>.</p> | a <code>condition</code>.</p> | ||||
<h3>Parameters</h3> | <h3>Parameters</h3> | ||||
<table class="attr"> | <table class="attr"> | ||||
@@ -94,9 +94,9 @@ a <code>condition</code>.</p> | |||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>Resource Collections</h4> | |||||
<p>You can include resources via nested <a href="../Types/resources.html#collection">Resource | |||||
Collection</a>s.</p> | |||||
<h4>resource collections</h4> | |||||
<p>You can include resources via nested <a href="../Types/resources.html#collection">resource | |||||
collection</a>s.</p> | |||||
<h3>Examples</h3> | <h3>Examples</h3> | ||||
@@ -89,7 +89,7 @@ the JAR, feeding in the hand-crafted manifest.</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Nested elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<h4 id="attribute">attribute</h4> | <h4 id="attribute">attribute</h4> | ||||
<p>One attribute for the manifest file. Those attributes that are not nested into a section will be | <p>One attribute for the manifest file. Those attributes that are not nested into a section will be | ||||
added to the main section.</p> | added to the main section.</p> | ||||
@@ -31,7 +31,7 @@ the destination file is overwritten if it already exists. When <var>overwrite</ | |||||
then files are only moved if the source file is newer than the destination file, or when the | then files are only moved if the source file is newer than the destination file, or when the | ||||
destination file does not exist.</p> | destination file does not exist.</p> | ||||
<p><a href="../Types/resources.html#collection">Resource Collection</a>s are used to select a group | |||||
<p><a href="../Types/resources.html#collection">resource collections</a> are used to select a group | |||||
of files to move. Only file system based resource collections are supported, this | of files to move. Only file system based resource collections are supported, this | ||||
includes <a href="../Types/fileset.html">fileset</a>s, <a href="../Types/filelist.html">filelist</a> | includes <a href="../Types/fileset.html">fileset</a>s, <a href="../Types/filelist.html">filelist</a> | ||||
and <a href="../using.html#path">path</a>. Prior to Apache Ant 1.7 | and <a href="../using.html#path">path</a>. Prior to Apache Ant 1.7 | ||||
@@ -55,6 +55,7 @@ See <a href="../install.html#librarydependencies">Library Dependencies</a> for m | |||||
<td class="left"><em><u>deprecated</u></em> old name of <var>destfile</var>.</td> | <td class="left"><em><u>deprecated</u></em> old name of <var>destfile</var>.</td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Parameters specified as nested elements</h3> | |||||
<h4>any <a href="../Types/resources.html">resource</a> or single element resource collection</h4> | <h4>any <a href="../Types/resources.html">resource</a> or single element resource collection</h4> | ||||
<p><em>Since Apache Ant 1.7</em></p> | <p><em>Since Apache Ant 1.7</em></p> | ||||
<p>The specified resource will be used as <var>src</var>.</p> | <p>The specified resource will be used as <var>src</var>.</p> | ||||
@@ -26,9 +26,9 @@ | |||||
<h2 id="pathconvert">Pathconvert</h2> | <h2 id="pathconvert">Pathconvert</h2> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
<p>Converts nested <a href="../Types/resources.html#collection"> ResourceCollection</a>s, or a | |||||
<p>Converts nested <a href="../Types/resources.html#collection">resource collections</a>, or a | |||||
reference to just one, into a path form for a particular platform, optionally storing the result | reference to just one, into a path form for a particular platform, optionally storing the result | ||||
into a given property. It can also be used when you need to convert a Resource Collection into a | |||||
into a given property. It can also be used when you need to convert a resource collection into a | |||||
list, separated by a given character, such as a comma or space, or, conversely, e.g. to convert a | list, separated by a given character, such as a comma or space, or, conversely, e.g. to convert a | ||||
list of files in a FileList into a path.</p> | list of files in a FileList into a path.</p> | ||||
<p>Nested <code><map></code> elements can be specified to map Windows drive letters to Unix | <p>Nested <code><map></code> elements can be specified to map Windows drive letters to Unix | ||||
@@ -114,9 +114,9 @@ being processed. If no map entries are specified, then no path prefix mapping i | |||||
<p><strong>Note</strong>: The map elements are applied in the order specified, and only the first | <p><strong>Note</strong>: The map elements are applied in the order specified, and only the first | ||||
matching map element is applied. So, the ordering of your map elements can be important, if | matching map element is applied. So, the ordering of your map elements can be important, if | ||||
any <var>from</var> values are prefixes of other <var>from</var> values.</p> | any <var>from</var> values are prefixes of other <var>from</var> values.</p> | ||||
<h4>Resource Collections</h4> | |||||
<h4>resource collections</h4> | |||||
<p>If the <var>refid</var> attribute is not specified, then one or more | <p>If the <var>refid</var> attribute is not specified, then one or more | ||||
nested <a href="../Types/resources.html#collection">Resource Collection</a>s must be supplied.</p> | |||||
nested <a href="../Types/resources.html#collection">resource collections</a> must be supplied.</p> | |||||
<h4>mapper</h4> | <h4>mapper</h4> | ||||
<p>A single nested <a href="../Types/mapper.html"> <code><mapper></code></a> element can be | <p>A single nested <a href="../Types/mapper.html"> <code><mapper></code></a> element can be | ||||
specified to perform any of various filename transformations (<em>since Ant 1.6.2</em>).</p> | specified to perform any of various filename transformations (<em>since Ant 1.6.2</em>).</p> | ||||
@@ -158,10 +158,10 @@ the repository.</p> | |||||
<td>No</td> | <td>No</td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3 id="nested">Nested Elements</h3> | |||||
<h3 id="nested">Parameters specified as nested elements</h3> | |||||
<h4>pvcsproject element</h4> | <h4>pvcsproject element</h4> | ||||
<p><code>pvcs</code> supports a nested <code><pvcsproject></code> element, that represents a | |||||
<p>The task supports a nested <code><pvcsproject></code> element, that represents a | |||||
project within the PVCS repository to extract files from. By nesting | project within the PVCS repository to extract files from. By nesting | ||||
multiple <code><pvcsproject></code> elements under the <code><pvcs></code> task, | multiple <code><pvcsproject></code> elements under the <code><pvcs></code> task, | ||||
multiple projects can be specified.</p> | multiple projects can be specified.</p> | ||||
@@ -113,7 +113,7 @@ datatype instance.</p> | |||||
<regexp id="id" pattern="alpha(.+)beta"/> | <regexp id="id" pattern="alpha(.+)beta"/> | ||||
<regexp refid="id"/></pre> | <regexp refid="id"/></pre> | ||||
<p>This task supports a nested <code>Substitution</code> element to specify the substitution | |||||
<p>This task supports a nested <code>substitution</code> element to specify the substitution | |||||
pattern. You can use this element to refer to a previously defined substitution pattern datatype | pattern. You can use this element to refer to a previously defined substitution pattern datatype | ||||
instance.</p> | instance.</p> | ||||
@@ -28,8 +28,8 @@ | |||||
<p><em>Since Apache Ant 1.7</em></p> | <p><em>Since Apache Ant 1.7</em></p> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
<p>Display or set a property containing the size of a | <p>Display or set a property containing the size of a | ||||
nested <a href="../Types/resources.html#collection">Resource Collection</a>. Can also be used as a | |||||
condition.</p> | |||||
nested <a href="../Types/resources.html#collection">resource collection</a>. Can also be used as | |||||
a <code>condition</code>.</p> | |||||
<h3>Parameters</h3> | <h3>Parameters</h3> | ||||
<table class="attr"> | <table class="attr"> | ||||
<tr> | <tr> | ||||
@@ -49,8 +49,8 @@ condition.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>refid</td> | <td>refid</td> | ||||
<td>A <a href="../using.html#references">reference</a> to a Resource Collection.</td> | |||||
<td colspan="2">Yes, unless a nested Resource Collection is supplied</td> | |||||
<td>A <a href="../using.html#references">reference</a> to a resource collection.</td> | |||||
<td colspan="2">Yes, unless a nested resource collection is supplied</td> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>count</td> | <td>count</td> | ||||
@@ -69,8 +69,8 @@ condition.</p> | |||||
</table> | </table> | ||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>Resource Collection</h4> | |||||
<p>A single <a href="../Types/resources.html#collection">Resource Collection</a> should be specified | |||||
<h4>resource collection</h4> | |||||
<p>A single <a href="../Types/resources.html#collection">resource collection</a> should be specified | |||||
via a nested element or the <var>refid</var> attribute.</p> | via a nested element or the <var>refid</var> attribute.</p> | ||||
<h3>Examples</h3> | <h3>Examples</h3> | ||||
@@ -77,7 +77,7 @@ attribute, you must use the <var>username</var> and <var>password</var> attribut | |||||
<td>No; default is no timeout</td> | <td>No; default is no timeout</td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3 id="nested">Nested Elements</h3> | |||||
<h3 id="nested">Parameters specified as nested elements</h3> | |||||
<p>The input to send to the server, and responses to wait for, are described as nested elements.</p> | <p>The input to send to the server, and responses to wait for, are described as nested elements.</p> | ||||
<h4>read</h4> | <h4>read</h4> | ||||
@@ -117,7 +117,7 @@ their URL equivalents.</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3 id="nested">Nested Elements</h3> | |||||
<h3 id="nested">Parameters specified as nested elements</h3> | |||||
<h4>schema</h4> | <h4>schema</h4> | ||||
<p>Identify the name and location of a schema that may be used in validating the document(s).</p> | <p>Identify the name and location of a schema that may be used in validating the document(s).</p> | ||||
@@ -201,9 +201,9 @@ information. This task has been tested with <code>jsch-0.1.2</code> and later.< | |||||
</table> | </table> | ||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>fileset or resource collections</h4> | |||||
<h4>resource collections</h4> | |||||
<p><a href="../Types/fileset.html">FileSet</a>s | <p><a href="../Types/fileset.html">FileSet</a>s | ||||
or <a href="../Types/resources.html#collection">Resource Collection</a>s are used to select groups | |||||
or other <a href="../Types/resources.html#collection">resource collections</a> are used to select groups | |||||
of files to copy. To use a fileset or a resource collection, the <var>todir</var> attribute must be | of files to copy. To use a fileset or a resource collection, the <var>todir</var> attribute must be | ||||
set.</p> | set.</p> | ||||
@@ -134,7 +134,7 @@ task.</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Nested elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<h4>attribute</h4> | <h4>attribute</h4> | ||||
<table class="attr"> | <table class="attr"> | ||||
<tr> | <tr> | ||||
@@ -84,7 +84,7 @@ which attributes are required, depending on the tool.</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Nested Elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<p>The <code>serverdeploy</code> task supports a nested <code>classpath</code> element to set the | <p>The <code>serverdeploy</code> task supports a nested <code>classpath</code> element to set the | ||||
classpath.</p> | classpath.</p> | ||||
@@ -77,7 +77,7 @@ different sets of permissions to apply to either type of resource.</p> | |||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>any resource collection</h4> | <h4>any resource collection</h4> | ||||
<p><a href="../Types/resources.html#collection">Resource Collection</a>s are used to select groups | |||||
<p><a href="../Types/resources.html#collection">resource collections</a> are used to select groups | |||||
of resources.</p> | of resources.</p> | ||||
<h3>Examples</h3> | <h3>Examples</h3> | ||||
<pre> | <pre> | ||||
@@ -38,13 +38,13 @@ executed.</p> | |||||
<p>Unless you are running on Java 1.3 or later, you need the Java Media Framework on the classpath | <p>Unless you are running on Java 1.3 or later, you need the Java Media Framework on the classpath | ||||
(<code>javax.sound</code>).</p> | (<code>javax.sound</code>).</p> | ||||
<h3>Nested Elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<h4>success</h4> | <h4>success</h4> | ||||
<p>Specifies the sound to be played if the build succeeded.</p> | <p>Specifies the sound to be played if the build succeeded.</p> | ||||
<h4>fail</h4> | <h4>fail</h4> | ||||
<p>Specifies the sound to be played if the build failed.</p> | <p>Specifies the sound to be played if the build failed.</p> | ||||
<h3>Nested Element Parameters</h3> | |||||
<h3>Nested element parameters</h3> | |||||
<p>The following attributes may be used on the <code><success></code> | <p>The following attributes may be used on the <code><success></code> | ||||
and <code><fail></code> elements:</p> | and <code><fail></code> elements:</p> | ||||
<table class="attr"> | <table class="attr"> | ||||
@@ -58,7 +58,7 @@ parent directory has been matched. If this behavior is not what you want, set | |||||
the <var>scanincludedirectories</var> attribute to false.</p> | the <var>scanincludedirectories</var> attribute to false.</p> | ||||
<p><em>Since Ant 1.7</em>, this task supports | <p><em>Since Ant 1.7</em>, this task supports | ||||
nested <a href="../Types/resources.html#collection">resource collection</a>s in addition to (or | |||||
nested <a href="../Types/resources.html#collection">resource collections</a> in addition to (or | |||||
instead of, depending on the <var>useImplicitFileset</var> attribute) the implicit fileset formed by | instead of, depending on the <var>useImplicitFileset</var> attribute) the implicit fileset formed by | ||||
this task.</p> | this task.</p> | ||||
@@ -29,7 +29,7 @@ | |||||
<h3>Description</h3> | <h3>Description</h3> | ||||
<p>Synchronize a target directory from the files defined in one or | <p>Synchronize a target directory from the files defined in one or | ||||
more <a href="../Types/resources.html#collection">Resource Collection</a>s.</p> | |||||
more <a href="../Types/resources.html#collection">resource collections</a>.</p> | |||||
<p>Any file in the target directory that has not been matched by at least one of the nested resource | <p>Any file in the target directory that has not been matched by at least one of the nested resource | ||||
collections gets removed. I.e. if you exclude a file in your sources and a file of that name is | collections gets removed. I.e. if you exclude a file in your sources and a file of that name is | ||||
@@ -85,8 +85,8 @@ present in the target dir, it will get removed from the target.</p> | |||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>fileset or any other resource collection</h4> | |||||
<p><a href="../Types/resources.html#collection">Resource Collection</a>s are used to select groups | |||||
<h4>any resource collection</h4> | |||||
<p><a href="../Types/resources.html#collection">resource collections</a> are used to select groups | |||||
of files to copy.</p> | of files to copy.</p> | ||||
<p>Prior to Ant 1.7 only <code><fileset></code> has been supported as a nested element.</p> | <p>Prior to Ant 1.7 only <code><fileset></code> has been supported as a nested element.</p> | ||||
@@ -137,9 +137,9 @@ to <q>gzip</q>, <q>bzip2</q>, or <q>xz</q>.</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Nested Elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<p>The tar task supports nested <a href="../Types/tarfileset.html">tarfileset</a> elements. These | |||||
<p>The task supports nested <a href="../Types/tarfileset.html">tarfileset</a> elements. These | |||||
are extended <a href="../Types/fileset.html">FileSets</a> which, in addition to the standard | are extended <a href="../Types/fileset.html">FileSets</a> which, in addition to the standard | ||||
elements, support one additional attributes</p> | elements, support one additional attributes</p> | ||||
@@ -157,7 +157,7 @@ elements, support one additional attributes</p> | |||||
</table> | </table> | ||||
<h4>any other resource collection</h4> | <h4>any other resource collection</h4> | ||||
<p><a href="../Types/resources.html#collection">Resource Collection</a>s are used to select groups | |||||
<p><a href="../Types/resources.html#collection">resource collections</a> are used to select groups | |||||
of files to archive.</p> | of files to archive.</p> | ||||
<p>Prior to Apache Ant 1.7 only <code><fileset></code> has been supported as a nested | <p>Prior to Apache Ant 1.7 only <code><fileset></code> has been supported as a nested | ||||
element.</p> | element.</p> | ||||
@@ -73,7 +73,7 @@ information.</p> | |||||
<td>No; default is no timeout</td> | <td>No; default is no timeout</td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3 id="nested">Nested Elements</h3> | |||||
<h3 id="nested">Parameters specified as nested elements</h3> | |||||
<p>The commands to send to the server, and responses to wait for, are described as nested | <p>The commands to send to the server, and responses to wait for, are described as nested | ||||
elements.</p> | elements.</p> | ||||
@@ -58,8 +58,8 @@ ignored.</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Nested Elements</h3> | |||||
<p>The <code>Tstamp</code> task supports a <code><format></code> nested element that allows a | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<p>The task supports a <code><format></code> nested element that allows a | |||||
property to be set to the current date and time in a given format. The date/time patterns are as | property to be set to the current date and time in a given format. The date/time patterns are as | ||||
defined in the | defined in the | ||||
Java <a href="https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html">SimpleDateFormat</a> | Java <a href="https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html">SimpleDateFormat</a> | ||||
@@ -30,7 +30,7 @@ | |||||
<p><a href="../Types/patternset.html">PatternSet</a>s are used to select files to | <p><a href="../Types/patternset.html">PatternSet</a>s are used to select files to | ||||
extract <em>from</em> the archive. If no patternset is used, all files are extracted.</p> | extract <em>from</em> the archive. If no patternset is used, all files are extracted.</p> | ||||
<p><a href="../Types/resources.html#collection">Resource Collection</a>s may be used to select | |||||
<p><a href="../Types/resources.html#collection">resource collections</a> may be used to select | |||||
archived files to perform unarchival upon. Only file system based resource collections are | archived files to perform unarchival upon. Only file system based resource collections are | ||||
supported by <code>Unjar</code>/<code>Unwar</code>/<code>Unzip</code>, this | supported by <code>Unjar</code>/<code>Unwar</code>/<code>Unzip</code>, this | ||||
includes <a href="../Types/fileset.html">fileset</a>, <a href="../Types/filelist.html">filelist</a>, <a href="../using.html#path">path</a>, | includes <a href="../Types/fileset.html">fileset</a>, <a href="../Types/filelist.html">filelist</a>, <a href="../using.html#path">path</a>, | ||||
@@ -89,7 +89,7 @@ if the condition didn't come true within the specified time.</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3 id="nested">Nested Elements</h3> | |||||
<h3 id="nested">Parameters specified as nested elements</h3> | |||||
<p>The available conditions that satisfy the <code><waitfor></code> task are the same as those | <p>The available conditions that satisfy the <code><waitfor></code> task are the same as those | ||||
for the <a href="condition.html"><code><condition></code></a> | for the <a href="condition.html"><code><condition></code></a> | ||||
task. See <a href="conditions.html">here</a> for the full list.</p> | task. See <a href="conditions.html">here</a> for the full list.</p> | ||||
@@ -243,7 +243,7 @@ attribute to a value other than its default, <q>add</q>.</strong></p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3>Nested elements</h3> | |||||
<h3>Parameters specified as nested elements</h3> | |||||
<h4>lib</h4> | <h4>lib</h4> | ||||
<p>The nested <code>lib</code> element specifies a <a href="../Types/fileset.html">FileSet</a>. All | <p>The nested <code>lib</code> element specifies a <a href="../Types/fileset.html">FileSet</a>. All | ||||
@@ -132,7 +132,7 @@ the input XML file is loaded:/p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3 id="nested">Nested Elements</h3> | |||||
<h3 id="nested">Parameters specified as nested elements</h3> | |||||
<h4>xmlcatalog</h4> | <h4>xmlcatalog</h4> | ||||
<p>The <a href="../Types/xmlcatalog.html"><code><xmlcatalog></code></a> element is used to | <p>The <a href="../Types/xmlcatalog.html"><code><xmlcatalog></code></a> element is used to | ||||
perform entity resolution.</p> | perform entity resolution.</p> | ||||
@@ -91,7 +91,7 @@ of <code>xmlvalidate</code>, this warning may not apply.</p> | |||||
</tr> | </tr> | ||||
</table> | </table> | ||||
<h3 id="nested">Nested Elements</h3> | |||||
<h3 id="nested">Parameters specified as nested elements</h3> | |||||
<h4>dtd</h4> | <h4>dtd</h4> | ||||
<p><code><dtd></code> is used to specify different locations for DTD resolution.</p> | <p><code><dtd></code> is used to specify different locations for DTD resolution.</p> | ||||
<table class="attr"> | <table class="attr"> | ||||
@@ -383,7 +383,7 @@ read without problems with Java 6 and later.</p> | |||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>any resource collection</h4> | <h4>any resource collection</h4> | ||||
<p><a href="../Types/resources.html#collection">Resource Collection</a>s are used to select groups | |||||
<p><a href="../Types/resources.html#collection">resource collections</a> are used to select groups | |||||
of files to archive.</p> | of files to archive.</p> | ||||
<p>Prior to Ant 1.7 only <code><fileset></code> and <code><zipfileset></code> have been | <p>Prior to Ant 1.7 only <code><fileset></code> and <code><zipfileset></code> have been | ||||
supported as nested elements.</p> | supported as nested elements.</p> | ||||
@@ -57,8 +57,8 @@ The built-in resource types are: | |||||
<p> | <p> | ||||
A basic resource. Other resource types derive from this basic type; as such all its attributes | A basic resource. Other resource types derive from this basic type; as such all its attributes | ||||
are available, though in most cases irrelevant attributes will be ignored. This and all resource | are available, though in most cases irrelevant attributes will be ignored. This and all resource | ||||
implementations are also usable as single-element <a href="#collection">Resource | |||||
Collections</a>. | |||||
implementations are also usable as single-element <a href="#collection">resource | |||||
collections</a>. | |||||
</p> | </p> | ||||
<table class="attr"> | <table class="attr"> | ||||
@@ -360,9 +360,9 @@ attribute is unset:</p> | |||||
<hr/> | <hr/> | ||||
<h2 id="collection">Resource Collections</h2> | <h2 id="collection">Resource Collections</h2> | ||||
<p> | <p> | ||||
A Resource Collection is an abstraction of an entity that groups together a number | |||||
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 | of <a href="#resource">resources</a>. Several of Ant's "legacy" datatypes have been modified to | ||||
behave as Resource Collections: | |||||
behave as resource collections: | |||||
</p> | </p> | ||||
<ul> | <ul> | ||||
<li><a href="fileset.html">fileset</a>, | <li><a href="fileset.html">fileset</a>, | ||||
@@ -426,7 +426,7 @@ The additional built-in resource collections are: | |||||
<p> | <p> | ||||
A generic resource collection, designed for use | A generic resource collection, designed for use | ||||
with <a href="../using.html#references">references</a>. For example, if a third-party Ant task | with <a href="../using.html#references">references</a>. For example, if a third-party Ant task | ||||
generates a Resource Collection of an unknown type, it can still be accessed via | |||||
generates a resource collection of an unknown type, it can still be accessed via | |||||
a <code><resources></code> collection. The secondary use of this collection type is as a | a <code><resources></code> collection. The secondary use of this collection type is as a | ||||
container of other resource collections, preserving the order of nested collections as well as | container of other resource collections, preserving the order of nested collections as well as | ||||
duplicate resources (contrast with <a href="#union">union</a>). | duplicate resources (contrast with <a href="#union">union</a>). | ||||
@@ -275,7 +275,7 @@ supports <var>path</var> and | |||||
<p>can be abbreviated to:</p> | <p>can be abbreviated to:</p> | ||||
<pre><classpath path="${classpath}"/></pre> | <pre><classpath path="${classpath}"/></pre> | ||||
<p>In addition, one or more | <p>In addition, one or more | ||||
<a href="Types/resources.html#collection">Resource Collection</a>s | |||||
<a href="Types/resources.html#collection">resource collections</a> | |||||
can be specified as nested elements (these must consist of | can be specified as nested elements (these must consist of | ||||
<a href="Types/resources.html#file">file</a>-type resources only). | <a href="Types/resources.html#file">file</a>-type resources only). | ||||
Additionally, it should be noted that although resource collections are | Additionally, it should be noted that although resource collections are | ||||