| @@ -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> | ||||