@@ -119,7 +119,7 @@ or set the <tt>fileext</tt> attribute. The names of common hashing algorithms ca | |||||
where <code>{0}</code> is replaced with the checksum and | where <code>{0}</code> is replaced with the checksum and | ||||
<code>{1}</code> with the file name. <em>Since Ant | <code>{1}</code> with the file name. <em>Since Ant | ||||
1.7.0</em><br/> | 1.7.0</em><br/> | ||||
<em>starting with Ant 1.8.2</em> <code>{2}</code> is replaced by | |||||
<em>Since Ant 1.8.2</em> <code>{2}</code> is replaced by | |||||
the path of the file relative to the checksum file being | the path of the file relative to the checksum file being | ||||
written, <code>{3}</code> with tha path of the file relative to | written, <code>{3}</code> with tha path of the file relative to | ||||
the project's basedir and <code>{4}</code> with the absolute | the project's basedir and <code>{4}</code> with the absolute | ||||
@@ -39,7 +39,7 @@ href="../Types/filelist.html">FileList</a>s can be specified using | |||||
nested <code><fileset></code>, <code><dirset></code> and | nested <code><fileset></code>, <code><dirset></code> and | ||||
<code><filelist></code> elements.</p> | <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 | href="../Types/resources.html#collection">Resource Collection</a>s | ||||
as nested elements.</p> | as nested elements.</p> | ||||
@@ -39,7 +39,7 @@ href="../Types/filelist.html">FileList</a>s can be specified using | |||||
nested <code><fileset></code>, <code><dirset></code> and | nested <code><fileset></code>, <code><dirset></code> and | ||||
<code><filelist></code> elements.</p> | <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 | href="../Types/resources.html#collection">Resource Collection</a>s | ||||
as nested elements.</p> | as nested elements.</p> | ||||
@@ -360,7 +360,7 @@ the file in the destination directory before you copy it. | |||||
There is not much that Ant can do. It cannot figure out which | There is not much that Ant can do. It cannot figure out which | ||||
files are binary - a UTF-8 version of Korean will have lots of | files are binary - a UTF-8 version of Korean will have lots of | ||||
bytes with the top bit set. It is not informed about illegal | bytes with the top bit set. It is not informed about illegal | ||||
character sequences by current Sun Java implementions. | |||||
character sequences by current Sun Java implementations. | |||||
</p> | </p> | ||||
<p> | <p> | ||||
One trick for filtering containing only US-ASCII is to | One trick for filtering containing only US-ASCII is to | ||||
@@ -52,7 +52,7 @@ a firewall via socks. | |||||
<p> | <p> | ||||
<strong>Warning:</strong> 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, | 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. | |||||
for instance due to specifics 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 | If you encounter such a problem, please send an email including a sample directory listing | ||||
coming from your ftp server (<code>ls -l</code>code> on the ftp prompt). | coming from your ftp server (<code>ls -l</code>code> on the ftp prompt). | ||||
</p> | </p> | ||||
@@ -571,7 +571,7 @@ Sealed: false</code></pre></blockquote> | |||||
<p> | <p> | ||||
The following shows how to create a jar file specifing a service | |||||
The following shows how to create a jar file specifying a service | |||||
with two implementations of the JDK 6 scripting interface: | with two implementations of the JDK 6 scripting interface: | ||||
</p> | </p> | ||||
<blockquote><pre> | <blockquote><pre> | ||||
@@ -591,7 +591,7 @@ Sealed: false</code></pre></blockquote> | |||||
<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 | 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> | 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> | |||||
Basically it says, that you have to set the manifest entry <tt>Multi-Release: true</tt> | |||||
and place all additional or overwriting classes in | and place all additional or overwriting classes in | ||||
<tt>META-INF/versions/<i>number</i>/package-structure</tt>, e.g. | <tt>META-INF/versions/<i>number</i>/package-structure</tt>, e.g. | ||||
<tt>META-INF/versions/9/org/apache/ant/MyClass.class</tt> | <tt>META-INF/versions/9/org/apache/ant/MyClass.class</tt> | ||||
@@ -265,8 +265,8 @@ invoking the compiler.</p> | |||||
<td valign="top"> | <td valign="top"> | ||||
Indicates whether source should be compiled with | Indicates whether source should be compiled with | ||||
optimization; defaults to <code>off</code>. <strong>Note</strong> | optimization; defaults to <code>off</code>. <strong>Note</strong> | ||||
that this flag is just ignored by Sun's <code>javac</code> starting | |||||
with JDK 1.3 (since compile-time optimization is unnecessary). | |||||
that this flag is just ignored by Sun's <code>javac</code> since | |||||
JDK 1.3 (because compile-time optimization is unnecessary). | |||||
</td> | </td> | ||||
<td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
</tr> | </tr> | ||||
@@ -282,7 +282,7 @@ invoking the compiler.</p> | |||||
(e.g., <code>1.1</code> or <code>1.2</code>). <b>Note that the | (e.g., <code>1.1</code> or <code>1.2</code>). <b>Note that the | ||||
default value depends on the JVM that is running Ant. In | default value depends on the JVM that is running Ant. In | ||||
particular, if you use JDK 1.4+ the generated classes will not be | particular, if you use JDK 1.4+ the generated classes will not be | ||||
usable for a 1.1 Java VM unless you explicitly set this attribute | |||||
usable for a Java 1.1 VM unless you explicitly set this attribute | |||||
to the value 1.1 (which is the default value for JDK 1.1 to | to the value 1.1 (which is the default value for JDK 1.1 to | ||||
1.3). We highly recommend to always specify this | 1.3). We highly recommend to always specify this | ||||
attribute.</b><br> | attribute.</b><br> | ||||
@@ -35,7 +35,7 @@ effectively manage and control package dependencies."</p> | |||||
<p>Source file directories are defined by nested | <p>Source file directories are defined by nested | ||||
<code><sourcespath></code>; Class file directories are defined | <code><sourcespath></code>; Class file directories are defined | ||||
by nested <code><classesespath></code>, see <a | |||||
by nested <code><classespath></code>, see <a | |||||
href="#nested">nested elements</a>.</p> | href="#nested">nested elements</a>.</p> | ||||
<p>Optionally, you can also set the <code>outputfile</code> name where the output is stored. By default the task writes its report to the standard output.</P> | <p>Optionally, you can also set the <code>outputfile</code> name where the output is stored. By default the task writes its report to the standard output.</P> | ||||
@@ -37,7 +37,7 @@ path normally specified on the command line is replaced by a single (possibly | |||||
empty) jar file which an in-manifest Class-Path attribute whose value lists | empty) jar file which an in-manifest Class-Path attribute whose value lists | ||||
all the jar and zip files the class path should contain. The files referenced | all the jar and zip files the class path should contain. The files referenced | ||||
from this attribute must be found relatively to the jar file itself, usually | from this attribute must be found relatively to the jar file itself, usually | ||||
in the same directory. The Java VM automically uses all file entries listed | |||||
in the same directory. The Java VM automatically uses all file entries listed | |||||
in the Class-Path attributes of a jar to locate/load classes. Note though that | in the Class-Path attributes of a jar to locate/load classes. Note though that | ||||
it silently ignores entries for which it cannot find any corresponding file.</p> | it silently ignores entries for which it cannot find any corresponding file.</p> | ||||
@@ -49,7 +49,7 @@ | |||||
<p> | <p> | ||||
Accordingly, while this task has uses, it should be considered an advanced | Accordingly, while this task has uses, it should be considered an advanced | ||||
task which should be used in certain batch-processing or testing situations, | task which should be used in certain batch-processing or testing situations, | ||||
rather than an easy trick to speed up build times on a multiway CPU. | |||||
rather than an easy trick to speed up build times on a multicore CPU. | |||||
</p> | </p> | ||||
<h3>Parameters</h3> | <h3>Parameters</h3> | ||||
@@ -60,7 +60,7 @@ the files matched by those patterns because the parent directory has | |||||
been matched. If this behavior is not what you want, set the | been matched. If this behavior is not what you want, set the | ||||
scanincludedirectories attribute to false.</p> | scanincludedirectories attribute to false.</p> | ||||
<p>Starting with Ant 1.7 this task supports nested <a | |||||
<p><em>Since Ant 1.7</em>, this task supports nested <a | |||||
href="../Types/resources.html#collection">resource collection</a>s | href="../Types/resources.html#collection">resource collection</a>s | ||||
in addition to (or instead of, depending on the useImplicitFileset | in addition to (or instead of, depending on the useImplicitFileset | ||||
attribute) the implicit fileset formed by this task.</p> | attribute) the implicit fileset formed by this task.</p> | ||||
@@ -132,7 +132,7 @@ archive.</p> | |||||
<td valign="top">scanForUnicodeExtraFields</td> | <td valign="top">scanForUnicodeExtraFields</td> | ||||
<td valign="top"><strong>Note</strong>: This attribute is not available for | <td valign="top"><strong>Note</strong>: This attribute is not available for | ||||
the <code>untar</code> task.<br> | the <code>untar</code> task.<br> | ||||
If the archive contains uncode extra fields then use them to set | |||||
If the archive contains Unicode extra fields then use them to set | |||||
the file names, ignoring the specified encoding. | the file names, ignoring the specified encoding. | ||||
<br/>See also the <a href="zip.html#encoding">discussion in the | <br/>See also the <a href="zip.html#encoding">discussion in the | ||||
zip task page</a></td> | zip task page</a></td> | ||||
@@ -56,6 +56,7 @@ property. | |||||
<h2 id="tasks">The Tasks</h2> | <h2 id="tasks">The Tasks</h2> | ||||
<table> | <table> | ||||
<tr><td>Task</td><td>Description</td></tr> | |||||
<tr> | <tr> | ||||
<td><a href="#vssget">vssget</a></td> | <td><a href="#vssget">vssget</a></td> | ||||
<td>Retrieves a copy of the specified VSS file(s).</td> | <td>Retrieves a copy of the specified VSS file(s).</td> | ||||