@@ -154,12 +154,13 @@ their <var>id</var>.</p> | |||
<h4>propertyset</h4> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<p>You can specify a set of properties to be copied into the new project | |||
with <a href="../Types/propertyset.html">propertyset</a>s.</p> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<h4>target</h4> | |||
<p><em>Since Ant 1.6.3</em>.</p> | |||
<p>You can specify multiple targets using nested <code><target></code> elements instead of | |||
using the <var>target</var> attribute. These will be executed as if Ant had been invoked with a | |||
@@ -176,7 +177,6 @@ single target whose dependencies are the targets so specified, in the order spec | |||
<td>Yes</td> | |||
</tr> | |||
</table> | |||
<p><em>since Ant 1.6.3</em>.</p> | |||
<h3>Basedir of the new project</h3> | |||
@@ -129,12 +129,13 @@ their <var>id</var>.</p> | |||
<h4>propertyset</h4> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<p>You can specify a set of properties to be copied into the new project | |||
with <a href="../Types/propertyset.html">propertyset</a>s.</p> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<h4>target</h4> | |||
<p><em>Since Ant 1.6.3</em>.</p> | |||
<p>You can specify multiple targets using nested <code><target></code> elements instead of | |||
using the <var>target</var> attribute. These will be executed as if Ant had been invoked with a | |||
@@ -151,7 +152,6 @@ single target whose dependencies are the targets so specified, in the order spec | |||
<td>Yes</td> | |||
</tr> | |||
</table> | |||
<p><em>since Ant 1.6.3</em>.</p> | |||
<h3>Examples</h3> | |||
<pre> | |||
@@ -25,10 +25,10 @@ | |||
<body> | |||
<h2 id="antversion">Antversion</h2> | |||
<p><em>Since Ant 1.7.0</em></p> | |||
<h3>Description</h3> | |||
<p>Stores the Apache Ant version (when used as task) or checks for a | |||
specific Ant version (when used as condition). <em>Since Ant | |||
1.7.0</em></p> | |||
<p>Stores the Apache Ant version (when used as task) or checks for a specific Ant version (when used | |||
as condition).</p> | |||
<table class="attr"> | |||
<tr> | |||
@@ -273,7 +273,7 @@ this task and refer to <code><filelist></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> | |||
<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> | |||
<h4>mapper</h4> | |||
@@ -25,13 +25,12 @@ | |||
<body> | |||
<h2>Augment</h2> | |||
<p><em>Since Apache Ant 1.8.1</em></p> | |||
<h3>Description</h3> | |||
<p>Modify an existing reference by adding nested elements or (re-)assigning properties mapped as XML | |||
attributes. This is an unusual task that makes use of Ant's internal processing mechanisms to reload | |||
a previously declared reference by means of the <var>id</var> attribute, then treats the | |||
declared <code>augment</code> element as though it were the original element. <em>Since Apache Ant | |||
1.8.1</em></p> | |||
declared <code>augment</code> element as though it were the original element.</p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
@@ -25,6 +25,7 @@ | |||
<body> | |||
<h2 id="ant">Bindtargets</h2> | |||
<p><em>Since Apache Ant 1.8.2</em></p> | |||
<h3>Description</h3> | |||
<p>Make some target the extension of some | |||
@@ -49,8 +50,6 @@ which will be the bridge between the target to bind and the extension point. For | |||
not be used in a target. This is making the target dependency graph static and predictable as soon | |||
as every build file is loaded.</p> | |||
<p><em>Since Apache Ant 1.8.2</em></p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
<tr> | |||
@@ -725,9 +725,9 @@ named <samp>Application_Baseline_AUTO</samp>.</p> | |||
<hr/> | |||
<h2 id="ccmkattr">CCMkattr</h2> | |||
<p><em>Since Ant 1.6.1</em></p> | |||
<h3>Description</h3> | |||
<p>Task to perform a <code>cleartool mkattr</code> command to ClearCase.<br/><em>Since Ant | |||
1.6.1</em></p> | |||
<p>Task to perform a <code>cleartool mkattr</code> command to ClearCase.</p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
<tr> | |||
@@ -794,9 +794,9 @@ the attribute <samp>BugFix</samp> with a value of <samp>34445</samp> to it.</p> | |||
<hr/> | |||
<h2 id="ccmkdir">CCMkdir</h2> | |||
<p><em>Since Ant 1.6.1</em></p> | |||
<h3>Description</h3> | |||
<p>Task to perform a <code>cleartool mkdir</code> command to ClearCase.<br/><em>Since Ant | |||
1.6.1</em></p> | |||
<p>Task to perform a <code>cleartool mkdir</code> command to ClearCase.</p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
<tr> | |||
@@ -842,9 +842,9 @@ automatically check it out.</p> | |||
<hr/> | |||
<h2 id="ccmkelem">CCMkelem</h2> | |||
<p><em>Since Ant 1.6.1</em></p> | |||
<h3>Description</h3> | |||
<p>Task to perform a <code>cleartool mkelem</code> command to ClearCase.<br/><em>Since Ant | |||
1.6.1</em></p> | |||
<p>Task to perform a <code>cleartool mkelem</code> command to ClearCase.</p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
<tr> | |||
@@ -142,17 +142,17 @@ | |||
<h3>Parameters specified as nested elements</h3> | |||
<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 | |||
can specify the resources to be concatenated.</p> | |||
<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> | |||
<h4>header, footer</h4> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<p>Used to prepend or postpend text into the concatenated stream.</p> | |||
<p>The text may be in-line or be in a file.</p> | |||
<table class="attr"> | |||
@@ -618,8 +618,9 @@ firewalls.</p> | |||
<p>Probe for the Maven repository being reachable using the hostname, ten second timeout.</p> | |||
<h4 id="length">length</h4> | |||
<p><em>Since Ant 1.6.3</em></p> | |||
<p>This condition is a facet of the <a href="length.html">Length</a> task. It is used to test the | |||
length of a string or one or more files. <em>Since Ant 1.6.3</em></p> | |||
length of a string or one or more files.</p> | |||
<pre><length string=" foo " trim="true" length="3"/></pre> | |||
<p>Verify a string is of a certain length.</p> | |||
@@ -628,9 +629,9 @@ length of a string or one or more files. <em>Since Ant 1.6.3</em></p> | |||
<p>Verify that file <samp>foo</samp> is not empty.</p> | |||
<h4 id="isfailure">isfailure</h4> | |||
<p><em>Since Ant 1.7</em></p> | |||
<p>Test the return code of an executable (see the <a href="exec.html">Exec</a> task) for | |||
failure. <em>Since Ant 1.7</em></p> | |||
failure.</p> | |||
<table class="attr"> | |||
<tr> | |||
@@ -646,21 +647,23 @@ failure. <em>Since Ant 1.7</em></p> | |||
</table> | |||
<h4 id="resourcecount">resourcecount</h4> | |||
<p><em>Since Ant 1.7</em></p> | |||
<p>This condition is a facet of the <a href="resourcecount.html">ResourceCount</a> task. It is used | |||
to test the size of a <a href="../Types/resources.html#collection">resource | |||
collection</a>. <em>Since Ant 1.7</em></p> | |||
collection</a>.</p> | |||
<pre><resourcecount refid="myresourcecollection" when="greater" count="0"/></pre> | |||
<p>Verify that a resource collection is not empty.</p> | |||
<h4 id="resourcesmatch">resourcesmatch</h4> | |||
<p><em>Since Ant 1.7</em></p> | |||
<p>Test resources for matching. Nonexistence of one or more resources results in <q>false</q>, | |||
although if none exists they are considered equal in terms of content. By default, this test does a | |||
byte for byte comparison, so test time scales with byte size. <strong>Note</strong>: if the files | |||
are different sizes, one of them is missing or the filenames match the answer is so obvious the | |||
detailed test is omitted. The resources to check are specified as | |||
nested <a href="../Types/resources.html#collection">resource collections</a>, meaning that more than | |||
two resources can be checked; in this case all resources must match. <em>Since Ant 1.7</em></p> | |||
two resources can be checked; in this case all resources must match.</p> | |||
<table class="attr"> | |||
<tr> | |||
<th>Attribute</th> | |||
@@ -676,9 +679,10 @@ two resources can be checked; in this case all resources must match. <em>Since A | |||
</table> | |||
<h4 id="resourcecontains">resourcecontains</h4> | |||
<p><em>Since Ant 1.7.1</em></p> | |||
<p>Tests whether a resource contains a given (sub)string.</p> | |||
<p>The resources to check are specified via references or—in the case of file | |||
resources—via the resource attribute. <em>Since Ant 1.7.1</em></p> | |||
resources—via the resource attribute.</p> | |||
<table class="attr"> | |||
<tr> | |||
<th>Attribute</th> | |||
@@ -707,9 +711,9 @@ resources—via the resource attribute. <em>Since Ant 1.7.1</em></p> | |||
</table> | |||
<h4 id="hasmethod">hasmethod</h4> | |||
<p><em>Since Ant 1.7</em></p> | |||
<p>Tests for a class having a method or field. If the class is not found or fails to load, the build | |||
fails. <em>Since Ant 1.7</em></p> | |||
fails.</p> | |||
<table class="attr"> | |||
<tr> | |||
@@ -754,9 +758,8 @@ classpath.</p> | |||
<p>Looks for the method <code>trimToSize()</code> in the <code>java.util.ArrayList</code> class.</p> | |||
<h4 id="matches">matches</h4> | |||
<p>Test if the specified string matches the specified regular expression pattern. <em>Since Ant | |||
1.7</em></p> | |||
<p><em>Since Ant 1.7</em></p> | |||
<p>Test if the specified string matches the specified regular expression pattern</p> | |||
<table class="attr"> | |||
<tr> | |||
@@ -839,8 +842,8 @@ flags.</p> | |||
are supported, the <var>property</var> attribute is redundant and will be ignored.</p> | |||
<h4 id="hasfreespace">hasfreespace</h4> | |||
<p>Tests a partition to see if there is enough space. <em>Since Ant 1.7.0</em></p> | |||
<p><em>Since Ant 1.7.0</em></p> | |||
<p>Tests a partition to see if there is enough space.</p> | |||
<p>Needed attribute can be specified using standard computing terms:</p> | |||
<ul> | |||
<li>K : Kilobytes (1024 bytes)</li> | |||
@@ -871,8 +874,8 @@ are supported, the <var>property</var> attribute is redundant and will be ignore | |||
<pre><hasfreespace partition="c:" needed="100M"/></pre> | |||
<h4 id="islastmodified">islastmodified</h4> | |||
<p>Tests the last modified date of a resource. <em>Since Ant 1.8.0</em></p> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>Tests the last modified date of a resource.</p> | |||
<table class="attr"> | |||
<tr> | |||
@@ -913,8 +916,8 @@ are supported, the <var>property</var> attribute is redundant and will be ignore | |||
</islastmodified></pre> | |||
<h4 id="resourceexists">resourceexists</h4> | |||
<p>Tests a resource for existence. <em>since Ant 1.8.0</em></p> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>Tests a resource for existence.</p> | |||
<p>The actual resource to test is specified as a nested element.</p> | |||
@@ -925,8 +928,8 @@ are supported, the <var>property</var> attribute is redundant and will be ignore | |||
</resourceexists></pre> | |||
<h4 id="javaversion">javaversion</h4> | |||
<p>Tests the version of the JVM executing Ant. <em>Since Ant 1.10.2</em></p> | |||
<p><em>Since Ant 1.10.2</em></p> | |||
<p>Tests the version of the JVM executing Ant.</p> | |||
<table class="attr"> | |||
<tr> | |||
@@ -25,9 +25,9 @@ | |||
<body> | |||
<h2 id="cvs">CvsVersion</h2> | |||
<p><em>Since Apache Ant 1.6.1</em>.</p> | |||
<h3>Description</h3> | |||
<p>This task allows to retrieve a CVS client and server version. <em>Since Apache Ant | |||
1.6.1</em>.</p> | |||
<p>This task allows to retrieve a CVS client and server version.</p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
<tr> | |||
@@ -24,9 +24,9 @@ | |||
<body> | |||
<h2 id="echo">DefaultExcludes</h2> | |||
<h2 id="defaultexcludes">DefaultExcludes</h2> | |||
<p><em>since Apache Ant 1.6</em></p> | |||
<p><em>Since Apache Ant 1.6</em></p> | |||
<h3>Description</h3> | |||
<p>Alters the default excludes for all subsequent processing in the build, and prints out the | |||
@@ -88,8 +88,10 @@ filelists may be specified.</p> | |||
<h4>targets</h4> | |||
<p><em>Since Ant 1.7</em></p> | |||
<p>The <code><targets></code> element is a <a href="../using.html#path">Path</a> and thus can | |||
include any filesystem-based resource. <em>Since Ant 1.7</em></p> | |||
include any filesystem-based resource.</p> | |||
<h4>targetfileset</h4> | |||
@@ -25,9 +25,10 @@ | |||
<body> | |||
<h2 id="diagnostics">Diagnostics</h2> | |||
<p><em>Since Ant 1.7.0</em></p> | |||
<h3>Description</h3> | |||
<p>Runs Apache Ant's <code>-diagnostics</code> code inside Ant itself. This is good for debugging | |||
Ant's configuration under an IDE. <em>Since Ant 1.7.0</em></p> | |||
Ant's configuration under an IDE.</p> | |||
<h3>Examples</h3> | |||
@@ -78,13 +78,13 @@ files.</p> | |||
<h4>propertyset</h4> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<p>You can specify subsets of properties to be echoed | |||
with <a href="../Types/propertyset.html">propertyset</a>s. Using <code>propertyset</code>s gives | |||
more control on which properties will be picked up. The attributes <var>prefix</var> | |||
and <var>regex</var> are just shortcuts that use <code>propertyset</code>s internally.</p> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<h3>Examples</h3> | |||
<pre><echoproperties/></pre> | |||
<p>Report the current properties to the log.</p> | |||
@@ -25,8 +25,9 @@ | |||
<body> | |||
<h2>EchoXML</h2> | |||
<p><em>Since Apache Ant 1.7</em></p> | |||
<h3>Description</h3> | |||
<p>Echo nested XML to the console or a file. <em>Since Apache Ant 1.7</em></p> | |||
<p>Echo nested XML to the console or a file.</p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
<tr> | |||
@@ -173,8 +173,8 @@ | |||
<h3>Parameters specified as nested elements</h3> | |||
<h4>any <a href="../Types/resources.html">resource</a> or resource collection</h4> | |||
<p>The specified resources will be imported. <em>Since Ant 1.8.0</em></p> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>The specified resources will be imported.</p> | |||
<h3>Examples</h3> | |||
<pre><import file="../common-targets.xml"/></pre> | |||
@@ -22,11 +22,10 @@ | |||
</head> | |||
<body> | |||
<h2 id="include">Include</h2> | |||
<p><em>Since Apache Ant 1.8.0</em></p> | |||
<h3>Description</h3> | |||
<p>Include another build file into the current project.</p> | |||
<p><em>since Apache Ant 1.8.0</em></p> | |||
<p><strong>Note</strong> this task heavily relies on the ProjectHelper implementation and doesn't | |||
really perform any work of its own. If you have configured Ant to use a ProjectHelper other | |||
than Ant's default, this task may or may not work.</p> | |||
@@ -37,8 +36,10 @@ | |||
in the Ant FAQ</a> insofar as the target names get prefixed by the included | |||
project's <var>name</var> or <var>as</var> attribute and do not appear as if the file was | |||
contained in the including file.</p> | |||
<p>The <code>include</code> task may only be used as a top-level task. This means that | |||
it may not be used in a target.</p> | |||
<p>There are two further functional aspects that pertain to this task and that are not possible | |||
with entity includes:</p> | |||
<ul> | |||
@@ -329,7 +329,7 @@ as appropriate.</p> | |||
<h4 id="indexjars">indexjars</h4> | |||
<p><em>since Ant 1.6.2</em></p> | |||
<p><em>Since Ant 1.6.2</em></p> | |||
<p>The nested <code>indexjars</code> element specifies a <a href="../using.html#path">path-like | |||
structure</a>. Its content is completely ignored unless you set the <var>index</var> attribute of | |||
@@ -352,7 +352,7 @@ to <q>true</q>.</p> | |||
<h4 id="service">service</h4> | |||
<p><em>since Ant 1.7.0</em></p> | |||
<p><em>Since Ant 1.7.0</em></p> | |||
<p>The nested <code>service</code> element specifies a service. Services are described in | |||
the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html#Service_Provider">service | |||
@@ -225,23 +225,23 @@ for <a href="exec.html#env">environment variables</a>.</p> | |||
<h4>syspropertyset</h4> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<p>You can specify a set of properties to be used as system properties | |||
with <a href="../Types/propertyset.html">syspropertyset</a>s.</p> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<h4>classpath</h4> | |||
<p><code>Java</code>'s <var>classpath</var> attribute is a <a href="../using.html#path">path-like | |||
structure</a> and can also be set via a nested <code>classpath</code> element.</p> | |||
<h4>bootclasspath</h4> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<p>The location of bootstrap class files can be specified using | |||
this <a href="../using.html#path">path-like structure</a>—will be ignored if <var>fork</var> | |||
is not <q>true</q> or the target JVM doesn't support it (i.e. Java 1.1).</p> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<h4>env</h4> | |||
<p>It is possible to specify environment variables to pass to the forked JVM via | |||
nested <code>env</code> elements. See the description in the section | |||
@@ -249,6 +249,9 @@ about <a href="exec.html#env">exec</a></p> | |||
<p>Settings will be ignored if <var>fork</var> is <q>false</q>.</p> | |||
<h4>permissions</h4> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<p>Security permissions can be revoked and granted during the execution of the class via a | |||
nested <code>permissions</code> element. For more information please | |||
see <a href="../Types/permissions.html">permissions</a>.</p> | |||
@@ -261,17 +264,15 @@ indicated by <var>failonerror</var>. All permissions not granted per default wil | |||
whatever security manager was already in place. <code>exitVM</code> will be disallowed.</p> | |||
<p>Settings will be ignored if <var>fork</var> is <q>true</q>.</p> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<h4>assertions</h4> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<p>You can control enablement of Java 1.4 assertions with | |||
an <a href="../Types/assertions.html"><code><assertions></code></a> subelement.</p> | |||
<p>Assertion statements are currently ignored in non-forked mode.</p> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<h4 id="redirector">redirector</h4> | |||
<em>Since Ant 1.6.2</em> | |||
<p>A nested <a href="../Types/redirector.html">I/O Redirector</a> can be specified. In general, the | |||
@@ -474,15 +474,14 @@ can be used to enable arguments only if a given compiler implementation will be | |||
</tr> | |||
</table> | |||
<h4>compilerclasspath (<em>since Ant 1.8.0</em>)</h4> | |||
<h4>compilerclasspath</h4> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>A <a href="../using.html#path">path-like structure</a> holding the classpath to use when loading | |||
the compiler implementation if a custom class has been specified. Doesn't have any effect when | |||
using one of the built-in compilers.</p> | |||
<h4>Any nested element of a type that implements <code>CompilerAdapter</code> (<em>since Ant | |||
1.8.0</em>)</h4> | |||
<h4>Any nested element of a type that implements <code>CompilerAdapter</code></h4> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>If a defined type implements the <code>CompilerAdapter</code> interface a nested element of that | |||
type can be used as an alternative to the <var>compiler</var> attribute.</p> | |||
@@ -789,9 +789,9 @@ nested <code>sourcepath</code>, <code>classpath</code> and <code>bootclasspath</ | |||
respectively.</p> | |||
<h4>arg</h4> | |||
<p><em>Since Ant 1.6</em></p> | |||
<p>Use nested <code><arg></code> to specify additional arguments. | |||
See <a href="../using.html#arg">Command line arguments</a>. <em>Since Ant 1.6</em></p> | |||
See <a href="../using.html#arg">Command line arguments</a>.</p> | |||
<h3>Example</h3> | |||
<pre> | |||
@@ -176,14 +176,14 @@ can be used to enable arguments only if a given compiler implementation will be | |||
</tr> | |||
</table> | |||
<h4>implementationclasspath (<em>since Ant 1.8.0</em>)</h4> | |||
<h4>implementationclasspath</h4> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>A <a href="../using.html#path">path-like structure</a> holding the classpath to use when loading | |||
the compiler implementation if a custom class has been specified. Doesn't have any effect when | |||
using one of the built-in compilers.</p> | |||
<h4>Any nested element of a type that implements JavahAdapter (<em>since Ant 1.8.0</em>)</h4> | |||
<h4>Any nested element of a type that implements JavahAdapter</h4> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>If a defined type implements the <code>JavahAdapter</code> interface a nested element of that | |||
type can be used as an alternative to the <var>implementation</var> attribute.</p> | |||
@@ -154,8 +154,7 @@ for details.</p> | |||
</tr> | |||
<tr> | |||
<td>outputtoformatters</td> | |||
<td><em>Since Ant 1.7.0</em>.<br/>Send any output generated by tests to the test | |||
formatters.</td> | |||
<td>Send any output generated by tests to the test formatters. <em>Since Ant 1.7.0</em>.</td> | |||
<td>No; default is <q>true</q></td> | |||
</tr> | |||
<tr> | |||
@@ -268,11 +267,11 @@ test.</p> | |||
<h4>syspropertyset</h4> | |||
<p><em>Since Ant 1.6</em></p> | |||
<p>You can specify a set of properties to be used as system properties | |||
with <a href="../Types/propertyset.html">syspropertyset</a>s.</p> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<h4>env</h4> | |||
<p>It is possible to specify environment variables to pass to the forked JVM via | |||
@@ -283,46 +282,47 @@ element's attributes, see the description in the <a href="../Tasks/exec.html#env | |||
<h4>bootclasspath</h4> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<p>The location of bootstrap class files can be specified using | |||
this <a href="../using.html#path">PATH like structure</a>—will be ignored if <var>fork</var> | |||
is <q>false</q> or the target JVM doesn't support it (i.e. Java 1.1).</p> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<h4>permissions</h4> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<p>Security permissions can be revoked and granted during the execution of the class via a | |||
nested <code>permissions</code> element. For more information please | |||
see <a href="../Types/permissions.html">permissions</a></p> | |||
<p>Settings will be ignored if <var>fork</var>=<q>true</q>.</p> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<h4>assertions</h4> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<p>You can control enablement of Java 1.4 assertions with | |||
an <a href="../Types/assertions.html"><code><assertions></code></a> subelement.</p> | |||
<p>Assertion statements are currently ignored in non-forked mode.</p> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<h4>modulepath</h4> | |||
<p><em>Since Ant 1.9.8</em></p> | |||
<p>The location of modules can be specified using this <a href="../using.html#path">PATH like | |||
structure</a>.<br/>The <code>modulepath</code> requires <var>fork</var> to be set to <q>true</q>. | |||
<p><em>since Ant 1.9.8</em></p> | |||
<h4>upgrademodulepath</h4> | |||
<p><em>Since Ant 1.9.8</em></p> | |||
<p>The location of modules that replace upgradeable modules in the runtime image can be specified | |||
using this <a href="../using.html#path">PATH like | |||
structure</a>.<br/>The <code>upgrademodulepath</code> requires <var>fork</var> to be set | |||
to <q>true</q>.</p> | |||
<p><em>since Ant 1.9.8</em></p> | |||
<h4>formatter</h4> | |||
<p>The results of the tests can be printed in different formats. Output will always be sent to a | |||
@@ -25,10 +25,11 @@ | |||
<body> | |||
<h2>Length</h2> | |||
<p><em>Since Apache Ant 1.6.3</em></p> | |||
<h3>Description</h3> | |||
<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 | |||
a <code>condition</code>. <em>Since Apache Ant 1.6.3</em></p> | |||
a <code>condition</code>.</p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
<tr> | |||
@@ -85,7 +85,9 @@ the <a href="property.html"><code><property></code></a> task.</p> | |||
<h4>any <a href="../Types/resources.html">resource</a> or single element | |||
resource collection</h4> | |||
<p>The specified resource will be used as src. <em>Since Ant 1.7</em></p> | |||
<p><em>Since Ant 1.7</em></p> | |||
<p>The specified resource will be used as <var>srcFile</var> or <var>resource</var>.</p> | |||
<h4><a href="../Types/filterchain.html">FilterChain</a></h4> | |||
@@ -25,6 +25,7 @@ | |||
<body> | |||
<h2>Local</h2> | |||
<p><em>Since Ant 1.8</em></p> | |||
<h3>Description</h3> | |||
<p>Adds a local property to the current scope. Property scopes exist at Apache Ant's various "block" | |||
levels. These include targets as well as the <a href="parallel.html">Parallel</a> | |||
@@ -33,10 +34,10 @@ and <a href="sequential.html">Sequential</a> task containers | |||
properties of the same name at higher scopes, including the global scope. Note that using | |||
the <code>Local</code> task at the global level effectively makes the property local to the | |||
"anonymous target" in which top-level operations are carried out; it will not be defined for other | |||
targets in the buildfile. <em>Since Ant 1.8</em></p> | |||
targets in the buildfile.</p> | |||
<p>A property is made local if the <code><local></code> task | |||
precedes its definition. See the examples section.</p> | |||
<p>A property is made local if the <code><local></code> task precedes its definition. See the | |||
examples section.</p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
@@ -25,6 +25,7 @@ | |||
<body> | |||
<h2 id="macrodef">MacroDef</h2> | |||
<p><em>Since Apache Ant 1.6</em></p> | |||
<h3>Description</h3> | |||
<p>This defines a new task using a <code><sequential></code> nested task as a | |||
template. Nested elements <code><attribute></code> and <code><element></code> are | |||
@@ -33,7 +34,6 @@ | |||
<h3>Note</h3> | |||
<p>You can also use <em>prior defined</em> attributes for <var>default</var> values in other | |||
attributes. See the examples.</p> | |||
<p><em>since Apache Ant 1.6</em></p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
<tr> | |||
@@ -25,6 +25,7 @@ | |||
<body> | |||
<h2 id="manifestclasspath">Manifestclasspath</h2> | |||
<p><em>Since Apache Ant 1.7</em></p> | |||
<h3>Description</h3> | |||
<p>Converts a <a href="../using.html#path">Path</a> into a property whose value is appropriate for | |||
@@ -47,8 +48,6 @@ element, where the defined property is re-referenced.</p> | |||
attribute to the elements of the nested <code>classpath</code> must be the same as you expect them | |||
to be when deploying the jar.</p> | |||
<p><em>since Apache Ant 1.7</em></p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
<tr> | |||
@@ -161,14 +161,14 @@ can be used to enable arguments only if a given converter implementation will be | |||
</tr> | |||
</table> | |||
<h4>implementationclasspath (<em>since Apache Ant 1.8.0</em>)</h4> | |||
<h4>implementationclasspath</h4> | |||
<p><em>Since Apache Ant 1.8.0</em></p> | |||
<p>A <a href="../using.html#path">path-like structure</a> holding the classpath to use when loading | |||
the converter implementation if a custom class has been specified. Doesn't have any effect when | |||
using one of the built-in converters.</p> | |||
<h4>Any nested element of a type that implements Native2AsciiAdapter (<em>since Ant 1.8.0</em>)</h4> | |||
<h4>Any nested element of a type that implements Native2AsciiAdapter</h4> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>If a defined type implements the <code>Native2AsciiAdapter</code> interface a nested element of | |||
that type can be used as an alternative to the <var>implementation</var> attribute.</p> | |||
@@ -178,8 +178,8 @@ that type can be used as an alternative to the <var>implementation</var> attribu | |||
<native2ascii encoding="EUCJIS" src="srcdir" dest="srcdir" | |||
includes="**/*.eucjis" ext=".java"/></pre> | |||
<p>Converts all files in the directory <samp>srcdir</samp> ending in <samp>.eucjis</samp> from | |||
the EUCJIS encoding to ASCII and renames them to end in <samp>.java</samp>.</p> | |||
<p>Converts all files in the directory <samp>srcdir</samp> ending in <samp>.eucjis</samp> from the | |||
EUCJIS encoding to ASCII and renames them to end in <samp>.java</samp>.</p> | |||
<pre> | |||
<native2ascii encoding="EUCJIS" src="native/japanese" dest="src" | |||
@@ -56,8 +56,8 @@ See <a href="../install.html#librarydependencies">Library Dependencies</a> for m | |||
</tr> | |||
</table> | |||
<h4>any <a href="../Types/resources.html">resource</a> or single element resource collection</h4> | |||
<p>The specified resource will be used as <var>src</var>. <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> | |||
<h3>Examples</h3> | |||
<pre><gzip src="test.tar" destfile="test.tar.gz"/></pre> | |||
@@ -25,10 +25,10 @@ | |||
<body> | |||
<h2 id="presetdef">PreSetDef</h2> | |||
<p><em>Since Apache Ant 1.6</em></p> | |||
<h3>Description</h3> | |||
<p>The preset definition generates a new definition based on a current definition with some | |||
attributes or elements preset.</p> | |||
<p><em>since Apache Ant 1.6</em></p> | |||
<p>The resolution of properties in any of the attributes or nested text takes place with the | |||
definition is used and <em>not</em> when the preset definition is defined.</p> | |||
<h3>Parameters</h3> | |||
@@ -25,6 +25,7 @@ | |||
<body> | |||
<h2>ProjectHelper</h2> | |||
<p><em>Since Ant 1.8.2</em></p> | |||
<h3>Description</h3> | |||
<p>This task is provided for the purpose of allowing the user to install a different ProjectHelper | |||
at runtime.</p> | |||
@@ -32,7 +33,6 @@ at runtime.</p> | |||
(<code>ProjectHelper2</code>)</p> | |||
<p>See the description of Apache Ant's <a href="../projecthelper.html">Project Helper</a> for more | |||
information.</p> | |||
<p><em>Since Ant 1.8.2</em></p> | |||
<h3>Parameters specified as nested elements</h3> | |||
@@ -25,14 +25,14 @@ | |||
<body> | |||
<h2>PropertyHelper</h2> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<h3>Description</h3> | |||
<p>This task is provided for the purpose of allowing the user to <strong>(a)</strong> install a | |||
different <code>PropertyHelper</code> at runtime, or <strong>(b)</strong> (hopefully more often) | |||
install one or more <code>PropertyHelper</code> Delegates into the <code>PropertyHelper</code> | |||
active on the current <code>Project</code>. This is somewhat advanced Apache Ant usage and assumes a | |||
working familiarity with the modern Ant APIs. See the description of | |||
Ant's <a href="../properties.html#propertyHelper">Property Helper</a> for more information. | |||
<em>Since Ant 1.8.0</em></p> | |||
Ant's <a href="../properties.html#propertyHelper">Property Helper</a> for more information.</p> | |||
<h3>Parameters specified as nested elements</h3> | |||
@@ -25,11 +25,11 @@ | |||
<body> | |||
<h2>ResourceCount</h2> | |||
<p><em>Since Apache Ant 1.7</em></p> | |||
<h3>Description</h3> | |||
<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. <em>Since Apache Ant 1.7</em></p> | |||
condition.</p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
<tr> | |||
@@ -23,10 +23,11 @@ | |||
</head> | |||
<body> | |||
<h2>Retry</h2> | |||
<p><em>Since Apache Ant 1.7.1</em></p> | |||
<h3>Description</h3> | |||
<p><code>Retry</code> is a container which executes a single nested task until either: there is no | |||
failure; or: its <var>retrycount</var> has been exceeded. If this happens a BuildException is | |||
thrown. <em>Since Apache Ant 1.7.1</em></p> | |||
thrown.</p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
@@ -276,14 +276,14 @@ can be used to enable arguments only if a given compiler implementation will be | |||
</tr> | |||
</table> | |||
<h4>compilerclasspath (<em>since Ant 1.8.0</em>)</h4> | |||
<h4>compilerclasspath</h4> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>A <a href="../using.html#path">path-like structure</a> holding the classpath to use when loading | |||
the compiler implementation if a custom class has been specified. Doesn't have any effect when | |||
using one of the built-in compilers.</p> | |||
<h4>Any nested element of a type that implements RmicAdapter (<em>since Ant 1.8.0</em>)</h4> | |||
<h4>Any nested element of a type that implements RmicAdapter</h4> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>If a defined type implements the <code>RmicAdapter</code> interface a nested element of that type | |||
can be used as an alternative to the <var>compiler</var> attribute.</p> | |||
@@ -25,10 +25,9 @@ | |||
<body> | |||
<h2 id="scp">SCP</h2> | |||
<p><em>Since Apache Ant 1.6</em></p> | |||
<h3>Description</h3> | |||
<p><em>since Apache Ant 1.6</em></p> | |||
<p>Copies a file or FileSet to or from a (remote) machine running an SSH daemon. | |||
FileSet <em>only</em> works for copying files from the local machine to a remote machine.</p> | |||
@@ -25,10 +25,9 @@ | |||
<body> | |||
<h2 id="sshexec">SSHEXEC</h2> | |||
<p><em>Since Apache Ant 1.6</em></p> | |||
<h3>Description</h3> | |||
<p><em>since Apache Ant 1.6</em></p> | |||
<p>Runs a command on a remote machine running SSH daemon.</p> | |||
<p><strong>Note</strong>: This task depends on external libraries not included in the Ant | |||
@@ -25,10 +25,9 @@ | |||
<body> | |||
<h2 id="sshsession">SSHSESSION</h2> | |||
<p><em>Since Apache Ant 1.8.0</em></p> | |||
<h3>Description</h3> | |||
<p><em>since Apache Ant 1.8.0</em></p> | |||
<p>A Task which establishes an SSH connection with a remote machine running SSH daemon, optionally | |||
establishes any number of local or remote tunnels over that connection, then executes any nested | |||
tasks before taking down the connection.</p> | |||
@@ -242,7 +242,7 @@ path-like structure).</p> | |||
<h4>any <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>Use resource collections to specify resources that the stylesheet should be applied to. Use a | |||
nested mapper and the task's <q>destdir</q> attribute to specify the output files.</p> | |||
@@ -341,6 +341,7 @@ the <a href="https://www.w3.org/TR/xslt#output"> XSLT specifications</a>. | |||
</table> | |||
<h4 id="factory">factory (<var>trax</var> processors only)</h4> | |||
<p><em>Since Ant 1.9.8</em></p> | |||
<p>Used to specify factory settings.</p> | |||
<h5>Parameters</h5> | |||
@@ -425,7 +426,6 @@ documentation of your processor. For example, in Xalan 2.x:</p> | |||
<p>Sets the classloader to use when loading extension functions to a classloader using | |||
the <code>path</code> with the id <code>extension-path</code>.</p> | |||
<p><em>since Ant 1.9.8</em></p> | |||
<h6>feature</h6> | |||
<p>Used to specify settings of the processor factory. The feature names are mostly processor | |||
@@ -456,7 +456,7 @@ is <var>http://javax.xml.XMLConstants/feature/secure-processing</var>. | |||
<h4>mapper</h4> | |||
<p><em>since Ant 1.6.2</em></p> | |||
<p><em>Since Ant 1.6.2</em></p> | |||
<p>You can define filename transformations by using a | |||
nested <a href="../Types/mapper.html">mapper</a> element. The default mapper used | |||
@@ -473,20 +473,20 @@ should be specified as a nested resource or single-element collection. Alternat | |||
the <var>refid</var> to specify the resource or collection as a reference.</p> | |||
<h4>sysproperty</h4> | |||
<p><em>Since Ant 1.8.0</em>.</p> | |||
<p>Use nested <code><sysproperty></code> elements to specify system properties required by the | |||
factory or transformation. These properties will be made available to JVM during the execution of | |||
the class. The attributes for this element are the same as for <a href="exec.html#env">environment | |||
variables</a>.</p> | |||
<p><em>since Ant 1.8.0</em>.</p> | |||
<h4>syspropertyset</h4> | |||
<p><em>Since Ant 1.8.0</em>.</p> | |||
<p>You can specify a set of properties to be used as system properties | |||
with <a href="../Types/propertyset.html">syspropertyset</a>s.</p> | |||
<p><em>since Ant 1.8.0</em>.</p> | |||
<h3>Examples</h3> | |||
<pre> | |||
<xslt basedir="doc" destdir="build/doc" | |||
@@ -24,11 +24,11 @@ | |||
<body> | |||
<h2>Subant Task</h2> | |||
<p><em>Since Apache Ant 1.6</em></p> | |||
<h3 id="description">Description</h3> | |||
<p>Calls a given target for all defined sub-builds. This is an extension of Ant for bulk project | |||
execution. <strong>This task must not be used outside of a <code>target</code> if it invokes the | |||
same build file it is part of.</strong></p> | |||
<p><em>Since Apache Ant 1.6</em></p> | |||
<p><code>subant</code> uses <code>ant</code> internally so many things said | |||
in <a href="ant.html"><code>ant</code>'s manual page</a> apply here as well.</p> | |||
@@ -140,6 +140,7 @@ different from the way <code><property></code> tasks in build files behave | |||
<p>Creates a nested <code><buildpathelement></code>, and add it to the implicit build | |||
path.</p> | |||
<h4><strong>target</strong> (org.apache.tools.ant.taskdefs.Ant.TargetElement)</h4> | |||
<p><em>Since Ant 1.7</em>.</p> | |||
<p>You can specify multiple targets using nested <code><target></code> elements instead of | |||
using the target attribute. These will be executed as if Ant had been invoked with a single target | |||
whose dependencies are the targets so specified, in the order specified.</p> | |||
@@ -155,7 +156,6 @@ whose dependencies are the targets so specified, in the order specified.</p> | |||
<td>Yes</td> | |||
</tr> | |||
</table> | |||
<p><em>since Ant 1.7</em>.</p> | |||
<h3 id="examples">Examples</h3> | |||
<pre> | |||
<project name="subant" default="subant1"> | |||
@@ -25,12 +25,12 @@ | |||
<body> | |||
<h2 id="touch">Truncate</h2> | |||
<p><em>Since Apache Ant 1.7.1</em></p> | |||
<h3>Description</h3> | |||
<p>Set the length of one or more files, as the intermittently available <code>truncate</code> Unix | |||
utility/function. In addition to working with a single file, this Task can also work | |||
on <a href="../Types/resources.html">resources</a> and resource collections. <em>Since Apache Ant | |||
1.7.1</em>.</p> | |||
on <a href="../Types/resources.html">resources</a> and resource collections.</p> | |||
<h3>Parameters</h3> | |||
<table class="attr"> | |||
@@ -85,9 +85,10 @@ to directories as well, use a nested <code>srcresources</code> element and a <co | |||
(for example).</p> | |||
<h4 id="srcresources">srcresources</h4> | |||
<p><em>Since Apache Ant 1.7</em></p> | |||
<p>The nested <code><srcresources></code> element is | |||
a <a href="../Types/resources.html#union">union</a> and allows you to specify a collection of | |||
resources to check against the target file(s). <em>Since Apache Ant 1.7</em></p> | |||
resources to check against the target file(s).</p> | |||
<h4 id="mapper">mapper</h4> | |||
<p>The nested <code><mapper></code> element allows you to specify a set of target files to | |||
@@ -441,9 +441,9 @@ and of the choice of regular expression implementation.</p> | |||
<h3 id="suffixlines">SuffixLines</h3> | |||
<p>Attaches a suffix to every line.</p> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p><em>since Ant 1.8.0</em></p> | |||
<p>Attaches a suffix to every line.</p> | |||
<table class="attr"> | |||
<tr> | |||
@@ -887,8 +887,10 @@ extracted)</p> | |||
<h3 id="deletecharacters">DeleteCharacters</h3> | |||
<p><em>Since Ant 1.6</em></p> | |||
<p>This filter deletes specified characters.</p> | |||
<p><em>since Ant 1.6</em></p> | |||
<p>This filter is only available in the convenience form.</p> | |||
<table class="attr"> | |||
@@ -912,8 +914,8 @@ extracted)</p> | |||
<pre><deletecharacters chars="\t\r"/></pre> | |||
<h3 id="concatfilter">ConcatFilter</h3> | |||
<p><em>Since Ant 1.6</em></p> | |||
<p>This filter prepends or appends the content file to the filtered files.</p> | |||
<p><em>since Ant 1.6</em></p> | |||
<table class="attr"> | |||
<tr> | |||
<th>Parameter Name</th> | |||
@@ -952,7 +954,7 @@ extracted)</p> | |||
</filterchain></pre> | |||
<h3 id="sortfilter">SortFilter</h3> | |||
<p><em>since Ant 1.8.0</em></p> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>The sort filter reads all lines and sorts them. The sort order can be reversed and it is | |||
possible to specify a custom implementation of the <code>java.util.Comparator</code> interface | |||
@@ -1414,11 +1416,12 @@ sort filter.</p> | |||
<h4 id="native2asciifilter">Native2AsciiFilter</h4> | |||
<p><em>Since Ant 1.9.8</em></p> | |||
<p>Uses the "builtin" implementation of | |||
the <a href="../Tasks/native2ascii.html">native2ascii</a> task.</p> | |||
<p>Replaces non-ascii characters by their Unicode-escapes or vice-versa. <em>Since Ant | |||
1.9.8</em></p> | |||
<p>Replaces non-ASCII characters by their Unicode-escapes or vice-versa.</p> | |||
<p>This filter may be used directly within a <code>filterchain</code>.</p> | |||
@@ -541,7 +541,8 @@ with <code><uptodate></code> and <code><junit></code> output.</p> | |||
<!-- Unpackage Mapper --> | |||
<!-- --> | |||
<h4 id="unpackage-mapper">unpackage (<em>since Ant 1.6.0</em>)</h4> | |||
<h4 id="unpackage-mapper">unpackage</h4> | |||
<p><em>Since Ant 1.6.0</em></p> | |||
<p>This mapper is the inverse of the <a href="#package-mapper">package</a> mapper. It replaces | |||
the dots in a package name with directory separators. This is useful for matching XML formatter | |||
results against their JUnit test test cases. The mapper shares the sample syntax as | |||
@@ -566,7 +567,8 @@ the <a href="#glob-mapper">glob mapper</a>.</p> | |||
<!-- Composite Mapper --> | |||
<!-- --> | |||
<h4 id="composite-mapper">composite (<em>since Ant 1.7.0</em>)</h4> | |||
<h4 id="composite-mapper">composite</h4> | |||
<p><em>Since Ant 1.7.0</em></p> | |||
<p>This mapper implementation can contain multiple nested mappers. File mapping is performed by | |||
passing the source filename to each nested <code><mapper></code> in turn, returning all | |||
results. The <var>to</var> and <var>from</var> attributes are ignored.</p> | |||
@@ -598,7 +600,8 @@ attribute.</p> | |||
<!-- Chained Mapper --> | |||
<!-- --> | |||
<h4 id="chained-mapper">chained (<em>since Ant 1.7.0</em>)</h4> | |||
<h4 id="chained-mapper">chained</h4> | |||
<p><em>Since Ant 1.7.0</em></p> | |||
<p>This mapper implementation can contain multiple nested mappers. File mapping is performed by | |||
passing the source filename to the first nested mapper, its results to the second, and so on. | |||
The target filenames generated by the last nested mapper comprise the ultimate results of the | |||
@@ -640,7 +643,8 @@ attribute.</p> | |||
<!-- Filter Mapper --> | |||
<!-- --> | |||
<h4 id="filter-mapper">filtermapper (<em>since Ant 1.6.3</em>)</h4> | |||
<h4 id="filter-mapper">filtermapper</h4> | |||
<p><em>Since Ant 1.6.3</em></p> | |||
<p>This mapper implementation applies a <a href="filterchain.html">filterchain</a> to the source | |||
file name.</p> | |||
<h5>Examples</h5> | |||
@@ -685,7 +689,8 @@ file name.</p> | |||
<!-- Script Mapper --> | |||
<!-- --> | |||
<h4 id="script-mapper">scriptmapper (<em>since Ant 1.7</em>)</h4> | |||
<h4 id="script-mapper">scriptmapper</h4> | |||
<p><em>Since Ant 1.7</em></p> | |||
<p>This mapper executes a script written in <a href="https://jakarta.apache.org/bsf" | |||
target="_top">Apache BSF</a> | |||
or <a href="https://jcp.org/aboutJava/communityprocess/maintenance/jsr223/223ChangeLog.html">JSR | |||
@@ -793,7 +798,8 @@ every source file, with the list of mapped names reset after every invocation.</ | |||
<p>The scriptmapper has no corresponding <code><mapper <var>type</var>></code> attribute.</p> | |||
<h4 id="firstmatch-mapper">firstmatchmapper (<em>since Ant 1.8.0</em>)</h4> | |||
<h4 id="firstmatch-mapper">firstmatchmapper</h4> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>This mapper supports an arbitrary number of nested mappers and returns the results of the | |||
first mapper that matches. This is different from <a href="#composite-mapper">composite | |||
mapper</a> which collects the results of all matching children.</p> | |||
@@ -822,8 +828,8 @@ mapper</a> which collects the results of all matching children.</p> | |||
<p>The firstmatchmapper has no corresponding <code><mapper <var>type</var>></code> | |||
attribute.</p> | |||
<h4 id="cutdirs-mapper">cutdirsmapper (<em>since Ant 1.8.2</em>)</h4> | |||
<h4 id="cutdirs-mapper">cutdirsmapper</h4> | |||
<p><em>Since Ant 1.8.2</em></p> | |||
<p>This mapper strips a configured number of leading directories from the source file name.</p> | |||
<h5>Examples</h5> | |||
@@ -127,8 +127,8 @@ attributes you can use to test the existence of a property.</p> | |||
<p>Patternsets may be nested within one another, adding the nested patterns to the parent | |||
patternset.</p> | |||
<h4><code>invert</code></h4> | |||
<p>A nested patternset can be inverted using the <code><invert></code> element. <em>Since | |||
Apache Ant 1.7.1</em></p> | |||
<p><em>Since Apache Ant 1.7.1</em></p> | |||
<p>A nested patternset can be inverted using the <code><invert></code> element.</p> | |||
<h3>Examples</h3> | |||
<pre> | |||
<patternset id="non.test.sources"> | |||
@@ -25,14 +25,14 @@ | |||
<body> | |||
<h2 id="redirector">I/O redirection</h2> | |||
<p><em>Since Apache Ant 1.6.2</em></p> | |||
<p>For many tasks, input and output can be defined in a fairly straightforward fashion. | |||
The <a href="../Tasks/exec.html">exec</a> task, used to execute an external process, stands as a | |||
very basic example. The executed process may accept input, produce output, or do either or both | |||
depending upon various circumstances. Output may be classified as <em>output</em> or | |||
as <em>error output</em>. The <code><redirector></code> type provides a concrete means of | |||
redirecting input and output featuring the use of <a href="./mapper.html">File Mapper</a>s to | |||
specify source (input) and destination (output/error) files. <em>Since Apache Ant | |||
1.6.2</em></p> | |||
specify source (input) and destination (output/error) files.</p> | |||
<p>The <code><redirector></code> element accepts the following attributes:</p> | |||
<table class="attr"> | |||
<tr> | |||
@@ -938,9 +938,10 @@ first few oldest, largest, etc. resources from a larger collection.</p> | |||
<p>A single resource collection is required.</p> | |||
<h4 id="last">last</h4> | |||
<p><em>Since Ant 1.7.1</em></p> | |||
<p>Includes the last <var>count</var> 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. <em>Since Ant 1.7.1</em></p> | |||
last few oldest, largest, etc. resources from a larger collection.</p> | |||
<table class="attr"> | |||
<tr> | |||
<th>Attribute</th> | |||
@@ -962,10 +963,11 @@ last few oldest, largest, etc. resources from a larger collection. <em>Since Ant | |||
<p>A single resource collection is required.</p> | |||
<h4 id="allbutfirst">allbutfirst</h4> | |||
<p><em>Since Ant 1.9.5</em></p> | |||
<p>Includes all elements except for the first <var>count</var> 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. <em>Since Ant 1.9.5</em></p> | |||
collection.</p> | |||
<table class="attr"> | |||
<tr> | |||
<th>Attribute</th> | |||
@@ -987,10 +989,11 @@ collection. <em>Since Ant 1.9.5</em></p> | |||
<p>A single resource collection is required.</p> | |||
<h4 id="allbutlast">allbutlast</h4> | |||
<p><em>Since Ant 1.9.5</em></p> | |||
<p>Includes all elements except for the last <var>count</var> 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. <em>Since Ant 1.9.5</em></p> | |||
collection.</p> | |||
<table class="attr"> | |||
<tr> | |||
<th>Attribute</th> | |||
@@ -87,16 +87,16 @@ define it as a simple parameter to <code>ant</code>, but you can | |||
define it inside the <code>ANT_OPTS</code> environment variable.</p> | |||
<h3>GreedyInputHandler</h3> | |||
<p><em>Since Ant 1.7</em></p> | |||
<p>Like the default implementation, this InputHandler reads from standard | |||
input. However, it consumes <em>all</em> available input. This behavior is | |||
useful for sending Ant input via an OS pipe. <em>Since Ant 1.7</em></p> | |||
useful for sending Ant input via an OS pipe.</p> | |||
<h3>SecureInputHandler</h3> | |||
<p><em>Since Ant 1.7.1</em></p> | |||
<p>This InputHandler calls <code>System.console().readPassword()</code>, | |||
available since Java 6. On earlier platforms it falls back to the | |||
behavior of DefaultInputHandler. <em>Since Ant 1.7.1</em></p> | |||
behavior of DefaultInputHandler.</p> | |||
<h2>InputRequest</h2> | |||
@@ -503,6 +503,7 @@ are in charge—or, more importantly, which project is failing. | |||
<pre>ant -logger org.apache.tools.ant.listener.BigProjectLogger</pre> | |||
<h3 id="SimpleBigProjectLogger">SimpleBigProjectLogger</h3> | |||
<p><em>Since Ant 1.8.1</em></p> | |||
<p>Like <code>BigProjectLogger</code>, project-qualified target names | |||
are printed, useful for big builds with subprojects. Otherwise it is | |||
as quiet as <code>NoBannerLogger</code>:</p> | |||
@@ -525,17 +526,16 @@ Building jar: /sources/myapp/build/myapp.jar | |||
BUILD SUCCESSFUL | |||
Total time: 1 second</pre> | |||
<p><em>since Ant 1.8.1</em></p> | |||
<p>To use this listener, use the command:</p> | |||
<pre>ant -logger org.apache.tools.ant.listener.SimpleBigProjectLogger</pre> | |||
<h3 id="ProfileLogger">ProfileLogger</h3> | |||
<!-- This is the 'since' as described in the Loggers JavaDoc --> | |||
<p><em>Since Ant 1.8.0</em></p> | |||
<p>This logger stores the time needed for executing a task, target and | |||
the whole build and prints these information. The output contains a | |||
timestamp when entering the build, target or task and a timestamp | |||
and the needed time when exiting.</p> | |||
<!-- This is the 'since' as described in the Loggers JavaDoc --> | |||
<p><em>since Ant 1.8.0</em></p> | |||
<h4>Example</h4> | |||
Having that buildfile | |||
<pre> | |||
@@ -57,7 +57,8 @@ | |||
tell Ant on a Java 5+ system to have the JVM work it out for itself. | |||
</p> | |||
<h3>Java 5+ proxy support (<em>since Ant 1.7</em>)</h3> | |||
<h3>Java 5+ proxy support</h3> | |||
<p><em>Since Ant 1.7</em></p> | |||
<p> | |||
When Ant starts up, if the <code>-autoproxy</code> command is | |||
supplied, Ant sets the <code>java.net.useSystemProxies</code> system | |||
@@ -232,7 +232,7 @@ | |||
<h1 id="extension-points">Extension-Points</h1> | |||
<p><em>since Ant 1.8.0</em>.</p> | |||
<p><em>Since Ant 1.8.0</em>.</p> | |||
<p>Extension-Points are similar to targets in that they have a name | |||
and a <var>depends</var> list and can be executed from the command | |||