uniform style of notes and new feature markersmaster
@@ -59,7 +59,7 @@ parameterize your subprojects.</p> | |||
<p>Properties defined on the command line cannot be overridden by | |||
nested <code><property></code> elements. <em>Since Ant | |||
1.8.0.</em> the same is true for nested structures | |||
1.8.0</em> the same is true for nested structures | |||
of <code><ant></code> tasks: if a build file <em>A</em> | |||
invokes <em>B</em> via an <code><ant></code> task setting a | |||
property with a nested <code><property></code> element | |||
@@ -42,7 +42,7 @@ | |||
supergrammar specified by the glib attribute) is newer than the | |||
generated files. | |||
</p> | |||
<p><strong>Note:</strong> This task depends on external libraries not | |||
<p><strong>Note</strong>: This task depends on external libraries not | |||
included in the Apache Ant distribution. See <a href="../install.html#librarydependencies">Library Dependencies</a> | |||
for more information.</p> | |||
<p>Antlr 2.7.1 Note: | |||
@@ -29,7 +29,7 @@ | |||
<p> | |||
Stores the Apache Ant version (when used as task) or checks for a specific Ant version | |||
(when used as condition). | |||
<b>Since Ant 1.7.0</b> | |||
<em>Since Ant 1.7.0</em> | |||
</p> | |||
<table> | |||
@@ -95,7 +95,7 @@ to send input to it is via the input and inputstring attributes.</p> | |||
<td valign="top">dir</td> | |||
<td valign="top">the directory in which the command should be executed.</td> | |||
<td align="center" valign="top">No.<br/> | |||
<strong>Note:</strong> the default used when dir has not been | |||
<strong>Note</strong>: the default used when dir has not been | |||
specified depends on the <code>vmlauncher</code> attribute. If | |||
<code>vmlauncher</code> is <code>true</code> the task will use | |||
the current working directory, otherwise it uses the project's basedir. | |||
@@ -233,7 +233,7 @@ to send input to it is via the input and inputstring attributes.</p> | |||
<i>both</i>. If set to <i>file</i>, only the names of plain | |||
files will be sent to the command. If set to <i>dir</i>, only | |||
the names of directories are considered.<br> | |||
<strong>Note:</strong> The type attribute does not apply to | |||
<strong>Note</strong>: The type attribute does not apply to | |||
nested <i>dirset</i>s - <i>dirset</i>s always implicitly | |||
assume type to be <i>dir</i>.</td> | |||
<td align="center" valign="top">No, default is <i>file</i></td> | |||
@@ -272,31 +272,31 @@ to send input to it is via the input and inputstring attributes.</p> | |||
<td valign="top">maxparallel</td> | |||
<td valign="top">Limit the amount of parallelism by passing at | |||
most this many sourcefiles at once. Set it to <= 0 for | |||
unlimited. <em>Since Ant 1.6.</em></td> | |||
unlimited. <em>Since Ant 1.6</em>.</td> | |||
<td align="center" valign="top">No, unlimited by default</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">addsourcefile</td> | |||
<td valign="top">Whether source file names should be added to the | |||
command automatically. <em>Since Ant 1.6.</em></td> | |||
command automatically. <em>Since Ant 1.6</em>.</td> | |||
<td align="center" valign="top">No, default is <i>true</i></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">verbose</td> | |||
<td valign="top">Whether to print a summary after execution or not. | |||
<em>Since Ant 1.6.</em></td> | |||
<em>Since Ant 1.6</em>.</td> | |||
<td align="center" valign="top">No, default <i>false</i></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">ignoremissing</td> | |||
<td valign="top">Whether to ignore nonexistent files specified | |||
via filelists. <em>Since Ant 1.6.2.</em></td> | |||
via filelists. <em>Since Ant 1.6.2</em>.</td> | |||
<td align="center" valign="top">No, default is <i>true</i></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">force</td> | |||
<td valign="top">Whether to bypass timestamp comparisons | |||
for target files. <em>Since Ant 1.6.3.</em></td> | |||
for target files. <em>Since Ant 1.6.3</em>.</td> | |||
<td align="center" valign="top">No, default is <i>false</i></td> | |||
</tr> | |||
</table> | |||
@@ -386,7 +386,7 @@ specified if you also define a nested mapper.</p> | |||
system command via nested <code><env></code> elements. See the | |||
description in the section about <a href="exec.html#env">exec</a></p> | |||
<h4>redirector</h4> | |||
<i><b>Since Ant 1.6.2</b></i> | |||
<em>Since Ant 1.6.2</em> | |||
<p>A nested <a href="../Types/redirector.html">I/O Redirector</a> | |||
can be specified. <apply>'s behavior is like that of | |||
<a href="exec.html#redirector">exec</a> with regard to | |||
@@ -25,7 +25,7 @@ | |||
<body> | |||
<h2 id="attrib">Attrib</h2> | |||
<p><em>Since Apache Ant 1.6.</em></p> | |||
<p><em>Since Apache Ant 1.6</em>.</p> | |||
<h3>Description</h3> | |||
<p>Changes the attributes of a file or all files inside specified | |||
@@ -39,7 +39,7 @@ href="../Types/filelist.html">FileList</a>s can be specified using | |||
nested <code><fileset></code>, <code><dirset></code> and | |||
<code><filelist></code> elements.</p> | |||
<p>Starting with Ant 1.7, this task supports arbitrary <a | |||
<p><em>Since Ant 1.7</em>, this task supports arbitrary <a | |||
href="../Types/resources.html#collection">Resource Collection</a>s | |||
as nested elements.</p> | |||
@@ -96,7 +96,7 @@ directory tree), so you'll have to experiment a little.</p--> | |||
<td valign="top">One of <i>file</i>, <i>dir</i> or <i>both</i>. If set to | |||
<i>file</i>, only the permissions of plain files are going to be changed. | |||
If set to <i>dir</i>, only the directories are considered.<br> | |||
<strong>Note:</strong> The type attribute does not apply to | |||
<strong>Note</strong>: The type attribute does not apply to | |||
nested <i>dirset</i>s - <i>dirset</i>s always implicitly | |||
assume type to be <i>dir</i>.</td> | |||
<td align="center" valign="top">No, default is <i>file</i></td> | |||
@@ -117,7 +117,7 @@ directory tree), so you'll have to experiment a little.</p--> | |||
<td valign="top">maxparallel</td> | |||
<td valign="top">Limit the amount of parallelism by passing at | |||
most this many sourcefiles at once. Set it to <= 0 for | |||
unlimited. Defaults to unlimited. <em>Since Ant 1.6.</em></td> | |||
unlimited. Defaults to unlimited. <em>Since Ant 1.6</em>.</td> | |||
<td align="center" valign="top">No</td> | |||
</tr--> | |||
<tr> | |||
@@ -32,7 +32,7 @@ mapped as XML attributes. This is an unusual task that makes use of Ant's intern | |||
processing mechanisms to reload a previously declared reference by means of the 'id' | |||
attribute, then treats the declared <code>augment</code> element as though it were the | |||
original element. | |||
<b>Since Apache Ant 1.8.1</b></p> | |||
<em>Since Apache Ant 1.8.1</em></p> | |||
<h3>Parameters</h3> | |||
<table> | |||
@@ -40,7 +40,7 @@ on some other project which import them. This task helps then to modify the | |||
target dependencies but only in your context. | |||
</p> | |||
<p>Note: this task is quite equivalent to the definition of an intermediate | |||
<p><strong>Note</strong>: this task is quite equivalent to the definition of an intermediate | |||
target which will be the bridge between the target to bind and the extension | |||
point. For instance: | |||
</p> | |||
@@ -55,7 +55,7 @@ This task basically avoid the creation of a target. | |||
it may 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><b>Since Apache Ant 1.8.2</b></p> | |||
<p><em>Since Apache Ant 1.8.2</em></p> | |||
<h3>Parameters</h3> | |||
<table> | |||
@@ -59,7 +59,7 @@ operation may fail when using such an incompatible client. | |||
</tr> | |||
<tr> | |||
<td valign="top">package</td> | |||
<td valign="top">the package/module to check out. <b>Note:</b> | |||
<td valign="top">the package/module to check out. <strong>Note</strong>: | |||
multiple attributes can be split using spaces. Use a nested | |||
<module> element if you want to specify a module with | |||
spaces in its name.</td> | |||
@@ -25,7 +25,7 @@ | |||
<body> | |||
<h2 id="chgrp">Chgrp</h2> | |||
<p><em>Since Apache Ant 1.6.</em></p> | |||
<p><em>Since Apache Ant 1.6</em>.</p> | |||
<h3>Description</h3> | |||
<p>Changes the group of a file or all files inside specified | |||
@@ -92,7 +92,7 @@ could use as initial value for these experiments.</p> | |||
<i>both</i>. If set to <i>file</i>, only the group of | |||
plain files are going to be changed. If set to <i>dir</i>, only | |||
the directories are considered.<br> | |||
<strong>Note:</strong> The type attribute does not apply to | |||
<strong>Note</strong>: The type attribute does not apply to | |||
nested <i>dirset</i>s - <i>dirset</i>s always implicitly | |||
assume type to be <i>dir</i>.</td> | |||
<td align="center" valign="top">No, default is <i>file</i></td> | |||
@@ -39,10 +39,10 @@ FileSet's attributes and nested elements directly. More sets can be | |||
specified using nested <code><fileset></code> or | |||
<code><dirset></code> (<em>since Apache Ant 1.6</em>) elements.</p> | |||
<p>Starting with Ant 1.6, this task also supports nested <a | |||
<p><em>Since Ant 1.6</em>, this task also supports nested <a | |||
href="../Types/filelist.html">filelist</a>s.</p> | |||
<p>Starting with Ant 1.7, this task supports arbitrary <a | |||
<p><em>Since Ant 1.7</em>, this task supports arbitrary <a | |||
href="../Types/resources.html#collection">Resource Collection</a>s | |||
as nested elements.</p> | |||
@@ -83,7 +83,7 @@ could use as initial value for these experiments.</p> | |||
<td valign="top">dir</td> | |||
<td valign="top">the directory which holds the files whose permissions | |||
must be changed.<br/> | |||
<b>Note:</b> for backwards compatibility | |||
<strong>Note</strong>: for backwards compatibility | |||
reasons <code><chmod dir="some-dir"/></code> will | |||
only change the permissions on "some-dir" but not recurse into | |||
it, unless you also specify any patterns.</td> | |||
@@ -123,7 +123,7 @@ could use as initial value for these experiments.</p> | |||
<i>both</i>. If set to <i>file</i>, only the permissions of | |||
plain files are going to be changed. If set to <i>dir</i>, only | |||
the directories are considered.<br> | |||
<strong>Note:</strong> The type attribute does not apply to | |||
<strong>Note</strong>: The type attribute does not apply to | |||
nested <i>dirset</i>s - <i>dirset</i>s always implicitly | |||
assume type to be <i>dir</i>.</td> | |||
<td align="center" valign="top">No, default is <i>file</i></td> | |||
@@ -132,13 +132,13 @@ could use as initial value for these experiments.</p> | |||
<td valign="top">maxparallel</td> | |||
<td valign="top">Limit the amount of parallelism by passing at | |||
most this many sourcefiles at once. Set it to <= 0 for | |||
unlimited. Defaults to unlimited. <em>Since Ant 1.6.</em></td> | |||
unlimited. Defaults to unlimited. <em>Since Ant 1.6</em>.</td> | |||
<td align="center" valign="top">No</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">verbose</td> | |||
<td valign="top">Whether to print a summary after execution or not. | |||
Defaults to <code>false</code>. <em>Since Ant 1.6.</em></td> | |||
Defaults to <code>false</code>. <em>Since Ant 1.6</em>.</td> | |||
<td align="center" valign="top">No</td> | |||
</tr> | |||
<tr> | |||
@@ -25,7 +25,7 @@ | |||
<body> | |||
<h2 id="chown">Chown</h2> | |||
<p><em>Since Apache Ant 1.6.</em></p> | |||
<p><em>Since Apache Ant 1.6</em>.</p> | |||
<h3>Description</h3> | |||
<p>Changes the owner of a file or all files inside specified | |||
@@ -91,7 +91,7 @@ could use as initial value for these experiments.</p> | |||
<i>both</i>. If set to <i>file</i>, only the owner of | |||
plain files are going to be changed. If set to <i>dir</i>, only | |||
the directories are considered.<br> | |||
<strong>Note:</strong> The type attribute does not apply to | |||
<strong>Note</strong>: The type attribute does not apply to | |||
nested <i>dirset</i>s - <i>dirset</i>s always implicitly | |||
assume type to be <i>dir</i>.</td> | |||
<td align="center" valign="top">No, default is <i>file</i></td> | |||
@@ -264,7 +264,7 @@ TCP/IP listener at the specified host and port.</p> | |||
<p>Test two files for matching. Nonexistence of one file results in "false", | |||
although if neither exists they are considered equal in terms of content. | |||
This test does a byte for byte comparison, so test time scales with | |||
byte size. NB: if the files are different sizes, one of them is missing | |||
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. | |||
</p> | |||
@@ -288,7 +288,7 @@ or the filenames match the answer is so obvious the detailed test is omitted. | |||
<td valign="top">textfile</td> | |||
<td valign="top">Whether to ignore line endings when comparing | |||
files; defaults to <i>false</i> which triggers a binary | |||
comparison. <i>Since Ant 1.7</i> | |||
comparison. <em>Since Ant 1.7</em> | |||
</td> | |||
<td align="center">No</td> | |||
</tr> | |||
@@ -395,7 +395,7 @@ that is "true","yes", or "on"</p> | |||
signature validation; it only looks for the presence of a signature. | |||
</p> | |||
<p> | |||
This condition was added in Apache Ant 1.7. | |||
<em>Since Apache Ant 1.7</em>. | |||
</p> | |||
<table> | |||
<tr> | |||
@@ -424,7 +424,7 @@ that is "true","yes", or "on"</p> | |||
<a href="../Types/selectors.html">selector</a>. | |||
</p> | |||
<p> | |||
This condition was added in Apache Ant 1.6.3. | |||
<em>Since Apache Ant 1.6.3</em>. | |||
</p> | |||
<table> | |||
<tr> | |||
@@ -461,7 +461,7 @@ that is "true","yes", or "on"</p> | |||
its implementation class can be loaded. Types include | |||
tasks, datatypes, scriptdefs, macrodefs and presetdefs.</p> | |||
<p>This condition was added in Apache Ant 1.7.</p> | |||
<p><em>Since Apache Ant 1.7</em>.</p> | |||
<table> | |||
<tr> | |||
@@ -504,7 +504,7 @@ See the <a href="../Tasks/script.html">Script</a> task for | |||
an explanation of scripts and dependencies. | |||
</p> | |||
<p>This condition was added in Apache Ant 1.7.</p> | |||
<p><em>Since Apache Ant 1.7</em>.</p> | |||
<table> | |||
<tr> | |||
@@ -538,7 +538,7 @@ an explanation of scripts and dependencies. | |||
</tr> | |||
<tr> | |||
<td valign="top">encoding</td> | |||
<td valign="top">The encoding of the script source. <em>since Ant 1.10.2.</em></td> | |||
<td valign="top">The encoding of the script source. <em>Since Ant 1.10.2</em>.</td> | |||
<td valign="top" align="center">No - defaults to default JVM encoding</td> | |||
</tr> | |||
<tr> | |||
@@ -594,7 +594,7 @@ sets the value to false. This condition always evaluates to "false" | |||
feature or property, as per the SAX/JAXP specifications, by | |||
attempting to set the appropriate property/feature/</p> | |||
<p>This condition was added in Apache Ant 1.7.</p> | |||
<p><em>Since Apache Ant 1.7</em>.</p> | |||
<table> | |||
<tr> | |||
@@ -668,9 +668,7 @@ using a protocol such as HTTP, while the lower level ICMP packets get dropped | |||
on the floor. Similarly, a host may detected as reachable with ICMP, but | |||
not reachable on other ports (i.e. port 80), because of firewalls. | |||
</p> | |||
<p> | |||
This condition was added in Apache Ant 1.7.</p> | |||
<p><em>Since Apache Ant 1.7</em>.</p> | |||
<table> | |||
<tr> | |||
@@ -718,7 +716,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti | |||
<h4 id="length">length</h4> | |||
<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. | |||
<i>Since Ant 1.6.3</i> | |||
<em>Since Ant 1.6.3</em> | |||
</p> | |||
<blockquote><pre> | |||
@@ -734,7 +732,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti | |||
<h4 id="isfailure">isfailure</h4> | |||
<p>Test the return code of an executable (see the | |||
<a href="exec.html">Exec</a> task) for failure. <i>Since Ant 1.7</i></p> | |||
<a href="exec.html">Exec</a> task) for failure. <em>Since Ant 1.7</em></p> | |||
<table> | |||
<tr> | |||
@@ -754,7 +752,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti | |||
<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>. | |||
<i>Since Ant 1.7</i> | |||
<em>Since Ant 1.7</em> | |||
</p> | |||
<blockquote><pre> | |||
@@ -766,12 +764,12 @@ Probe for the maven repository being reachable using the hostname, ten second ti | |||
<p>Test resources for matching. Nonexistence of one or more resources results in | |||
"false", 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. NB: if the files are different sizes, one of them is missing | |||
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. <i>Since Ant 1.7</i> | |||
must match. <em>Since Ant 1.7</em> | |||
</p> | |||
<table> | |||
<tr> | |||
@@ -792,7 +790,7 @@ must match. <i>Since Ant 1.7</i> | |||
<h4 id="resourcecontains">resourcecontains</h4> | |||
<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. <i>Since Ant 1.7.1</i> | |||
case of file resources via the resource attribute. <em>Since Ant 1.7.1</em> | |||
</p> | |||
<table> | |||
<tr> | |||
@@ -829,7 +827,7 @@ must match. <i>Since Ant 1.7</i> | |||
Tests for a class having a method or field. If the class is not found | |||
or fails to load, the build fails. | |||
<i>Since Ant 1.7</i> | |||
<em>Since Ant 1.7</em> | |||
</p> | |||
<table> | |||
@@ -886,7 +884,7 @@ must match. <i>Since Ant 1.7</i> | |||
<p> | |||
Test if the specified string matches the specified regular | |||
expression pattern. | |||
<i>Since Ant 1.7</i></p> | |||
<em>Since Ant 1.7</em></p> | |||
<table> | |||
<tr> | |||
@@ -997,7 +995,7 @@ is redundant and will be ignored.</p> | |||
<p> | |||
Tests a partition to see if there is enough space. | |||
<i>Since Ant 1.7.0</i></p> | |||
<em>Since Ant 1.7.0</em></p> | |||
<p>Needed attribute can be specified using standard computing terms:</p> | |||
<ul> | |||
<li>K : Kilobytes (1024 bytes)</li> | |||
@@ -41,7 +41,7 @@ using a nested mapper (or the flatten attribute) may not be what you | |||
expect.</p> | |||
<p> | |||
<strong>Note:</strong> If you employ filters in your copy operation, | |||
<strong>Note</strong>: If you employ filters in your copy operation, | |||
you should limit the copy to text files. Binary files will be corrupted | |||
by the copy operation. | |||
This applies whether the filters are implicitly defined by the | |||
@@ -103,7 +103,7 @@ operation as <a href="../Types/filterset.html">filtersets</a>. | |||
<td valign="top">filtering</td> | |||
<td valign="top">Indicates whether token filtering using the <a href="../using.html#filters">global | |||
build-file filters</a> should take place during the copy. | |||
<em>Note</em>: Nested <code><filterset></code> elements will | |||
<strong>Note</strong>: Nested <code><filterset></code> elements will | |||
always be used, even if this attribute is not specified, or its value is | |||
<code>false</code> (<code>no</code>, or <code>off</code>).</td> | |||
<td valign="top" align="center">No; defaults to false.</td> | |||
@@ -317,7 +317,7 @@ destination directory, flattening the directory structure.</b></p> | |||
<p>The paragraph following the previous example applies to this | |||
example as well.</p> | |||
<p><strong>Unix Note:</strong> File permissions are not retained when files | |||
<p><strong>Unix Note</strong>: File permissions are not retained when files | |||
are copied; they end up with the default <code>UMASK</code> permissions | |||
instead. This | |||
is caused by the lack of any means to query or set file permissions in the | |||
@@ -325,14 +325,14 @@ current Java runtimes. If you need a permission-preserving copy function, | |||
use <code><exec executable="cp" ... ></code> instead. | |||
</p> | |||
<p><strong>Windows Note:</strong> If you copy a file to a directory | |||
<p><strong>Windows Note</strong>: If you copy a file to a directory | |||
where that file already exists, but with different casing, | |||
the copied file takes on the case of the original. The workaround is to | |||
<a href="delete.html">delete</a> | |||
the file in the destination directory before you copy it. | |||
</p> | |||
<p id="encoding"> | |||
<strong>Important Encoding Note:</strong> | |||
<strong>Important Encoding Note</strong>: | |||
The reason that binary files when filtered get corrupted is that | |||
filtering involves reading in the file using a Reader class. This | |||
has an encoding specifying how files are encoded. There are a number | |||
@@ -37,7 +37,7 @@ for certain other cvs clients - like CVSNT for example - and some | |||
operation may fail when using such an incompatible client. | |||
</p> | |||
<p><b>CVSNT Note</b>: CVSNT prefers users to store the passwords | |||
<p><strong>CVSNT Note</strong>: CVSNT prefers users to store the passwords | |||
inside the registry. If the <a href="cvspass.html">cvspass task</a> | |||
and the passfile attribute don't seem to work for you, the most likely | |||
reason is that CVSNT ignores your .cvspass file completely. See <a | |||
@@ -90,7 +90,7 @@ report 21657</a> for recommended workarounds.</p> | |||
</tr> | |||
<tr> | |||
<td valign="top">package</td> | |||
<td valign="top">the package/module to check out. <b>Note:</b> | |||
<td valign="top">the package/module to check out. <strong>Note</strong>: | |||
multiple attributes can be split using spaces. Use a nested | |||
<module> element if you want to specify a module with | |||
spaces in its name.</td> | |||
@@ -28,7 +28,7 @@ | |||
<h3>Description</h3> | |||
<p>Adds entries to a .cvspass file. Adding entries to this file has the same affect as a cvs login command.</p> | |||
<p><b>CVSNT Note</b>: CVSNT prefers users to store the passwords | |||
<p><strong>CVSNT Note</strong>: CVSNT prefers users to store the passwords | |||
inside the registry. If the task doesn't seem to work for you, the | |||
most likely reason is that CVSNT ignores your .cvspass file | |||
completely. See <a | |||
@@ -28,7 +28,7 @@ | |||
<h3>Description</h3> | |||
<p> | |||
This task allows to retrieve a CVS client and server version. | |||
<i>Since Apache Ant 1.6.1.</i> | |||
<em>Since Apache Ant 1.6.1</em>. | |||
</p> | |||
<h3>Parameters</h3> | |||
<table> | |||
@@ -71,10 +71,10 @@ in <strong>Directory-based Tasks</strong>, and see the | |||
<td valign="top">dir</td> | |||
<td valign="top">The directory to delete, including all its files and | |||
subdirectories.<br> | |||
<b>Note:</b> <code>dir</code> is <em>not</em> used | |||
<strong>Note</strong>: <code>dir</code> is <em>not</em> used | |||
to specify a directory name for <code>file</code>; <code>file</code> | |||
and <code>dir</code> are independent of each other.<br> | |||
<b>WARNING:</b> Do <b>not</b> set <code>dir</code> to | |||
<strong>Warning</strong>: Do <b>not</b> set <code>dir</code> to | |||
<code>"."</code>, <code>"${basedir}"</code>, | |||
or the full-pathname equivalent unless you truly <em>intend</em> to | |||
recursively remove the entire contents of the current base directory | |||
@@ -116,7 +116,7 @@ in <strong>Directory-based Tasks</strong>, and see the | |||
</tr> | |||
<tr> | |||
<td valign="top">includes</td> | |||
<td valign="top"><em>Deprecated.</em> Use resource collections. | |||
<td valign="top"><em>Deprecated</em>. Use resource collections. | |||
Comma- or space-separated list of patterns of | |||
files that must be deleted. All files are relative to the directory | |||
specified in <code>dir</code>.</td> | |||
@@ -124,14 +124,14 @@ in <strong>Directory-based Tasks</strong>, and see the | |||
</tr> | |||
<tr> | |||
<td valign="top">includesfile</td> | |||
<td valign="top"><em>Deprecated.</em> Use resource collections. | |||
<td valign="top"><em>Deprecated</em>. Use resource collections. | |||
The name of a file. Each line of | |||
this file is taken to be an include pattern.</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">excludes</td> | |||
<td valign="top"><em>Deprecated.</em> Use resource collections. | |||
<td valign="top"><em>Deprecated</em>. Use resource collections. | |||
Comma- or space-separated list of patterns of | |||
files that must be excluded from the deletion list. | |||
All files are relative to the directory specified in <code>dir</code>. | |||
@@ -140,14 +140,14 @@ in <strong>Directory-based Tasks</strong>, and see the | |||
</tr> | |||
<tr> | |||
<td valign="top">excludesfile</td> | |||
<td valign="top"><em>Deprecated.</em> Use resource collections. | |||
<td valign="top"><em>Deprecated</em>. Use resource collections. | |||
The name of a file. Each line of | |||
this file is taken to be an exclude pattern</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">defaultexcludes</td> | |||
<td valign="top"><em>Deprecated.</em> Use resource collections. | |||
<td valign="top"><em>Deprecated</em>. Use resource collections. | |||
Whether to use <a href="../dirtasks.html#defaultexcludes"> | |||
default excludes.</a></td> | |||
<td align="center" valign="top">No, default "true"</td> | |||
@@ -79,7 +79,7 @@ well as other stylesheets imported by the main stylesheet. | |||
<p>The <code><sources></code> element is a | |||
<a href="../Types/resources.html#union">Union</a> into which | |||
arbitrary resource collections can be nested. <b>Since Apache Ant 1.7</b> | |||
arbitrary resource collections can be nested. <em>Since Apache Ant 1.7</em> | |||
</p> | |||
<h4>srcfileset</h4> | |||
@@ -106,7 +106,7 @@ filelists. Multiple <code><srcfilelist></code> filelists may be specified | |||
<p>The <code><targets></code> element is a | |||
<a href="../using.html#path">Path</a> and thus can | |||
include any filesystem-based resource. <b>Since Ant 1.7</b> | |||
include any filesystem-based resource. <em>Since Ant 1.7</em> | |||
</p> | |||
<h4>targetfileset</h4> | |||
@@ -29,7 +29,7 @@ | |||
<p> | |||
Runs Apache Ant's <code>-diagnostics</code> code inside Ant itself. This is good for | |||
debugging Ant's configuration under an IDE. | |||
<b>Since Ant 1.7.0</b> | |||
<em>Since Ant 1.7.0</em> | |||
</p> | |||
<h3>Examples</h3> | |||
@@ -37,7 +37,7 @@ filename, the filename will be dropped. If the specified file is just | |||
a filename, the directory will be the current directory. | |||
</p> | |||
<p> | |||
<em>Note:</em> This is not the same as the UNIX dirname command, which is | |||
<strong>Note</strong>: This is not the same as the UNIX dirname command, which is | |||
defined as "strip non-directory suffix from filename". <dirname> | |||
determines the full directory path of the specified file. | |||
</p> | |||
@@ -209,7 +209,7 @@ to a value other than its default, <code>"add"</code>.</b></p> | |||
that the permissions haven't been stored at all rather than real | |||
permissions and will instead apply its own default values.<br/> | |||
Set this attribute to true if you really want to preserve the | |||
original permission field.<em>since Ant 1.8.0</em> | |||
original permission field. <em>since Ant 1.8.0</em> | |||
</td> | |||
<td valign="top" align="center">No, default is false</td> | |||
</tr> | |||
@@ -57,7 +57,7 @@ ignored</p> | |||
<td valign="top">output</td> | |||
<td valign="top">the <a href="../Types/resources.html">Resource</a> | |||
to write the message to (see <a href="../develop.html#set-magic">note</a>). | |||
<b>Since Apache Ant 1.8</b></td> | |||
<em>Since Apache Ant 1.8</em></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">append</td> | |||
@@ -26,7 +26,7 @@ | |||
<h2>EchoXML</h2> | |||
<h3>Description</h3> | |||
<p>Echo nested XML to the console or a file. <b>Since Apache Ant 1.7</b></p> | |||
<p>Echo nested XML to the console or a file. <em>Since Apache Ant 1.7</em></p> | |||
<h3>Parameters</h3> | |||
<table> | |||
<tr> | |||
@@ -32,7 +32,7 @@ systems.</p> | |||
<p>Note that you cannot interact with the forked program, the only way | |||
to send input to it is via the input and inputstring attributes. Also note that | |||
since Ant 1.6, any attempt to read input in the forked program will receive an | |||
<em>since Ant 1.6</em>, any attempt to read input in the forked program will receive an | |||
EOF (-1). This is a change from Ant 1.5, where such an attempt would block.</p> | |||
<p>If you want to execute an executable using a path relative to the | |||
@@ -169,7 +169,7 @@ start with something like:</p> | |||
<td valign="top">dir</td> | |||
<td valign="top">the directory in which the command should be executed.</td> | |||
<td align="center" valign="top">No.<br/> | |||
<strong>Note:</strong> the default used when dir has not been | |||
<strong>Note</strong>: the default used when dir has not been | |||
specified depends on the <code>vmlauncher</code> attribute. If | |||
<code>vmlauncher</code> is <code>true</code> the task will use | |||
the current working directory, otherwise it uses the project's basedir. | |||
@@ -343,7 +343,7 @@ system command via nested <code><env></code> elements.</p> | |||
<td valign="top"> | |||
The name of the environment variable. | |||
<br/> | |||
<em>Note: since Ant 1.7</em>, | |||
<strong>Note</strong>: <em>since Ant 1.7</em>, | |||
for Windows, the name is case-insensitive. | |||
</td> | |||
<td align="center" valign="top">Yes</td> | |||
@@ -366,7 +366,7 @@ system command via nested <code><env></code> elements.</p> | |||
</tr> | |||
</table> | |||
<h4 id="redirector">redirector</h4> | |||
<i>Since Ant 1.6.2</i> | |||
<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 attributes of the redirector behave | |||
as the corresponding attributes available at the task level. The most | |||
@@ -446,7 +446,7 @@ Output is sent to the file "redirector.out" and stored | |||
in a property of the same name. Similarly, error output is sent to | |||
a file and a property, both named "redirector.err". | |||
<p><b>Note:</b> do not try to specify arguments using | |||
<p><strong>Note</strong>: do not try to specify arguments using | |||
a simple arg-element and separate them by spaces. This results in | |||
only a single argument containing the entire string.</p> | |||
<p> | |||
@@ -69,7 +69,7 @@ or character data nested into the element.</p> | |||
conditional failure can be achieved using a single nested | |||
<code><condition></code> element, which should contain exactly one | |||
core or custom condition. For information about conditions, see | |||
<a href="conditions.html">here</a>.<br><i>Since Ant 1.6.2</i> | |||
<a href="conditions.html">here</a>.<br><em>Since Ant 1.6.2</em> | |||
</p> | |||
<h3>Examples</h3> | |||
@@ -62,7 +62,7 @@ | |||
</p> | |||
<p> | |||
Since <i>Apache Ant 1.7</i>, this task can be used in a | |||
<em>Since Apache Ant 1.7</em>, this task can be used in a | |||
<a href="../Types/filterchain.html">filterchain</a>. | |||
</p> | |||
@@ -85,7 +85,7 @@ | |||
</tr> | |||
<tr> | |||
<td valign="top">file</td> | |||
<td valign="top">Name of a single file to fix. <i>Since Ant 1.7</i></td> | |||
<td valign="top">Name of a single file to fix. <em>Since Ant 1.7</em></td> | |||
<td> </td> | |||
</tr> | |||
<tr> | |||
@@ -140,14 +140,14 @@ | |||
<tr> | |||
<td valign="top">outputencoding</td> | |||
<td valign="top">The encoding to use when writing the files. | |||
<i>Since Ant 1.7</i></td> | |||
<em>Since Ant 1.7</em></td> | |||
<td align="center">No; defaults to the value of the encoding attribute.</td> | |||
<td> </td> | |||
</tr> | |||
<tr> | |||
<td valign="top">preservelastmodified</td> | |||
<td valign="top">Whether to preserve the last modified | |||
date of source files. <i>Since Ant 1.6.3</i></td> | |||
date of source files. <em>Since Ant 1.6.3</em></td> | |||
<td align="center">No; default is <i>false</i></td> | |||
<td> </td> | |||
</tr> | |||
@@ -280,7 +280,7 @@ | |||
<tr> | |||
<td valign="top">fixlast</td> | |||
<td valign="top">Whether to add a missing EOL to the last line | |||
of a processed file.<br/>Ignored if EOL is asis.<br/><i>Since Ant 1.6.1</i></td> | |||
of a processed file.<br/>Ignored if EOL is asis.<br/><em>Since Ant 1.6.1</em></td> | |||
<td align="center" colspan="2">No; default is <i>true</i></td> | |||
</tr> | |||
</table> | |||
@@ -29,7 +29,7 @@ | |||
<p>The ftp task implements a basic FTP client that can send, receive, | |||
list, delete files, and create directories. See below for descriptions and examples of how | |||
to perform each task.</p> | |||
<p><b>Note:</b> This task depends on external libraries not included in the Apache Ant distribution. | |||
<p><strong>Note</strong>: This task depends on external libraries not included in the Apache Ant distribution. | |||
See <a href="../install.html#commons-net">Library Dependencies</a> for more information. | |||
<i>Get the latest version of this library, for the best support in Ant</i> | |||
@@ -50,7 +50,7 @@ This task does not currently use the proxy information set by the | |||
<a href="setproxy.html"><code><setproxy></code></a> task, and cannot go through | |||
a firewall via socks. | |||
<p> | |||
<b>Warning:</b> there have been problems reported concerning the ftp get with the <code>newer</code> attribute. | |||
<strong>Warning:</strong> there have been problems reported concerning the ftp get with the <code>newer</code> attribute. | |||
Problems might be due to format of <code>ls -l</code> differing from what is expected by commons-net, | |||
for instance due to specificities of language used by the ftp server in the directory listing. | |||
If you encounter such a problem, please send an email including a sample directory listing | |||
@@ -219,13 +219,13 @@ try to set up a new connection.</p> | |||
<td valign="top">preservelastmodified</td> | |||
<td valign="top">Give the copied files the same last modified | |||
time as the original source files (applies to getting files only). | |||
(<em>Note</em>: Ignored on Java 1.1)</td> | |||
(<strong>Note</strong>: Ignored on Java 1.1)</td> | |||
<td valign="top" align="center">No; defaults to false.</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">retriesAllowed</td> | |||
<td valign="top">Set the number of retries allowed on an file-transfer operation. | |||
If a number > 0 specified, each file transfer can fail up to that | |||
If a number > 0 specified, each file transfer can fail up to that | |||
many times before the operation is failed. If -1 or "forever" specified, the | |||
operation will keep trying until it succeeds.</td> | |||
<td valign="top" align="center">No; defaults to 0</td> | |||
@@ -33,13 +33,13 @@ the runtime is valid here, including http:, ftp: and jar:; | |||
The <i>usetimestamp</i> option enables you to control downloads so that the remote file is | |||
only fetched if newer than the local copy. If there is no local copy, the download always takes | |||
place. When a file is downloaded, the timestamp of the downloaded file is set to the remote timestamp. | |||
NB: This timestamp facility only works on downloads using the HTTP protocol. | |||
<strong>Note</strong>: This timestamp facility only works on downloads using the HTTP protocol. | |||
<p> | |||
A username and password can be specified, in which case basic 'slightly encoded | |||
plain text' authentication is used. This is only secure over an HTTPS link. | |||
</p> | |||
<p><b>Proxies</b>. Since Apache Ant 1.7.0, Ant running on Java 5 or later can | |||
<p><b>Proxies</b>. <em>Since Apache Ant 1.7.0</em>, Ant running on Java 5 or later can | |||
<a href="../proxy.html">use the proxy settings of the operating | |||
system</a> if enabled with the | |||
<code>-autoproxy</code> option. There is also the | |||
@@ -124,7 +124,7 @@ plain text' authentication is used. This is only secure over an HTTPS link. | |||
<td valign="top">httpusecaches</td> | |||
<td valign="top">HTTP only - if true, allow caching at the | |||
HttpUrlConnection level. if false, turn caching off.<br/> | |||
<b>Note</b> this is only a hint to the underlying UrlConnection | |||
<strong>Note</strong> this is only a hint to the underlying UrlConnection | |||
class, implementations and proxies are free to ignore the | |||
setting.</td> | |||
<td align="center" valign="top">No; default "true"</td> | |||
@@ -35,7 +35,7 @@ | |||
</p> | |||
<p> | |||
<b>Note</b> as seen above, this task heavily relies on the ProjectHelper | |||
<strong>Note</strong> as seen above, this task heavily relies on the ProjectHelper | |||
implementation and doesn't really perform any work of its own. If | |||
you have configured Apache Ant to use a ProjectHelper other than Ant's | |||
default, this task may or may not work. | |||
@@ -176,7 +176,7 @@ project).</p> | |||
</td> | |||
<td valign="top"> | |||
The file to import. If this is a relative file name, the file name will be resolved | |||
relative to the <i>importing</i> file. <b>Note</b>, this is unlike most other | |||
relative to the <i>importing</i> file. <strong>Note</strong>: this is unlike most other | |||
Ant file attributes, where relative files are resolved relative to ${basedir}. | |||
</td> | |||
<td valign="top" align="center">Yes or a nested resource collection</td> | |||
@@ -30,7 +30,7 @@ | |||
<p><em>since Apache Ant 1.8.0</em></p> | |||
<p> | |||
<b>Note</b> this task heavily relies on the ProjectHelper | |||
<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. | |||
@@ -171,7 +171,7 @@ project).</p> | |||
</td> | |||
<td valign="top"> | |||
The file to include. If this is a relative file name, the file name will be resolved | |||
relative to the <i>including</i> file. <b>Note</b>, this is unlike most other | |||
relative to the <i>including</i> file. <strong>Note</strong>, this is unlike most other | |||
ant file attributes, where relative files are resolved relative to ${basedir}. | |||
</td> | |||
<td valign="top" align="center">Yes or a nested resource collection</td> | |||
@@ -99,7 +99,7 @@ file and load in before the input task.</p> | |||
</table> | |||
<h3>Parameters Specified as Nested Elements</h3> | |||
<h4>Handler</h4> | |||
<p>Since <b>Ant 1.7</b>, a nested <handler> element can be used to | |||
<p><em>Since Ant 1.7</em>, a nested <handler> element can be used to | |||
specify an InputHandler, so that different InputHandlers may be used | |||
among different Input tasks.</p> | |||
@@ -111,7 +111,7 @@ among different Input tasks.</p> | |||
</tr> | |||
<tr id="handler.type"> | |||
<td valign="top">type</td> | |||
<td valign="top">one of "default","propertyfile", "greedy", or "secure" (since Ant 1.8). | |||
<td valign="top">one of "default","propertyfile", "greedy", or "secure" (<em>since Ant 1.8</em>). | |||
</td> | |||
<td align="center" valign="top" rowspan="3">One of these</td> | |||
</tr> | |||
@@ -90,9 +90,9 @@ to a value other than its default, <code>"add"</code>.</b></p> | |||
<p>To cryptographically sign your JAR file, use the <a href="signjar.html">SignJar task</a> on the JAR that you create from this task.</p> | |||
<p>For creating a simple version of a <a target="_blank" href="http://openjdk.java.net/jeps/238">JEP-238 multi release jar</a>, | |||
<p>For creating a simple version of a <a target="_blank" href="http://openjdk.java.net/jeps/238">JEP 238 multi-release jar</a>, | |||
you don't need any special tools. Just set the required manifest entry and place the files where required, as you could see | |||
in the <a href="#jep238-example">JEP238-example</a>. If you want to tune this kind of jar, e.g. decreasing the size by deleting | |||
in the <a href="#jep238-example">JEP 238 example</a>. If you want to tune this kind of jar, e.g. decreasing the size by deleting | |||
'same' classes from the versions-branches, you have to do more ...</p> | |||
<h3>Parameters</h3> | |||
@@ -273,7 +273,7 @@ in the <a href="#jep238-example">JEP238-example</a>. If you want to tune this ki | |||
that the permissions haven't been stored at all rather than real | |||
permissions and will instead apply its own default values.<br/> | |||
Set this attribute to true if you really want to preserve the | |||
original permission field.<em>since Ant 1.8.0</em> | |||
original permission field. <em>since Ant 1.8.0</em> | |||
</td> | |||
<td valign="top" align="center">No, default is false</td> | |||
</tr> | |||
@@ -585,10 +585,10 @@ Sealed: false</code></pre></blockquote> | |||
</pre></blockquote> | |||
<h4 id="jep238-example">JEP238 example: a Multi-Release JAR Files</h4> | |||
<h4 id="jep238-example">JEP 238 example: a Multi-Release JAR Files</h4> | |||
<p> | |||
Here we want to create a <i>Multi-Release JAR File</i> according the specification | |||
<a target="_blank" href="http://openjdk.java.net/jeps/238">JEP-238</a>. | |||
<a target="_blank" href="http://openjdk.java.net/jeps/238">JEP 238</a>. | |||
It defines on top of a JAR the possibility to place additional or overwriting classes | |||
in a jar, which are available according to the Java version you run.<br> | |||
Basically it sais, that you have to set the manifest entry <tt>Multi-Release: true</tt> | |||
@@ -122,12 +122,12 @@ attributes.</p> | |||
<td valign="top">module</td> | |||
<td valign="top">The initial or main module to resolve. To specify | |||
the module main class use the <a href="#classname">classname</a> attribute. | |||
Fork must be set to true if this option is selected.<em>since Ant 1.9.7</em></td> | |||
Fork must be set to true if this option is selected. <em>since Ant 1.9.7</em></td> | |||
<td align="center" valign="top">Either <tt>jar</tt>, <tt>classname</tt> or <tt>module</tt></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">modulepath</td> | |||
<td valign="top">Specify where to find application modules. A list of directories of modules, module files or exploded modules.<em>since Ant 1.9.7</em></td> | |||
<td valign="top">Specify where to find application modules. A list of directories of modules, module files or exploded modules. <em>since Ant 1.9.7</em></td> | |||
<td align="center" valign="top">No</td> | |||
</tr> | |||
<tr> | |||
@@ -283,7 +283,7 @@ see <a href="../Types/permissions.html">permissions</a></p> | |||
<p>When the permission RuntimePermission exitVM has not been granted (or has | |||
been revoked) the System.exit() call will be intercepted | |||
and treated like indicated in <i>failonerror</i>.</p> | |||
<p>Note:<br> | |||
<p><strong>Note</strong>:<br> | |||
If you do not specify permissions, | |||
a set of default permissions will be added to your Java invocation to make | |||
sure that the Ant run will continue or terminated as indicated by | |||
@@ -303,7 +303,7 @@ subelement.</p> | |||
<p>Assertion statements are currently ignored in non-forked mode.</p> | |||
<p><em>since Ant 1.6.</em></p> | |||
<p><em>since Ant 1.6</em>.</p> | |||
<h4 id="redirector">redirector</h4> | |||
<em>Since Ant 1.6.2</em> | |||
@@ -32,7 +32,7 @@ source files to compile. Only Java files that have no corresponding | |||
<code>.class</code> file | |||
or where the class file is older than the | |||
<code>.java</code> file will be compiled.</p> | |||
<p>Note: Apache Ant uses only the names of the source and class files to find | |||
<p><strong>Note</strong>: Apache Ant uses only the names of the source and class files to find | |||
the classes that need a rebuild. It will not scan the source and therefore | |||
will have no knowledge about nested classes, classes that are named different | |||
from the source file, and so on. See the | |||
@@ -120,7 +120,7 @@ switch <code>-depend</code> instead of <code>-Xdepend</code>.</p> | |||
files/directories from the classpath it passes to the compiler.</p> | |||
<p>The working directory for a forked executable (if any) is the | |||
project's base directory.</p> | |||
<p><strong>Windows Note:</strong>When the modern compiler is used | |||
<p><strong>Windows Note</strong>: When the modern compiler is used | |||
in unforked mode on Windows, it locks up the files present in the | |||
classpath of the <code><javac></code> task, and does not release them. | |||
The side effect of this is that you will not be able to delete or move | |||
@@ -224,7 +224,7 @@ invoking the compiler.</p> | |||
</tr> | |||
<tr> | |||
<td valign="top">encoding</td> | |||
<td valign="top">Encoding of source files. (Note: gcj doesn't support | |||
<td valign="top">Encoding of source files. (<strong>Note</strong>: gcj doesn't support | |||
this option yet.)</td> | |||
<td align="center" valign="top">No</td> | |||
</tr> | |||
@@ -319,7 +319,7 @@ invoking the compiler.</p> | |||
<td valign="top">Whether to include the default run-time | |||
libraries from the executing VM in the classpath; | |||
defaults to <code>no</code>.<br/> | |||
<b>Note:</b> In some setups the run-time libraries may be part | |||
<strong>Note</strong>: In some setups the run-time libraries may be part | |||
of the "Ant run-time libraries" so you may need to explicitly | |||
set includeAntRuntime to false to ensure that the Java | |||
run-time libraries are not included.</td> | |||
@@ -337,7 +337,7 @@ invoking the compiler.</p> | |||
executable to use in case of <code>fork="yes"</code>. | |||
Defaults to the compiler of the Java version that is currently | |||
running Ant. Ignored if <code>fork="no"</code>.<br> | |||
Since Ant 1.6 this attribute can also be used to specify the | |||
<em>Since Ant 1.6</em> this attribute can also be used to specify the | |||
path to the executable when using jikes, jvc, gcj or sj.</td> | |||
<td align="center" valign="top">No</td> | |||
</tr> | |||
@@ -461,8 +461,8 @@ invoking the compiler.</p> | |||
Some package level annotations in <code>package-info.java</code> | |||
files don't create any <code>package-info.class</code> files so | |||
Ant would recompile the same file every time.<br/> | |||
Starting with Ant 1.8 Ant will create an | |||
empty <code>package-info.class</code> for | |||
<em>Since Ant 1.8</em>, an | |||
empty <code>package-info.class</code> is created for | |||
each <code>package-info.java</code> if there isn't one created | |||
by the compiler.<br/> | |||
In some setups this additional class causes problems and it can | |||
@@ -594,7 +594,7 @@ used.</p> | |||
<td valign="top">prefix</td> | |||
<td align="center" rowspan="2">See | |||
<a href="../using.html#arg">Command-line Arguments</a>. | |||
<em>Since Ant 1.8.</em></td> | |||
<em>Since Ant 1.8</em>.</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
<tr> | |||
@@ -612,7 +612,7 @@ used.</p> | |||
</tr> | |||
</table> | |||
<h4>compilerclasspath <em>since Ant 1.8.0</em></h4> | |||
<h4>compilerclasspath (<em>since Ant 1.8.0</em>)</h4> | |||
<p>A <a href="../using.html#path">PATH like structure</a> holding the | |||
classpath to use when loading the compiler implementation if a | |||
@@ -620,7 +620,7 @@ used.</p> | |||
using one of the built-in compilers.</p> | |||
<h4>Any nested element of a type that implements CompilerAdapter | |||
<em>since Ant 1.8.0</em></h4> | |||
(<em>since Ant 1.8.0</em>)</h4> | |||
<p>If a defined type implements the <code>CompilerAdapter</code> | |||
interface a nested element of that type can be used as an | |||
@@ -713,7 +713,7 @@ Java VM of a different version:</p> | |||
executable="/opt/java/jdk1.1/bin/javac" | |||
compiler="javac1.1"/></pre> | |||
<p id="srcdirnote"><b>Note:</b> | |||
<p id="srcdirnote"><strong>Note</strong>: | |||
If you wish to compile only source files located in certain packages below a | |||
common root, use the <code>include</code>/<code>exclude</code> attributes | |||
or <code><include></code>/<code><exclude></code> nested elements | |||
@@ -748,7 +748,7 @@ could show in the log, that these settings are fix.</p> | |||
fork="true" | |||
taskname="javac1.4"/></pre> | |||
<p><b>Note:</b> If you are using Ant on Windows and a new DOS window pops up | |||
<p><strong>Note</strong>: If you are using Ant on Windows and a new DOS window pops up | |||
for every use of an external compiler, this may be a problem of the JDK you are | |||
using. This problem may occur with all JDKs < 1.2.</p> | |||
@@ -887,8 +887,8 @@ while all others are <code>false</code>.</p> | |||
The Sun javac compiler has a <em>bootclasspath</em> command | |||
line option - this corresponds to the "bootclasspath" attribute/element | |||
of the <javac> task. The Sun compiler also allows more | |||
control over the boot classpath using the -X and -J-X attributes. | |||
One can set these by using the <compilerarg>. Since Ant 1.6.0, | |||
control over the boot classpath using the <code>-X</code> and <code>-J-X</code> attributes. | |||
One can set these by using the <compilerarg>. <em>Since Ant 1.6.0</em>, | |||
there is a shortcut to convert path references to strings that | |||
can by used in an OS independent fashion (see | |||
<a href="../using.html#pathshortcut">pathshortcut</a>). For example: | |||
@@ -934,7 +934,7 @@ while all others are <code>false</code>.</p> | |||
<code>package-info.java</code> files were introduced in Java 5 to | |||
allow package level annotations. On compilation, if the java file | |||
does not contain runtime annotations, there will be no .class file | |||
for the java file. Up to <b>Ant 1.7.1</b>, when the <javac> | |||
for the java file. Prior to Ant 1.7.1, when the <javac> | |||
task is run again, the | |||
task will try to compile the package-info java files again. | |||
</p> | |||
@@ -942,8 +942,8 @@ while all others are <code>false</code>.</p> | |||
involved the timestamp of the directory that would normally | |||
contain the .class file. This logic turned out to lead to Ant not | |||
recompiling <code>package-info.java</code> in certain setup.</p> | |||
<p>Starting with Ant 1.8.0 Ant will create | |||
"empty" <code>package-info.class</code> files if it compiles | |||
<p><em>Since Ant 1.8.0</em>, an | |||
"empty" <code>package-info.class</code> file is created if Ant compiles | |||
a <code>package-info.java</code> and | |||
no <code>package-info.class</code> file has been created by the | |||
compiler itself.</p> | |||
@@ -35,18 +35,18 @@ and management costs over time. This task, however, has no notion of | |||
"changed" files, unlike the <a href="javac.html">javac</a> task. This means | |||
all packages will be processed each time this task is run. In general, however, | |||
this task is used much less frequently.</p> | |||
<p>NOTE: since javadoc calls System.exit(), javadoc cannot be run inside the | |||
<p><strong>Note</strong>: since javadoc calls System.exit(), javadoc cannot be run inside the | |||
same VM as Apache Ant without breaking functionality. For this reason, this task | |||
always forks the VM. This overhead is not significant since javadoc is normally a heavy | |||
application and will be called infrequently.</p> | |||
<p>NOTE: the packagelist attribute allows you to specify the list of packages to | |||
<p><strong>Note</strong>: the packagelist attribute allows you to specify the list of packages to | |||
document outside of the Ant file. It's a much better practice to include everything | |||
inside the <code>build.xml</code> file. This option was added in order to make it easier to | |||
migrate from regular makefiles, where you would use this option of javadoc. | |||
The packages listed in packagelist are not checked, so the task performs even | |||
if some packages are missing or broken. Use this option if you wish to convert from | |||
an existing makefile. Once things are running you should then switch to the regular | |||
notation. </p> | |||
notation.</p> | |||
<p><i><b>DEPRECATION:</b> the javadoc2 task simply points to the javadoc task and it's | |||
there for back compatibility reasons. Since this task will be removed in future | |||
@@ -59,14 +59,14 @@ any VM of at least version 1.2 is acceptable. JDKs <1.4 are no longer support | |||
If you specify the <code>executable</code> attribute it is up to you | |||
to ensure that this command supports the attributes you wish to use.</p> | |||
<p><b>Note:</b><br>When generating the JavaDocs for classes which contains annotations | |||
<p><strong>Note</strong>:<br>When generating the JavaDocs for classes which contains annotations | |||
you maybe get a <tt>java.lang.ClassCastException: com.sun.tools.javadoc.ClassDocImpl</tt>. | |||
This is due <a href="https://bugs.openjdk.java.net/browse/JDK-6442982" target="_blank">bug-6442982</a>. The cause is that JavaDoc cannot find the implementations of used annotations. | |||
The workaround is providing the jars with these implementations (like JAXBs <tt>@XmlType</tt>, ...) | |||
to <javadoc> using <tt>classpath</tt>, <tt>classpathref</tt> attributes or nested | |||
<classpath> element.</p> | |||
<p><b>Note:</b> many problems with running javadoc stem from command | |||
<p><strong>Note</strong>: many problems with running javadoc stem from command | |||
lines that have become too long - even though the error message | |||
doesn't give the slightest hint this may be the problem. If you | |||
encounter problems with the task, try to set | |||
@@ -208,9 +208,9 @@ to <javadoc> using <tt>classpath</tt>, <tt>classpathref</tt> attributes or | |||
<td valign="top">Old</td> | |||
<td valign="top">Generate output using JDK 1.1 emulating | |||
doclet.<br> | |||
<b>Note:</b> as of Ant 1.8.0 this attribute doesn't have any | |||
effect since the javadoc of Java 1.4 (required by Ant 1.8.0) | |||
doesn't support the -1.1 switch anymore.</td> | |||
<strong>Note</strong>: <em>Since Ant 1.8.0</em> this attribute has no | |||
effect since javadoc of Java 1.4 and later | |||
does not support the -1.1 switch anymore.</td> | |||
<td align="center" valign="top">1.2</td> | |||
<td align="center" valign="top">No</td> | |||
</tr> | |||
@@ -791,12 +791,12 @@ not set the description attribute for those tags.</p> | |||
<a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#javadoctags">Javadoc reference guide</a>: | |||
<pre>ejb.bean:t:XDoclet EJB Tag | |||
todo:a:To Do</pre> | |||
<b>Note:</b> The Javadoc reference quide has double quotes around | |||
<strong>Note</strong>: The Javadoc reference quide has double quotes around | |||
the description part of the definition. This will not work when used in | |||
a file, as the definition is quoted again when given to | |||
the javadoc program. | |||
<br/> | |||
<b>Note:</b> If this attribute is specified, all the other attributes in this | |||
<strong>Note</strong>: If this attribute is specified, all the other attributes in this | |||
element will be ignored. | |||
</td> | |||
<td align="center" valign="top">No</td> | |||
@@ -38,7 +38,7 @@ systems are used.</p> | |||
attribute instead which allows you to compile the classes and | |||
generate the native header files with a single step.</p> | |||
<p><b>Note</b> the <code>javah</code> has been deprecated as of Java 9 | |||
<p><strong>Note</strong>: <code>javah</code> has been deprecated as of Java 9 | |||
and removed as of Java 10. Trying to use it with Java 10 will | |||
fail.</p> | |||
@@ -48,17 +48,17 @@ attribute or a nested element. Here are the choices of the | |||
attribute:</p> | |||
<ul> | |||
<li>default - the default compiler for the platform.</li> | |||
<li>sun (the standard compiler of the JDK)</li> | |||
<li>kaffeh (the native standard compiler of <a href="http://www.kaffe.org" target="_top">Kaffe</a>)</li> | |||
<li>gcjh (the native standard compiler | |||
<li>sun - the standard compiler of the JDK.</li> | |||
<li>kaffeh - the native standard compiler of <a href="http://www.kaffe.org" target="_top">Kaffe</a>.</li> | |||
<li>gcjh - the native standard compiler | |||
of <a href="http://gcc.gnu.org/java/" | |||
target="_top">gcj and gij</a>) <em>since Apache Ant 1.8.2</em></li> | |||
target="_top">gcj and gij</a>. <em>Since Apache Ant 1.8.2</em></li> | |||
<li>forking - runs the javah executable via its command line | |||
interface in a separate process. Default when not running on | |||
Kaffee or gcj/gij <em>since Ant 1.9.8</em></li> | |||
Kaffee or gcj/gij. <em>Since Ant 1.9.8</em></li> | |||
</ul> | |||
<p><b>Note:</b> if you are using this task to work on multiple files | |||
<p><strong>Note</strong>: if you are using this task to work on multiple files | |||
the command line may become too long on some operating systems. | |||
Unfortunately the javah command doesn't support command argument | |||
files the way javac (for example) does, so all that can be done is | |||
@@ -169,7 +169,7 @@ only if a given compiler implementation will be used.</p> | |||
<td valign="top">prefix</td> | |||
<td align="center" rowspan="2">See | |||
<a href="../using.html#arg">Command-line Arguments</a>. | |||
<em>Since Ant 1.8.</em></td> | |||
<em>Since Ant 1.8</em>.</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
<tr> | |||
@@ -186,7 +186,7 @@ only if a given compiler implementation will be used.</p> | |||
</tr> | |||
</table> | |||
<h4>implementationclasspath <em>since Ant 1.8.0</em></h4> | |||
<h4>implementationclasspath (<em>since Ant 1.8.0</em>)</h4> | |||
<p>A <a href="../using.html#path">PATH like structure</a> holding the | |||
classpath to use when loading the compiler implementation if a | |||
@@ -194,7 +194,7 @@ only if a given compiler implementation will be used.</p> | |||
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> | |||
(<em>since Ant 1.8.0</em>)</h4> | |||
<p>If a defined type implements the <code>JavahAdapter</code> | |||
interface a nested element of that type can be used as an | |||
@@ -88,7 +88,7 @@ href="#nested">nested elements</a>.</p> | |||
<tr> | |||
<td valign="top">includeruntime</td> | |||
<td valign="top">Implicitly add the classes required to run jdepend | |||
in forked mode. (Ignored if fork is disabled). Since Apache Ant 1.6.</td> | |||
in forked mode. (Ignored if fork is disabled). <em>Since Apache Ant 1.6</em>.</td> | |||
<td align="center" valign="top">No, default is "no".</td> | |||
</tr> | |||
<tr> | |||
@@ -30,7 +30,7 @@ version of the framework can be found at | |||
This task has been tested with JUnit 3.0 up to JUnit 3.8.2; it won't | |||
work with versions prior to JUnit 3.0. It also works with JUnit 4.0, including | |||
"pure" JUnit 4 tests using only annotations and no <code>JUnit4TestAdapter</code>.</p> | |||
<p><strong>Note:</strong> This task depends on external libraries not included | |||
<p><strong>Note</strong>: This task depends on external libraries not included | |||
in the Apache Ant distribution. See <a href="../install.html#librarydependencies"> | |||
Library Dependencies</a> for more information. | |||
</p> | |||
@@ -58,7 +58,7 @@ a <code><classpath></code> element in a <code><taskdef></code> in th | |||
<li> | |||
Leave <code>ant-junit.jar</code> in its default location in <code>ANT_HOME/lib</code> | |||
but include <code>junit.jar</code> in the <code><classpath></code> passed | |||
to <code><junit></code>. <em>(since Ant 1.7)</em> | |||
to <code><junit></code>. <em>Since Ant 1.7</em> | |||
</li> | |||
</ol> | |||
<p> | |||
@@ -108,7 +108,7 @@ elements</a>).</p> | |||
<code>failureproperty</code> can share a VM, so even if you set | |||
<code>forkmode</code> to "once", Ant may have to create | |||
more than a single Java VM. This attribute is ignored for tests | |||
that don't get forked into a new Java VM. <em>since Ant 1.6.2</em></td> | |||
that don't get forked into a new Java VM. <em>Since Ant 1.6.2</em></td> | |||
<td align="center" valign="top">No; default is <code>perTest</code>.</td> | |||
</tr> | |||
<tr> | |||
@@ -196,7 +196,7 @@ elements</a>).</p> | |||
<tr> | |||
<td valign="top">outputtoformatters</td> | |||
<td valign="top"> | |||
<em>Since Ant 1.7.0.</em><br/> | |||
<em>Since Ant 1.7.0</em>.<br/> | |||
Send any output generated by tests to the test formatters. | |||
This is "true" by default. | |||
</td> | |||
@@ -369,7 +369,7 @@ subelement.</p> | |||
<p>Assertion statements are currently ignored in non-forked mode.</p> | |||
<p><em>since Ant 1.6.</em></p> | |||
<p><em>Since Ant 1.6</em>.</p> | |||
<h4>modulepath</h4> | |||
@@ -407,7 +407,7 @@ can be specified.</p> | |||
that your tests have written as some characters are illegal in XML | |||
documents and will be dropped.</p> | |||
<p>The fourth formatter named <code>failure</code> (since Ant 1.8.0) | |||
<p>The fourth formatter named <code>failure</code> (<em>since Ant 1.8.0</em>) | |||
collects all failing <code>testXXX()</code> | |||
methods and creates a new <code>TestCase</code> which delegates only these | |||
failing methods. The name and the location can be specified via Java System property or Ant property | |||
@@ -664,7 +664,7 @@ supported.</p> | |||
test's <code>tearDown</code> method will never be called. The same | |||
is true if the forked VM crashes for some other reason.</p> | |||
<p>Starting with Ant 1.8.0, a special formatter is distributed with | |||
<p><em>Since Ant 1.8.0</em>, a special formatter is distributed with | |||
Ant that tries to load the testcase that was in the forked VM and | |||
invoke that class' <code>tearDown</code> method. This formatter has | |||
the following limitations:</p> | |||
@@ -28,7 +28,7 @@ Merge the individual XML files generated by the JUnit task and eventually apply | |||
a stylesheet on the resulting merged document to provide a browsable report of | |||
the testcases results. | |||
<p><strong>Note:</strong> This task depends on external libraries not | |||
<p><strong>Note</strong>: This task depends on external libraries not | |||
included in the Apache Ant distribution. See <a href="../install.html#librarydependencies">Library Dependencies</a> | |||
for more information.</p> | |||
@@ -36,9 +36,9 @@ for more information.</p> | |||
<p>The task needs Apache <a | |||
href="http://xml.apache.org/xalan-j/">Xalan 2.4.1+ or Xalan XSLTC</a> | |||
(JDK 1.4 contains a version of Xalan-J 2.x while JDK 1.5 ships with a | |||
version of XSLTC). Starting from JDK 1.4.2-01 it ships with a bundled | |||
Xalan-J 2.4.1+, meaning that JDK version prior to 1.4.2-01 won't work | |||
(JDK 1.4 contains a version of Xalan 2.x, while JDK 1.5 ships with a | |||
version of XSLTC). Since version 1.4.2-01, JDK ships with a bundled | |||
Xalan 2.4.1+, meaning that JDK version prior to 1.4.2-01 won't work | |||
out of the box. The table below summarize the compatibility status. | |||
</p> | |||
<table> | |||
@@ -46,13 +46,13 @@ out of the box. The table below summarize the compatibility status. | |||
<tr><td>2.4.1+</td><td>JDK 1.4.2-01+</td><td>OK</td></tr> | |||
<tr><td>XSLTC</td><td>JDK 1.5.x</td><td>OK</td></tr> | |||
<tr><td>2.x</td><td>JDK 1.4.x</td><td>DEPRECATED<br><i>Use ${ant.home}/etc/junit-frames-xalan1.xsl | |||
<br> Upgrade Xalan using the JDK endorsement mechanism</i></td></tr> | |||
<br>Upgrade Xalan using the JDK endorsement mechanism</i></td></tr> | |||
</table> | |||
<p>With Ant 1.6.2 we had to decide between supporting Xalan-J 1/Xalan J 2.4.1- | |||
<p>In Ant 1.6.2, we had to decide between supporting Xalan 1/Xalan 2.4.1- | |||
and Xalan 2.4.1+/XSLTC, since there was no way to support both couples at the same | |||
time.</p> | |||
<p>With Ant 1.7 we had to drop support Xalan-J 1, since Xalan-J 1 has not | |||
<p><em>Since Ant 1.7</em>, we dropped support for Xalan 1, since Xalan 1 was not | |||
available anymore for quite some time.</p> | |||
<h3>Parameters</h3> | |||
@@ -170,12 +170,12 @@ These tags can pass XSL parameters to the stylesheet. | |||
</table> | |||
<h4>classpath</h4> | |||
<p><em>Since Ant 1.9.5.</em> | |||
<p><em>Since Ant 1.9.5</em>. | |||
Like for the <a href="../CoreTasks/style.html#classpath">XSLT task</a>, | |||
a nested <classpath> will be used to load the processor.</p> | |||
<h4>factory</h4> | |||
<p><em>Since Ant 1.9.5.</em> | |||
<p><em>Since Ant 1.9.5</em>. | |||
Like for the <a href="../CoreTasks/style.html#factory">XSLT task</a>, | |||
a nested <factory> can be used to specify factory settings.</p> | |||
@@ -68,7 +68,7 @@ the property is not set.</p> | |||
invoked with the <code>-verbose</code> or <code>-debug</code> | |||
switches) or modify the exit status to reflect an error. Setting this to | |||
"true" implies setting failonerror to "false". | |||
<em>Since Ant 1.7.0.</em> | |||
<em>Since Ant 1.7.0</em>. | |||
</td> | |||
<td align="center" valign="top">No, default "false"</td> | |||
</tr> | |||
@@ -33,7 +33,7 @@ Also if the file is missing, the build is halted with an error, rather | |||
than a warning being printed. | |||
</p> | |||
<p><strong>Note:</strong> the default value of this | |||
<p><strong>Note</strong>: the default value of this | |||
task's <code>prefixValues</code> attribute is different from the | |||
default value of the same attribute in | |||
the <a href="property.html"><code><property></code></a> | |||
@@ -34,7 +34,7 @@ property at a given scope "shadows" properties of the same name at higher scopes | |||
including the global scope. Note that using the Local 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. <b>Since Ant 1.8</b></p> | |||
in the buildfile. <em>Since Ant 1.8</em></p> | |||
<p>A property is made local if the <code><local></code> task | |||
precedes its definition. See the examples section.</p> | |||
@@ -195,7 +195,7 @@ | |||
If this element is not present, then any nested text in the macro invocation | |||
will be an error. If the text element is present, then the name | |||
becomes an attribute that gets set to the nested text of the macro invocation. | |||
<em>Since ant 1.6.1.</em> | |||
<em>Since ant 1.6.1</em>. | |||
</p> | |||
<p> | |||
The case of the text name is ignored. | |||
@@ -48,7 +48,7 @@ | |||
<code><attachments></code> container. | |||
</p> | |||
<p> | |||
<strong>Note:</strong> This task may depend on external libraries | |||
<strong>Note</strong>: This task may depend on external libraries | |||
that are not included in the Ant distribution. | |||
See <a href="../install.html#librarydependencies">Library Dependencies</a> | |||
for more information. | |||
@@ -284,7 +284,7 @@ in the message, whether it is specified as an external file or as text within | |||
the <code><message></code> element.</p> | |||
<h4>header</h4> | |||
<p><strong>Since Ant 1.7</strong>, arbitrary mail headers can be added by | |||
<p><em>Since Ant 1.7</em>, arbitrary mail headers can be added by | |||
specifying these attributes on one or more nested header elements:</p> | |||
<table> | |||
@@ -305,8 +305,7 @@ the <code><message></code> element.</p> | |||
</tr> | |||
</table> | |||
<p>It is permissible to duplicate the name attribute amongst multiple headers. | |||
</p> | |||
<p>It is permissible to duplicate the name attribute amongst multiple headers.</p> | |||
<h3>Examples</h3> | |||
@@ -42,7 +42,7 @@ href="../using.html#path">path</a>. Prior to Apache Ant 1.7 only | |||
To use a resource collection, the <code>todir</code> attribute must be | |||
set.</p> | |||
<p><b>Since Ant 1.6.3</b>, the <i>file</i> attribute may be used to move | |||
<p><em>Since Ant 1.6.3</em>, the <i>file</i> attribute may be used to move | |||
(rename) an entire directory. If <i>tofile</i> denotes an existing file, or | |||
there is a directory by the same name in <i>todir</i>, the action will fail. | |||
</p> | |||
@@ -63,7 +63,7 @@ there is a directory by the same name in <i>todir</i>, the action will fail. | |||
<td valign="top">preservelastmodified</td> | |||
<td valign="top">Give the moved files the same last modified | |||
time as the original source files. | |||
(<em>Note</em>: Ignored on Java 1.1)</td> | |||
(<strong>Note</strong>: Ignored on Java 1.1)</td> | |||
<td valign="top" align="center">No; defaults to false.</td> | |||
</tr> | |||
<tr> | |||
@@ -65,11 +65,11 @@ | |||
element. Here are the choices of the attribute: | |||
</p> | |||
<ul> | |||
<li>default - the default converter for the platform - kaffee | |||
<li>default - the default converter for the platform: kaffee | |||
when run on Kaffee, builtin otherwise.</li> | |||
<li>sun (used to be the standard converter of the JDK < 9)</li> | |||
<li>kaffe (the standard converter | |||
of <a href="http://www.kaffe.org" target="_top">Kaffe</a>)</li> | |||
<li>sun - used to be the standard converter of the JDK < 9</li> | |||
<li>kaffe - the standard converter | |||
of <a href="http://www.kaffe.org" target="_top">Kaffe</a></li> | |||
<li>builtin - Ant's internal implementation. <em>Since Ant | |||
1.9.8</em></li> | |||
</ul> | |||
@@ -191,7 +191,7 @@ only if a given converter implementation will be used.</p> | |||
</tr> | |||
</table> | |||
<h4>implementationclasspath <em>since Apache Ant 1.8.0</em></h4> | |||
<h4>implementationclasspath (<em>since Apache Ant 1.8.0</em>)</h4> | |||
<p>A <a href="../using.html#path">PATH like structure</a> holding the | |||
classpath to use when loading the converter implementation if a | |||
@@ -199,7 +199,7 @@ only if a given converter implementation will be used.</p> | |||
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> | |||
(<em>since Ant 1.8.0</em>)</h4> | |||
<p>If a defined type implements the <code>Native2AsciiAdapter</code> | |||
interface a nested element of that type can be used as an | |||
@@ -58,7 +58,7 @@ supports most attributes of <code><fileset></code> | |||
or from the command line as<br> | |||
<code>ant -Dant.netrexxc.verbose=noverbose ...</code> | |||
</p> | |||
<p><strong>Note:</strong> This task depends on external libraries not | |||
<p><strong>Note</strong>: This task depends on external libraries not | |||
included in the Apache Ant distribution. See <a href="../install.html#librarydependencies">Library Dependencies</a> | |||
for more information.</p> | |||
@@ -32,7 +32,7 @@ | |||
PropertyHelper active on the current Project. 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. | |||
<b>Since Ant 1.8.0</b></p> | |||
<em>Since Ant 1.8.0</em></p> | |||
<h3>Parameters specified as nested elements</h3> | |||
@@ -24,7 +24,7 @@ | |||
<h1>Apache Ant Pvcs Task User Manual</h1> | |||
<p><b>Note:</b> | |||
<p><strong>Note</strong>: | |||
Before using this task, the user running Ant must have access to the | |||
commands of PVCS (get and pcli) and must have access to the | |||
repository. Note that the way to specify the repository is platform | |||
@@ -123,13 +123,13 @@ have been regenerated by this task.</p> | |||
<tr> | |||
<td valign="top">preserveLastModified</td> | |||
<td valign="top">Keep the file timestamp(s) even if the file(s) | |||
is(are) modified. <em>since Apache Ant 1.8.0.</em></td> | |||
is(are) modified. <em>since Apache Ant 1.8.0</em>.</td> | |||
<td valign="top" align="center">No, defaults to false</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">failOnNoReplacements</td> | |||
<td valign="top">Whether to fail the build if the task didn't do | |||
anything. <em>since Ant 1.8.0.</em></td> | |||
anything. <em>since Ant 1.8.0</em>.</td> | |||
<td valign="top" align="center">No, defaults to false</td> | |||
</tr> | |||
</table> | |||
@@ -159,7 +159,7 @@ them.</p> | |||
<tr> | |||
<td valign="top">expandProperties</td> | |||
<td valign="top">Whether to expand properties in the nested text. | |||
<em>since Ant 1.8.0.</em></td> | |||
<em>since Ant 1.8.0</em>.</td> | |||
<td align="center">No, defaults to true.</td> | |||
</tr> | |||
</table> | |||
@@ -208,7 +208,7 @@ token]]></replacevalue> | |||
<td valign="top">Name of the property whose value is to serve as the replacement value.</td> | |||
</tr> | |||
</table> | |||
<p>Since Ant 1.8.0 token and value can be specified as nested elements | |||
<p><em>Since Ant 1.8.0</em> token and value can be specified as nested elements | |||
just like in the task itself.</p> | |||
<p>If neither <i>value</i> nor <i>property</i> is used, the value provided using the <code><replace></code> attribute <i>value</i> and/or the <code><replacevalue></code> element is used. If no value was specified using either of these options, the token is replaced with an empty string. | |||
</p> | |||
@@ -233,9 +233,7 @@ token]]></replacevalue> | |||
</replace> | |||
</pre></blockquote> | |||
<p>In file <code>configure.sh</code>, replace all instances of "@token1@" with "defaultvalue", all instances of "@token2@" with "value2", and all instances of "@token3@" with the value of the property "property.key", as it appears in property file <code>src/name.properties</code>.</p> | |||
<p><b>Note:</b> It is possible to use either the <i>token</i>/<code><replacetoken></code> and <i>value</i>/<code><replacevalue></code> attributes/elements, the nested replacefilter elements, or both in the same operation. | |||
</p> | |||
<p><strong>Note</strong>: It is possible to use either the <i>token</i>/<code><replacetoken></code> and <i>value</i>/<code><replacevalue></code> attributes/elements, the nested replacefilter elements, or both in the same operation.</p> | |||
</body> | |||
</html> |
@@ -90,7 +90,7 @@ See details in the documentation of the <a href="../Types/regexp.html#implementa | |||
<tr> | |||
<td valign="top">preserveLastModified</td> | |||
<td valign="top">Keep the file timestamp(s) even if the file(s) | |||
is(are) modified. <em>since Ant 1.8.0.</em></td> | |||
is(are) modified. <em>since Ant 1.8.0</em>.</td> | |||
<td valign="top" align="center">No, defaults to false</td> | |||
</tr> | |||
</table> | |||
@@ -29,7 +29,7 @@ | |||
<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. <b>Since Apache Ant 1.7</b></p> | |||
Can also be used as a condition. <em>Since Apache Ant 1.7</em></p> | |||
<h3>Parameters</h3> | |||
<table> | |||
<tr> | |||
@@ -30,7 +30,7 @@ Task to automate a remote rexec session. Just like the Telnet task, | |||
it uses nested <tt><read></tt> to indicate strings to wait for, and | |||
<tt><write></tt> tags to specify text to send to the remote process. | |||
<p><b>Note:</b> This task depends on external libraries not included in the Apache Ant distribution. | |||
<p><strong>Note</strong>: This task depends on external libraries not included in the Apache Ant distribution. | |||
See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> | |||
<p>You can specify the commands you want to execute as nested elements | |||
@@ -52,17 +52,15 @@ with the "build.rmic" property, the <code>compiler</code> | |||
attribute, or a nested element. Here are the choices:</p> | |||
<ul> | |||
<li>default -the default compiler (kaffe, sun or forking) for the platform. | |||
<li>sun (the standard compiler of the JDK < JDK 9)</li> | |||
<li>kaffe (the standard compiler of <a href="http://www.kaffe.org" target="_top">Kaffe</a>)</li> | |||
<li>sun - the standard compiler of the JDK < 9</li> | |||
<li>kaffe - the standard compiler of <a href="http://www.kaffe.org" target="_top">Kaffe</a></li> | |||
<li>weblogic</li> | |||
<li>forking - the sun compiler forked into a separate process (since | |||
Apache Ant 1.7). Starting with Ant 1.9.8 this is the default when | |||
running on JDK 9+.</li> | |||
<li>xnew - the sun compiler forked into a separate process, | |||
with the -Xnew option (since Ant 1.7). | |||
This is the most reliable way to use -Xnew. | |||
<br>JDK 9 has removed support for -Xnew and starting with Ant | |||
1.9.8 this option will be rejected by Ant when running on JDK 9.</li> | |||
<li>forking - (<em>since Apache Ant 1.7</em>) the sun compiler forked into a separate process. | |||
<em>Since Ant 1.9.8</em>, this is the default when running on JDK 9+.</li> | |||
<li>xnew - (<em>since Ant 1.7</em>) the sun compiler forked into a separate process, | |||
with the -Xnew option. This is the most reliable way to use -Xnew.<br> | |||
JDK 9 has removed support for -Xnew and <em>since Ant 1.9.8</em> | |||
this option will be rejected when running on JDK 9.</li> | |||
<li> "" (empty string). This has the same behaviour as not setting the compiler attribute. | |||
First the value of <tt>build.rmic</tt> is used if defined, and if not, the default | |||
for the platform is chosen. If build.rmic is set to this, you get the default.</li> | |||
@@ -110,7 +108,7 @@ please consult miniRMI's documentation to learn how to use it.</p> | |||
<td valign="top">stubversion</td> | |||
<td valign="top">Specify the JDK version for the generated stub code. | |||
Specify "1.1" to pass the "-v1.1" option to rmic, | |||
"1.2" for -v12, compat for -vcompat. <br> | |||
"1.2" for -v12, compat for -vcompat.<br> | |||
<em>Since Ant 1.7</em>, if you do not specify a version, and do not ask | |||
for iiop or idl files, "compat" is selected. | |||
@@ -287,7 +285,7 @@ used.</p> | |||
<td valign="top">prefix</td> | |||
<td align="center" rowspan="2">See | |||
<a href="../using.html#arg">Command-line Arguments</a>. | |||
<em>Since Ant 1.8.</em></td> | |||
<em>Since Ant 1.8</em>.</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
<tr> | |||
@@ -305,7 +303,7 @@ used.</p> | |||
</tr> | |||
</table> | |||
<h4>compilerclasspath <em>since Ant 1.8.0</em></h4> | |||
<h4>compilerclasspath (<em>since Ant 1.8.0</em>)</h4> | |||
<p>A <a href="../using.html#path">PATH like structure</a> holding the | |||
classpath to use when loading the compiler implementation if a | |||
@@ -313,7 +311,7 @@ used.</p> | |||
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> | |||
(<em>since Ant 1.8.0</em>)</h4> | |||
<p>If a defined type implements the <code>RmicAdapter</code> | |||
interface a nested element of that type can be used as an | |||
@@ -33,7 +33,7 @@ | |||
FileSet <i>only</i> works for copying files from the local machine to a | |||
remote machine.</p> | |||
<p><b>Note:</b> This task depends on external libraries not included | |||
<p><strong>Note</strong>: This task depends on external libraries not included | |||
in the Ant distribution. See <a | |||
href="../install.html#librarydependencies">Library Dependencies</a> | |||
for more information. This task has been tested with jsch-0.1.2 and later.</p> | |||
@@ -121,7 +121,7 @@ for more information. This task has been tested with jsch-0.1.2 and later.</p> | |||
<tr> | |||
<td valign="top">trust</td> | |||
<td valign="top">This trusts all unknown hosts if set to yes/true.<br> | |||
<strong>Note</strong> If you set this to false (the default), the | |||
<strong>Note</strong>: If you set this to false (the default), the | |||
host you connect to must be listed in your knownhosts file, this | |||
also implies that the file exists.</td> | |||
<td valign="top" align="center">No, defaults to No.</td> | |||
@@ -291,7 +291,7 @@ authentication.</b></p> | |||
</scp> | |||
</pre> | |||
<p><strong>Security Note:</strong> Hard coding passwords and/or usernames | |||
<p><strong>Security Note</strong>: Hardcoding passwords and/or usernames | |||
in scp task can be a serious security hole. Consider using variable | |||
substitution and include the password on the command line. For example: | |||
<p> | |||
@@ -309,7 +309,7 @@ system (via the ps command). The best approach is to use the | |||
.properties file. | |||
</p> | |||
<p><strong>Unix Note:</strong> File permissions are not retained when files | |||
<p><strong>Unix Note</strong>: File permissions are not retained when files | |||
are downloaded; they end up with the default <code>UMASK</code> permissions | |||
instead. This is caused by the lack of any means to query or set file | |||
permissions in the current Java runtimes. If you need a permission- | |||
@@ -31,7 +31,7 @@ | |||
or | |||
<a href="https://scripting.dev.java.net">JSR 223</a> supported language. | |||
</p> | |||
<p><b>Note:</b> | |||
<p><strong>Note</strong>: | |||
This task depends on external libraries not included in the Apache Ant distribution. | |||
See <a href="../install.html#librarydependencies">Library Dependencies</a> | |||
for more information. | |||
@@ -82,7 +82,7 @@ different location values.</p> | |||
<tr> | |||
<td valign="top">manager</td> | |||
<td valign="top"> | |||
<em>Since: Ant 1.7.</em> | |||
<em>Since Ant 1.7</em>. | |||
The script engine manager to use. This can have | |||
one of three values ("auto", "bsf" or "javax"). | |||
The default value is "auto". | |||
@@ -104,7 +104,7 @@ different location values.</p> | |||
</tr> | |||
<tr> | |||
<td valign="top">encoding</td> | |||
<td valign="top">The encoding of the script as a file. <em>since Ant 1.10.2.</em></td> | |||
<td valign="top">The encoding of the script as a file. <em>Since Ant 1.10.2</em>.</td> | |||
<td valign="top" align="center">No - defaults to default JVM encoding</td> | |||
</tr> | |||
<tr> | |||
@@ -153,7 +153,7 @@ different location values.</p> | |||
specific jar files. | |||
</p> | |||
<p> | |||
<b>NB: (Since Ant 1.7.1)</b> | |||
<strong>Note</strong>: (<em>since Ant 1.7.1</em>) | |||
This classpath <em>can</em> be used to | |||
specify the location of | |||
the BSF jar file and/or languages | |||
@@ -41,7 +41,7 @@ of the script increases it would be better to migrate the task definition | |||
into a Java based custom task. | |||
</p> | |||
<p><b>Note:</b> This task depends on external libraries not included in the | |||
<p><strong>Note</strong>: This task depends on external libraries not included in the | |||
Ant distribution. See | |||
<a href="../install.html#librarydependencies">Library Dependencies</a> | |||
for more information.</p> | |||
@@ -58,12 +58,12 @@ element name. This will return a list of all instances of the nested element. | |||
The instances in this list may be accessed by an integer index. | |||
</p> | |||
<p><b>Note:</b> Ant will turn all attribute and element names into all | |||
<p><strong>Note</strong>: Ant will turn all attribute and element names into all | |||
lowercase names, so even if you use name="SomeAttribute", you'll have | |||
to use "someattribute" to retrieve the attribute's value from the | |||
<code>attributes</code> collection.</p> | |||
<p>The name "self" (<i>since Ant 1.6.3</i>) is a pre-defined reference to the | |||
<p>The name "self" (<em>since Ant 1.6.3</em>) is a pre-defined reference to the | |||
script def task instance. | |||
It can be used for logging, or for integration with the rest of | |||
Ant. the <code>self.text attribute</code> contains | |||
@@ -117,7 +117,7 @@ more information on writing scripts, please refer to the | |||
</tr> | |||
<tr> | |||
<td valign="top">encoding</td> | |||
<td valign="top">The encoding of the script as a file. <em>since Ant 1.10.2.</em></td> | |||
<td valign="top">The encoding of the script as a file. <em>since Ant 1.10.2</em>.</td> | |||
<td valign="top" align="center">No - defaults to default JVM encoding</td> | |||
</tr> | |||
<tr> | |||
@@ -126,7 +126,7 @@ more information on writing scripts, please refer to the | |||
evaluation for faster multiple executions, on the condition that the <em>manager</em> is "javax" and the | |||
target engine implements <code>javax.script.Compilable</code>. | |||
Note that the <code>bsf</code> manager may automatically compiles the script. | |||
<em>since Ant 1.10.2.</em></td> | |||
<em>since Ant 1.10.2</em>.</td> | |||
<td valign="top" align="center">No - defaults to false</td> | |||
</tr> | |||
<tr> | |||
@@ -25,7 +25,7 @@ | |||
<body> | |||
<h2 id="setpermissions">SetPermissions</h2> | |||
<p><em>Since Ant 1.10.0.</em></p> | |||
<p><em>Since Ant 1.10.0</em>.</p> | |||
<h3>Description</h3> | |||
<p>Changes the file permissions using Java's NIO support for | |||
permissions.</p> | |||
@@ -30,7 +30,7 @@ | |||
the build failed or succeeded. You can specify either a specific | |||
sound-file to play, or, if a directory is specified, the | |||
<code><sound></code> task will randomly select a file to play. | |||
Note: At this point, the random selection is based on all the files | |||
<strong>Note</strong>: At this point, the random selection is based on all the files | |||
in the directory, not just those ending in appropriate suffixes | |||
for sound-files, so be sure you only have sound-files in the | |||
directory you specify.</p> | |||
@@ -124,7 +124,7 @@ and <b>abort</b> execution and transaction and fail task.</p> | |||
<tr> | |||
<td width="12%" valign="top">output</td> | |||
<td width="78%" valign="top">Output file for result sets (defaults to System.out) | |||
<b>Since Ant 1.8</b> can specify any Resource that supports output (see | |||
<em>Since Ant 1.8</em> can specify any Resource that supports output (see | |||
<a href="../develop.html#set-magic">note</a>). | |||
</td> | |||
<td width="10%" valign="top">No (print to System.out by default)</td> | |||
@@ -226,7 +226,7 @@ and <b>abort</b> execution and transaction and fail task.</p> | |||
<td width="12%" valign="top">showWarnings</td> | |||
<td width="78%" valign="top">If true, SQLWarnings will be logged at | |||
the WARN level. <em>Since Ant 1.8.0</em>.<br/> | |||
<b>Note:</b> even if the attribute is set to false, warnings that | |||
<strong>Note</strong>: even if the attribute is set to false, warnings that | |||
apply to the connection will be logged at the verbose level.</td> | |||
<td width="10%" valign="top">No, default <em>false</em></td> | |||
</tr> | |||
@@ -256,7 +256,7 @@ and <b>abort</b> execution and transaction and fail task.</p> | |||
quote character itself will be surrounded by the quote character. | |||
The quote character itself will be doubled if it appears inside of | |||
the column's value.<br/> | |||
<b>Note:</b> BLOB values will never be quoted. | |||
<strong>Note</strong>: BLOB values will never be quoted. | |||
<em>Since Ant 1.8.0</em>.</td> | |||
<td width="10%" valign="top">No, default is not set (i.e. no quoting | |||
ever occurs)</td> | |||
@@ -29,10 +29,9 @@ | |||
<p><em>since Apache Ant 1.6</em></p> | |||
<p>Runs a command on a remote machine running SSH daemon. | |||
</p> | |||
<p>Runs a command on a remote machine running SSH daemon.</p> | |||
<p><b>Note:</b> This task depends on external libraries not included | |||
<p><strong>Note</strong>: This task depends on external libraries not included | |||
in the Ant distribution. See <a | |||
href="../install.html#librarydependencies">Library Dependencies</a> | |||
for more information. This task has been tested with jsch-0.1.29 and above | |||
@@ -78,7 +77,7 @@ and won't work with versions of jsch earlier than | |||
<td valign="top">trust</td> | |||
<td valign="top">This trusts all unknown hosts if set to yes/true.<br> | |||
<strong>Note</strong> If you set this to false (the default), the | |||
<strong>Note</strong>: If you set this to false (the default), the | |||
host you connect to must be listed in your knownhosts file, this | |||
also implies that the file exists.</td> | |||
<td valign="top" align="center">No, defaults to No.</td> | |||
@@ -283,7 +282,7 @@ and won't work with versions of jsch earlier than | |||
commandResource="to_run"/> | |||
</pre> | |||
<p><strong>Security Note:</strong> Hard coding passwords and/or usernames | |||
<p><strong>Security Note</strong>: Hard coding passwords and/or usernames | |||
in sshexec task can be a serious security hole. Consider using variable | |||
substitution and include the password on the command line. For example:</p> | |||
<pre> | |||
@@ -35,7 +35,7 @@ remote tunnels over that connection, then executes any nested tasks | |||
before taking down the connection. | |||
</p> | |||
<p><b>Note:</b> This task depends on external libraries not included | |||
<p><strong>Note</strong>: This task depends on external libraries not included | |||
in the Ant | |||
distribution. See <a href="../install.html#librarydependencies">Library | |||
Dependencies</a> for more information. This task has been tested with | |||
@@ -90,7 +90,7 @@ and <a href="scp.html">scp</a> tasks</p> | |||
<td valign="top">trust</td> | |||
<td valign="top">This trusts all unknown hosts if set to yes/true.<br> | |||
<strong>Note</strong> If you set this to false (the default), the | |||
<strong>Note</strong>: If you set this to false (the default), the | |||
host you connect to must be listed in your knownhosts file, this | |||
also implies that the file exists.</td> | |||
<td valign="top" align="center">No, defaults to No.</td> | |||
@@ -253,8 +253,7 @@ accessible, then run a get task using that tunnel.</b></p> | |||
</sshsession> | |||
</pre> | |||
<p><strong>Security Note:</strong> Hard coding passwords or | |||
<p><strong>Security Note</strong>: Hardcoding passwords or | |||
passphrases and/or usernames in sshsession task can be a serious | |||
security hole. Consider using variable substitution and include the | |||
password on the command line. For example:</p> | |||
@@ -30,7 +30,7 @@ | |||
<p>Process a set of documents via XSLT.</p> | |||
<p>This is useful for building views of XML based documentation, | |||
or for generating code.</p> | |||
<p><b>Note:</b> If you are using JDK 1.4 or higher, this task does not require external libraries | |||
<p><strong>Note</strong>: If you are using JDK 1.4 or higher, this task does not require external libraries | |||
not supplied in the Apache Ant distribution. However, often the built in XSL engine is not as up | |||
to date as a fresh download, so an update is still highly recommended | |||
in particular since the built-in XSLT processors of Java 5 (and to a | |||
@@ -50,7 +50,7 @@ inclusion/exclusion of files works, and how to write patterns.</p> | |||
as well as the nested <code><include></code>, <code><exclude></code> | |||
and <code><patternset></code> elements.</p> | |||
<p><b>Note</b>: Unlike other similar tasks, this task treats | |||
<p><strong>Note</strong>: Unlike other similar tasks, this task treats | |||
directories that have been matched by the include/exclude patterns of | |||
the implicit fileset in a special way. It will apply the stylesheets | |||
to all files contain in them as well. Since the default include | |||
@@ -296,8 +296,8 @@ element is used to perform Entity and URI resolution.</p> | |||
<h4>param</h4> | |||
<p>Param is used to pass a parameter to the XSL stylesheet.</p> | |||
<blockquote> | |||
<h4>Parameters</h4> | |||
<h5>Parameters</h5> | |||
<table> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
@@ -347,9 +347,7 @@ element is used to perform Entity and URI resolution.</p> | |||
<td valign="top">The param will not be passed <a href="../properties.html#if+unless">if this property is set</a>.</td> | |||
<td align="center" valign="top">No</td> | |||
</tr> | |||
</table> | |||
</blockquote> | |||
<p> | |||
The <code>XPATH_*</code> types says that the <code>expression</code> is not just a primitive-type value but an XPath expression. | |||
@@ -367,8 +365,8 @@ element is used to perform Entity and URI resolution.</p> | |||
<p>Used to specify how you wish the result tree to be output | |||
as specified in the <a href="http://www.w3.org/TR/xslt#output"> | |||
XSLT specifications</a>. | |||
<blockquote> | |||
<h4>Parameters</h4> | |||
<h5>Parameters</h5> | |||
<table> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
@@ -386,12 +384,11 @@ XSLT specifications</a>. | |||
<td align="center" valign="top">Yes</td> | |||
</tr> | |||
</table> | |||
</blockquote> | |||
<h4 id="factory">factory ('trax' processors only)</h4> | |||
Used to specify factory settings. | |||
<blockquote> | |||
<h4>Parameters</h4> | |||
<h5>Parameters</h5> | |||
<table> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
@@ -409,8 +406,8 @@ Used to specify factory settings. | |||
<td align="center" valign="top">No. Defaults to the JAXP lookup mechanism.</td> | |||
</tr> | |||
</table> | |||
<h3>Parameters specified as nested elements</h3> | |||
<h4>attribute</h4> | |||
<h5>Parameters specified as nested elements</h5> | |||
<h6>attribute</h6> | |||
<p>Used to specify settings of the processor factory. | |||
The attribute names and values are entirely processor specific | |||
so you must be aware of the implementation to figure them out. | |||
@@ -431,7 +428,7 @@ And in Saxon 7.x: | |||
<li>...</li> | |||
</ul> | |||
<blockquote> | |||
<h4>Parameters</h4> | |||
<h6>Parameters</h6> | |||
<table> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
@@ -460,8 +457,9 @@ And in Saxon 7.x: | |||
with the given id. <em>since Ant 1.9.8</em></td> | |||
</tr> | |||
</table> | |||
</blockquote> | |||
<h4>Examples</h4> | |||
<h5>Examples</h5> | |||
<pre> | |||
<path id="extension-path"> | |||
@@ -478,10 +476,10 @@ And in Saxon 7.x: | |||
</pre> | |||
<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>. | |||
</blockquote> | |||
<h4>feature</h4> | |||
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 specific so you must be aware of the | |||
implementation to figure them out. Read the documentation of your | |||
@@ -489,7 +487,7 @@ processor. The only feature all implementations are required to | |||
support | |||
is <code>http://javax.xml.XMLConstants/feature/secure-processing</code>. | |||
<blockquote> | |||
<h4>Parameters</h4> | |||
<h6>Parameters</h6> | |||
<table> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
@@ -504,12 +502,12 @@ is <code>http://javax.xml.XMLConstants/feature/secure-processing</code>. | |||
<tr> | |||
<td valign="top">value</td> | |||
<td valign="top">value of the feature. A boolean value | |||
(i.e. permitted values are true,false,yes,no,on,off).</td> | |||
(i.e. permitted values are true, false, yes, no, on, off).</td> | |||
<td align="center" valign="top">No, defaults to false</td> | |||
</tr> | |||
</table> | |||
</blockquote> | |||
</blockquote> | |||
<h4>mapper</h4> | |||
<p><em>since Ant 1.6.2</em></p> | |||
@@ -547,7 +545,6 @@ with <a href="../Types/propertyset.html">syspropertyset</a>s.</p> | |||
<p><em>since Ant 1.8.0</em>.</p> | |||
<h3>Examples</h3> | |||
<blockquote> | |||
<pre> | |||
<xslt basedir="doc" destdir="build/doc" | |||
extension=".html" style="style/apache.xsl"/></pre> | |||
@@ -670,8 +667,7 @@ with <a href="../Types/propertyset.html">syspropertyset</a>s.</p> | |||
<project> | |||
<xslt style="printFilename.xsl" destdir="out" basedir="in" extension=".txt" | |||
filenameparameter="filename" | |||
filedirparameter="filedir" | |||
/> | |||
filedirparameter="filedir"/> | |||
</project> | |||
<xsl:stylesheet | |||
@@ -693,11 +689,9 @@ with <a href="../Types/propertyset.html">syspropertyset</a>s.</p> | |||
<pre> | |||
<xslt ...> | |||
<sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration" | |||
value="org.apache.xerces.parsers.XIncludeParserConfiguration" | |||
/> | |||
value="org.apache.xerces.parsers.XIncludeParserConfiguration"/> | |||
<xslt> | |||
</pre> | |||
</blockquote> | |||
</body> | |||
</html> |
@@ -52,7 +52,7 @@ set of links to record, or a set of property files to create links from. | |||
<tr> | |||
<td valign="top">link</td> | |||
<td valign="top">The name of the link to be created or deleted.<br/> | |||
<b>Note</b> this attribute is resolved against the current | |||
<strong>Note</strong>: this attribute is resolved against the current | |||
working directory rather than the project's basedir for | |||
historical reasons. It is recommended you always use an | |||
absolute path or a path like <code>${basedir}/some-path</code> | |||
@@ -124,7 +124,7 @@ set of links to record, or a set of property files to create links from. | |||
<symlink action="delete" link="${dir.top}/foo"/> | |||
</pre> | |||
<p><strong>Java 1.2 and earlier:</strong> Due to limitations on executing system | |||
<p><strong>Java 1.2 and earlier</strong>: Due to limitations on executing system | |||
level commands in Java versions earlier than 1.3 this task may have difficulty | |||
operating with a relative path in ANT_HOME. The typical symptom is an | |||
IOException where Apache Ant can't find /some/working/directory${ANT_HOME}/bin/antRun | |||
@@ -132,7 +132,7 @@ set of links to record, or a set of property files to create links from. | |||
variable to an absolute path, which will remove the /some/working/directory portion | |||
of the above path and allow Ant to find the correct commandline execution script. | |||
<p><strong>NOTE:</strong> Starting Ant version 1.10.2, this task relies on the symbolic | |||
<p><strong>Note</strong>: <em>Since Ant 1.10.2</em>, this task relies on the symbolic | |||
link support introduced in Java 7 through the java.nio.file.Files APIs</p> | |||
</body> | |||
@@ -58,7 +58,7 @@ dir, it will get removed from the target.</p> | |||
<td valign="top">includeEmptyDirs</td> | |||
<td valign="top">Copy any empty directories included in the | |||
resource collection(s).<br/> | |||
<b>Note</b> this attribute also controls the behavior for any | |||
<strong>Note</strong> this attribute also controls the behavior for any | |||
nested <preserveintarget> element. If this attribute is | |||
false (the default) empty directories that only exist in the | |||
target directory will be removed even if they are matched by | |||
@@ -243,11 +243,11 @@ and the rest are use the default mode (read-write by owner). The first | |||
fileset selects just the executable files. The second fileset must exclude | |||
the executable files and include all others.</p> | |||
<p><strong>Note:</strong> The tar task does not ensure that a file is only selected | |||
<p><strong>Note</strong>: The tar task does not ensure that a file is only selected | |||
by one resource collection. If the same file is selected by more than one collection, it will be included in the | |||
tar file twice, with the same path.</p> | |||
<p><strong>Note:</strong> The patterns in the include and exclude | |||
<p><strong>Note</strong>: The patterns in the include and exclude | |||
elements are considered to be relative to the corresponding dir | |||
attribute as with all other filesets. In the example above, | |||
<code>${dist.name}</code> is not an absolute path, but a simple name | |||
@@ -265,7 +265,7 @@ Unix file permissions have been stored as part of the ZIP file, they | |||
will be retained in the resulting tar archive.</p> | |||
<p><strong>Note:</strong> | |||
<p><strong>Note</strong>: | |||
Please note the tar task creates a tar file, it does not append | |||
to an existing tar file. The existing tar file is replaced instead. | |||
As with most tasks in Ant, the task only takes action if the output | |||
@@ -32,7 +32,7 @@ nested <tt><read></tt> to indicate strings to wait for, and | |||
<p>If you do specify a userid and password, the system will | |||
assume a common unix prompt to wait on. This behavior can be easily over-ridden.</p> | |||
<p><b>Note:</b> This task depends on external libraries not included in the Apache Ant distribution. | |||
<p><strong>Note</strong>: This task depends on external libraries not included in the Apache Ant distribution. | |||
See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> | |||
<h3>Parameters</h3> | |||
@@ -32,7 +32,7 @@ at the same time. In addition to working with a single file, this Task | |||
can also work on <a href="../Types/resources.html">resources</a> and | |||
resource collections (which also includes directories). Prior to Apache Ant | |||
1.7 only FileSet or <a href="../Types/filelist.html">Filelist</a> | |||
(since Ant 1.6) have been supported.</p> | |||
(<em>since Ant 1.6</em>) have been supported.</p> | |||
<p>Ant uses the API of <code>java.io.File</code> to set the last | |||
modification time which has some limitations. For example the | |||
@@ -99,7 +99,7 @@ resource collections (which also includes directories). Prior to Apache Ant | |||
<p>You can use any number of nested resource collection elements to | |||
define the resources for this task and refer to resources defined | |||
elsewhere. <b>Note:</b> resources passed to this task must implement | |||
elsewhere. <strong>Note</strong>: resources passed to this task must implement | |||
the <code>org.apache.tools.ant.types.resources.Touchable</code> | |||
interface, this is true for all filesystem-based resources like those | |||
returned by path, fileset ot filelist.</p> | |||
@@ -88,7 +88,7 @@ a single file, this Task can also work on | |||
<p>You can use any number of nested resource collection elements to | |||
define the resources for this task and refer to resources defined | |||
elsewhere. <b>Note:</b> resources passed to this task are expected | |||
elsewhere. <strong>Note</strong>: resources passed to this task are expected | |||
to be filesystem-based.</p> | |||
<h3>Examples</h3> | |||
@@ -91,7 +91,7 @@ archive.</p> | |||
</tr> | |||
<tr> | |||
<td valign="top">compression</td> | |||
<td valign="top"><b>Note:</b> This attribute is only available for | |||
<td valign="top"><strong>Note</strong>: This attribute is only available for | |||
the <code>untar</code> task.<br> | |||
compression method. Allowable values are "none", | |||
"gzip", "xz" and "bzip2". Default is | |||
@@ -130,7 +130,7 @@ archive.</p> | |||
</tr> | |||
<tr> | |||
<td valign="top">scanForUnicodeExtraFields</td> | |||
<td valign="top"><b>Note:</b> This attribute is not available for | |||
<td valign="top"><strong>Note</strong>: This attribute is not available for | |||
the <code>untar</code> task.<br> | |||
If the archive contains uncode extra fields then use them to set | |||
the file names, ignoring the specified encoding. | |||
@@ -82,7 +82,7 @@ target execution depending on the relative age of the specified files.</p> | |||
<a href="../Types/fileset.html">fileset</a> and allows you to | |||
specify a set of files to check against the target file(s).</p> | |||
<p><strong>Note:</strong> You can specify either the <code>srcfile</code> | |||
<p><strong>Note</strong>: You can specify either the <code>srcfile</code> | |||
attribute or nested <code><srcfiles></code> elements, but not both. | |||
<p>Note that the task will completely ignore any directories that seem | |||
@@ -212,7 +212,7 @@ to a value other than its default, <code>"add"</code>.</b></p> | |||
that the permissions haven't been stored at all rather than real | |||
permissions and will instead apply its own default values.<br/> | |||
Set this attribute to true if you really want to preserve the | |||
original permission field.<em>since Ant 1.8.0</em> | |||
original permission field. <em>since Ant 1.8.0</em> | |||
</td> | |||
<td valign="top" align="center">No, default is false</td> | |||
</tr> | |||
@@ -75,7 +75,7 @@ | |||
The classpath to use, given as a | |||
<a href="../using.html#references">reference</a> | |||
to a path defined elsewhere. | |||
<em>Since Apache Ant 1.7.1.</em> | |||
<em>Since Apache Ant 1.7.1</em>. | |||
</td> | |||
<td align="center" valign="top">No</td> | |||
</tr> | |||
@@ -145,7 +145,7 @@ is roughly equivalent to the following fragments in a build.xml file: | |||
</tr> | |||
<tr> | |||
<td valign="top">delimiter</td> | |||
<td valign="top">Delimiter for splitting multiple values.<br><i>since Apache Ant 1.7.1</i></td> | |||
<td valign="top">Delimiter for splitting multiple values.<br><em>since Apache Ant 1.7.1</em></td> | |||
<td valign="top" align="center">No, defaults to comma</td> | |||
</tr> | |||
</table> | |||
@@ -210,7 +210,7 @@ archive.</p> | |||
<td valign="top">Whether the file modification times will be | |||
rounded up to the next even number of seconds.<br> | |||
Zip archives store file modification times with a granularity of | |||
two seconds, so the times will either be rounded up or down. If | |||
two seconds, so the times will either be rounded up or down. If | |||
you round down, the archive will always seem out-of-date when you | |||
rerun the task, so the default is to round up. Rounding up may | |||
lead to a different type of problems like JSPs inside a web | |||
@@ -246,7 +246,7 @@ archive.</p> | |||
<tr> | |||
<td valign="top">useLanguageEncodingFlag</td> | |||
<td valign="top">Whether to set the language encoding flag if the | |||
encoding is UTF-8. This setting doesn't have any effect if the | |||
encoding is UTF-8. This setting doesn't have any effect if the | |||
encoding is not UTF-8. | |||
<em>Since Ant 1.8.0</em>.<br/> | |||
See also the <a href="#encoding">discussion below</a></td> | |||
@@ -301,7 +301,7 @@ archive.</p> | |||
<p>More recent versions of the ZIP specification introduce something | |||
called the "language encoding flag" which can be used to | |||
signal that a file name has been encoded using UTF-8. <em>Since | |||
Ant 1.8.0</em>, all zip-/jar- and similar archives written by Ant will set | |||
Ant 1.8.0</em>, all zip, jar and similar archives written by Ant will set | |||
this flag, if the encoding has been set to UTF-8. Our | |||
interoperability tests with existing archivers didn't show any ill | |||
effects (in fact, most archivers ignore the flag to date), but you | |||
@@ -345,7 +345,7 @@ archive.</p> | |||
jars from your CLASSPATH reads and writes UTF-8 names, it doesn't | |||
set or recognize any flags or unicode extra fields.</li> | |||
<li>Starting with Java 7 <code>java.util.zip</code> writes UTF-8 by | |||
<li>Since Java 7, <code>java.util.zip</code> writes UTF-8 by | |||
default and uses the language encoding flag. It is possible to | |||
specify a different encoding when reading/writing ZIPs via new | |||
constructors. The package now recognizes the language encoding | |||
@@ -411,8 +411,8 @@ archive.</p> | |||
will be written has to be made before writing the entry's | |||
content.</p> | |||
<p>Starting with Ant 1.9.0 Ant supports Zip64 extensions but didn't | |||
provide any control over their usage, starting with Ant 1.9.1 a | |||
<p>Ant 1.9.0 introduced support for Zip64 extensions but didn't | |||
provide any control over their usage. <em>Since Ant 1.9.1</em>, a | |||
new <em>zip64mode</em> attribute was added to the <code>zip</code> | |||
family of tasks. It supports three values: | |||
@@ -420,7 +420,7 @@ archive.</p> | |||
<li><em>never</em> means no Zip64 extra fields will ever be | |||
written, this is the behavior of Ant 1.8.x and earlier and the | |||
default behavior of <code>jar</code>, <code>ear</code> | |||
and <code>war</code> starting with Ant 1.9.1.</li> | |||
and <code>war</code> <em>since Ant 1.9.1</em>.</li> | |||
<li><em>always</em> means Zip64 extra fields are written for all | |||
entries.</li> | |||
<li><em>as-needed</em> means Zip64 extra fields are written for all | |||
@@ -461,29 +461,25 @@ the same way that <i>zipfileset src</i> files are added.</p> | |||
<h3>Examples</h3> | |||
<pre> <zip destfile="${dist}/manual.zip" | |||
basedir="htdocs/manual" | |||
/></pre> | |||
basedir="htdocs/manual"/></pre> | |||
<p>zips all files in the <code>htdocs/manual</code> directory into a file called <code>manual.zip</code> | |||
in the <code>${dist}</code> directory.</p> | |||
<pre> <zip destfile="${dist}/manual.zip" | |||
basedir="htdocs/manual" | |||
update="true" | |||
/></pre> | |||
update="true"/></pre> | |||
<p>zips all files in the <code>htdocs/manual</code> directory into a file called <code>manual.zip</code> | |||
in the <code>${dist}</code> directory. If <code>manual.zip</code> | |||
doesn't exist, it is created; otherwise it is updated with the | |||
new/changed files.</p> | |||
<pre> <zip destfile="${dist}/manual.zip" | |||
basedir="htdocs/manual" | |||
excludes="mydocs/**, **/todo.html" | |||
/></pre> | |||
excludes="mydocs/**, **/todo.html"/></pre> | |||
<p>zips all files in the <code>htdocs/manual</code> directory. Files in the directory <code>mydocs</code>, | |||
or files with the name <code>todo.html</code> are excluded.</p> | |||
<pre> <zip destfile="${dist}/manual.zip" | |||
basedir="htdocs/manual" | |||
includes="api/**/*.html" | |||
excludes="**/todo.html" | |||
/></pre> | |||
excludes="**/todo.html"/></pre> | |||
<p>zips all files in the <code>htdocs/manual</code> directory. Only html files under the directory <code>api</code> | |||
are zipped, and files with the name <code>todo.html</code> are excluded.</p> | |||
<pre> <zip destfile="${dist}/manual.zip"> | |||
@@ -17,50 +17,70 @@ | |||
*/ | |||
h2 { | |||
font-size: 200%; | |||
background-color: ffffff; | |||
background-color: white; | |||
} | |||
h3 { | |||
font-size: 130%; | |||
color: #ffffff; | |||
color: white; | |||
background-color: #525D76; | |||
} | |||
h4 { | |||
color: #ffffff; | |||
color: white; | |||
background-color: #828DA6; | |||
} | |||
h5 { | |||
font-size: 100%; | |||
color: white; | |||
background-color: #a6adbe; | |||
margin-top: .5rem; | |||
margin-bottom: .5rem; | |||
} | |||
h6 { | |||
font-size: 100%; | |||
color: white; | |||
background-color: #c1c5d1; | |||
margin-top: .5rem; | |||
margin-bottom: .5rem; | |||
} | |||
h5 + p, h6 + p { | |||
margin-top: .5rem; | |||
margin-bottom: .5rem; | |||
} | |||
td { | |||
background-color: eeeeee; | |||
color: 000000; | |||
background-color: #eeeeee; | |||
color: black; | |||
} | |||
/* first row */ | |||
table tr:first-child td { | |||
background-color: cccccc; | |||
color: 000000; | |||
background-color: silver; | |||
color: black; | |||
} | |||
/* or th as first row */ | |||
table th { | |||
background-color: cccccc; | |||
color: 000000; | |||
background-color: silver; | |||
color: black; | |||
} | |||
pre { | |||
background-color: efefef; | |||
background-color: #efefef; | |||
} | |||
/* code snippets in examples and tutorials */ | |||
.code { | |||
background: #EFEFEF; | |||
margin-top: | |||
} | |||
/* highlight console output */ | |||
.output { | |||
color: #FFFFFF; | |||
color: white; | |||
background: #837A67; | |||
} | |||