youys
/
ant
Not watched
1
0
Fork 1
Code
Releases 0 Wiki Activity
Issues 0 Pull Requests 0 Datasets Model Cloudbrain
Browse Source

Convert tabs into spaces

master
Gintas Grigelionis 7 years ago
parent
92af470118
commit
b08077b2d6
14 changed files with 117 additions and 125 deletions
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. +6
    -6
      manual/Tasks/ejb.html
  2. +6
    -6
      manual/Tasks/fixcrlf.html
  3. +3
    -3
      manual/Tasks/ftp.html
  4. +1
    -1
      manual/Tasks/input.html
  5. +4
    -5
      manual/Tasks/jar.html
  6. +1
    -1
      manual/Tasks/javah.html
  7. +2
    -2
      manual/Tasks/junit.html
  8. +2
    -2
      manual/Tasks/propertyfile.html
  9. +1
    -2
      manual/Tasks/signjar.html
  10. +2
    -2
      manual/Tasks/sos.html
  11. +3
    -3
      manual/Tasks/style.html
  12. +1
    -1
      manual/Tasks/wljspc.html
  13. +7
    -9
      manual/Types/custom-programming.html
  14. +78
    -82
      manual/install.html

+ 6
- 6
manual/Tasks/ejb.html View File

@@ -1433,8 +1433,8 @@ example, <var>suffix</var>). Refer to the appropriate documentation for more det
<tr> <tr>
<td>destdir</td> <td>destdir</td>
<td>The base directory into which the generated JAR files will be written. Each JAR file is <td>The base directory into which the generated JAR files will be written. Each JAR file is
written in directories which correspond to their location within
the <var>descriptordir</var> namespace.</td>
written in directories which correspond to their location within
the <var>descriptordir</var> namespace.</td>
<td>Yes</td> <td>Yes</td>
</tr> </tr>
<tr> <tr>
@@ -1445,9 +1445,9 @@ example, <var>suffix</var>). Refer to the appropriate documentation for more det
<tr> <tr>
<td>classpath</td> <td>classpath</td>
<td>The classpath used when generating EJB stubs and skeletons. If <td>The classpath used when generating EJB stubs and skeletons. If
specified, <var>classpath</var> will be prepended to the classpath specified in the
parent <code>ejbjar</code> task (see also the ORB attribute documentation below). Note that
nested <code>classpath</code> elements may also be used.</td>
specified, <var>classpath</var> will be prepended to the classpath specified in the
parent <code>ejbjar</code> task (see also the ORB attribute documentation below). Note that
nested <code>classpath</code> elements may also be used.</td>
<td>No; defaults to the classpath specified in the <code>ejbjar</code> parent task</td> <td>No; defaults to the classpath specified in the <code>ejbjar</code> parent task</td>
</tr> </tr>
<tr> <tr>
@@ -1486,7 +1486,7 @@ example, <var>suffix</var>). Refer to the appropriate documentation for more det
<tr> <tr>
<td>secpropag</td> <td>secpropag</td>
<td><q>true</q> if the RMI skeletons and stubs must be modified to implement the implicit <td><q>true</q> if the RMI skeletons and stubs must be modified to implement the implicit
propagation of the security context (the transactional context is always provided).</td>
propagation of the security context (the transactional context is always provided).</td>
<td>No; defaults to <q>false</q></td> <td>No; defaults to <q>false</q></td>
</tr> </tr>
<tr> <tr>


+ 6
- 6
manual/Tasks/fixcrlf.html View File

@@ -169,9 +169,9 @@
<td>tab</td> <td>tab</td>
<td>Specifies how tab characters are to be handled. Valid values for this property are: <td>Specifies how tab characters are to be handled. Valid values for this property are:
<ul> <ul>
<li><q>add</q>: convert sequences of spaces which span a tab stop to tabs</li>
<li><q>asis</q>: leave tab and space characters alone</li>
<li><q>remove</q>: convert tabs to spaces</li>
<li><q>add</q>: convert sequences of spaces which span a tab stop to tabs</li>
<li><q>asis</q>: leave tab and space characters alone</li>
<li><q>remove</q>: convert tabs to spaces</li>
</ul> </ul>
<p><strong>Note</strong>: When the attribute <var>javafiles</var> (see above) is <q>true</q>, <p><strong>Note</strong>: When the attribute <var>javafiles</var> (see above) is <q>true</q>,
literal TAB characters occurring within Java string or character constants are never literal TAB characters occurring within Java string or character constants are never
@@ -192,9 +192,9 @@
<td>Specifies how DOS end of file (control-Z) characters are to be handled. Valid values for <td>Specifies how DOS end of file (control-Z) characters are to be handled. Valid values for
this property are: this property are:
<ul> <ul>
<li><q>add</q>: ensure that there is an EOF character at the end of the file</li>
<li><q>asis</q>: leave EOF characters alone</li>
<li><q>remove</q>: remove any EOF character found at the end</li>
<li><q>add</q>: ensure that there is an EOF character at the end of the file</li>
<li><q>asis</q>: leave EOF characters alone</li>
<li><q>remove</q>: remove any EOF character found at the end</li>
</ul> </ul>
</td> </td>
<td colspan="2">No; default is platform-specific: <q>remove</q> for Unix platforms, <q>asis</q> <td colspan="2">No; default is platform-specific: <q>remove</q> for Unix platforms, <q>asis</q>


+ 3
- 3
manual/Tasks/ftp.html View File

@@ -227,9 +227,9 @@ connection.</p>
greater</a>.</strong></p> greater</a>.</strong></p>
<p>Use these options when the standard options don't work, because</p> <p>Use these options when the standard options don't work, because</p>
<ul> <ul>
<li>the server is in a different timezone and you need timestamp dependency checking</li>
<li>the default timestamp formatting doesn't match the server display and list parsing
therefore fails</li>
<li>the server is in a different timezone and you need timestamp dependency checking</li>
<li>the default timestamp formatting doesn't match the server display and list parsing
therefore fails</li>
</ul> </ul>
<p>If none of these is specified, the default mechanism of letting the system auto-detect the <p>If none of these is specified, the default mechanism of letting the system auto-detect the
server OS type based on the FTP <code>SYST</code> command and assuming standard formatting server OS type based on the FTP <code>SYST</code> command and assuming standard formatting


+ 1
- 1
manual/Tasks/input.html View File

@@ -104,7 +104,7 @@ different <code>Input</code> tasks.</p>
<tr id="handler.type"> <tr id="handler.type">
<td>type</td> <td>type</td>
<td>one of <q>default</q>, <q>propertyfile</q>, <q>greedy</q>, or <q>secure</q> (<em>since Ant <td>one of <q>default</q>, <q>propertyfile</q>, <q>greedy</q>, or <q>secure</q> (<em>since Ant
1.8</em>).</td>
1.8</em>).</td>
<td rowspan="3">One of these</td> <td rowspan="3">One of these</td>
</tr> </tr>
<tr> <tr>


+ 4
- 5
manual/Tasks/jar.html View File

@@ -245,11 +245,10 @@ e.g. decreasing the size by deleting 'same' classes from the versions-branches,
<td>strict</td> <td>strict</td>
<td>Configures how to handle breaks of the packaging version specification: <td>Configures how to handle breaks of the packaging version specification:
<ul> <ul>
<li><q>fail</q> = throws a BuildException</li>
<li><q>warn</q> = logs a message on warn level</li>
<li><q>ignore</q> = logs a message on verbose level (default)</li>
</ul>
<em>Since Ant 1.7.1</em></td>
<li><q>fail</q> = throws a BuildException</li>
<li><q>warn</q> = logs a message on warn level</li>
<li><q>ignore</q> = logs a message on verbose level (default)</li>
</ul><em>Since Ant 1.7.1</em></td>
<td>No; defaults to <q>ignore</q></td> <td>No; defaults to <q>ignore</q></td>
</tr> </tr>
<tr> <tr>


+ 1
- 1
manual/Tasks/javah.html View File

@@ -160,7 +160,7 @@ can be used to enable arguments only if a given compiler implementation will be
<tr> <tr>
<td>prefix</td> <td>prefix</td>
<td rowspan="2">See <a href="../using.html#arg">Command-line Arguments</a>. <em>Since Ant <td rowspan="2">See <a href="../using.html#arg">Command-line Arguments</a>. <em>Since Ant
1.8</em>.</td>
1.8</em>.</td>
<td>No</td> <td>No</td>
</tr> </tr>
<tr> <tr>


+ 2
- 2
manual/Tasks/junit.html View File

@@ -376,7 +376,7 @@ to <samp><i>java-tmp-dir</i>/FailedTests</samp>.</p>
<tr> <tr>
<td>if</td> <td>if</td>
<td>Only use formatter <a href="../properties.html#if+unless">if the named property is <td>Only use formatter <a href="../properties.html#if+unless">if the named property is
set</a>.</td>
set</a>.</td>
<td>No; default is <q>true</q></td> <td>No; default is <q>true</q></td>
</tr> </tr>
<tr> <tr>
@@ -415,7 +415,7 @@ to <samp><i>java-tmp-dir</i>/FailedTests</samp>.</p>
methods are being executed).</li> methods are being executed).</li>
</ul> </ul>
<p>If the <var>methods</var> attribute is used but no test method is specified, then no test <p>If the <var>methods</var> attribute is used but no test method is specified, then no test
method from the suite will be executed.</p>
method from the suite will be executed.</p>
</td> </td>
<td>No; default is to run all test methods in the suite</td> <td>No; default is to run all test methods in the suite</td>
</tr> </tr>


+ 2
- 2
manual/Tasks/propertyfile.html View File

@@ -99,10 +99,10 @@ file itself.</p>
</tr> </tr>
<tr> <tr>
<td>operation</td> <td>operation</td>
<td>One of the following operations:<br><br>
<td>One of the following operations:<br/>
<strong>for all datatypes:</strong> <strong>for all datatypes:</strong>
<ul> <ul>
<li><q>del</q> : deletes an entry</li>
<li><q>del</q> : deletes an entry</li>
<li><q>+</q> : adds a value to the existing value</li> <li><q>+</q> : adds a value to the existing value</li>
<li><q>=</q> : sets a value instead of the existing value (default)</li> <li><q>=</q> : sets a value instead of the existing value (default)</li>
</ul> </ul>


+ 1
- 2
manual/Tasks/signjar.html View File

@@ -201,12 +201,11 @@ name is not provided, JARs are signed in place.</p>
<tr> <tr>
<td>sysproperty</td> <td>sysproperty</td>
<td>JVM system properties, with the syntax of Ant <a href="exec.html#env">environment <td>JVM system properties, with the syntax of Ant <a href="exec.html#env">environment
variables</a></td>
variables</a></td>
<td>No, and only one can be supplied</td> <td>No, and only one can be supplied</td>
</tr> </tr>
</table> </table>



<h3>Examples</h3> <h3>Examples</h3>
<p>For instructions on generating a code signing certificate, see the <a target="_blank" <p>For instructions on generating a code signing certificate, see the <a target="_blank"
href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/keytool.html">keytool href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/keytool.html">keytool


+ 2
- 2
manual/Tasks/sos.html View File

@@ -161,7 +161,7 @@ Linux, Solaris &amp; Windows 2000.</p>
<tr> <tr>
<td>nocache</td> <td>nocache</td>
<td><q>true|false</q>&mdash;Only needed if <code>SOSHOME</code> is set as an environment <td><q>true|false</q>&mdash;Only needed if <code>SOSHOME</code> is set as an environment
variable</td>
variable</td>
<td>No</td> <td>No</td>
</tr> </tr>
<tr> <tr>
@@ -339,7 +339,7 @@ the <samp>$/SourceRoot/project1</samp> project with <q>test label</q>.</p>
<tr> <tr>
<td>nocache</td> <td>nocache</td>
<td><q>true|false</q>&mdash;Only needed if <code>SOSHOME</code> is set as an environment <td><q>true|false</q>&mdash;Only needed if <code>SOSHOME</code> is set as an environment
variable</td>
variable</td>
<td>No</td> <td>No</td>
</tr> </tr>
<tr> <tr>


+ 3
- 3
manual/Tasks/style.html View File

@@ -134,7 +134,7 @@ path-like structure).</p>
<td>name of the XSLT processor to use. Permissible value is: <td>name of the XSLT processor to use. Permissible value is:
<ul> <ul>
<li><q>trax</q> for a TraX compliant processor (ie JAXP interface implementation such as <li><q>trax</q> for a TraX compliant processor (ie JAXP interface implementation such as
Xalan 2 or Saxon)</li>
Xalan 2 or Saxon)</li>
</ul> </ul>
Support for Xalan 1 has been removed <em>since Ant 1.7</em>. Support for Xalan 1 has been removed <em>since Ant 1.7</em>.
</td> </td>
@@ -298,13 +298,13 @@ resolution.</p>
<tr> <tr>
<td>if</td> <td>if</td>
<td>The param will only be passed <a href="../properties.html#if+unless">if this property is <td>The param will only be passed <a href="../properties.html#if+unless">if this property is
set</a>.</td>
set</a>.</td>
<td>No</td> <td>No</td>
</tr> </tr>
<tr> <tr>
<td>unless</td> <td>unless</td>
<td>The param will not be passed <a href="../properties.html#if+unless">if this property is <td>The param will not be passed <a href="../properties.html#if+unless">if this property is
set</a>.</td>
set</a>.</td>
<td>No</td> <td>No</td>
</tr> </tr>
</table> </table>


+ 1
- 1
manual/Tasks/wljspc.html View File

@@ -42,7 +42,7 @@
<tr> <tr>
<td>dest</td> <td>dest</td>
<td>root of destination directory, what you have set as <code>WorkingDir</code> in the <td>root of destination directory, what you have set as <code>WorkingDir</code> in the
WebLogic properties</td>
WebLogic properties</td>
<td>Yes</td> <td>Yes</td>
</tr> </tr>
<tr> <tr>


+ 7
- 9
manual/Types/custom-programming.html View File

@@ -251,17 +251,16 @@ public class MatchNumberSelectors extends BaseSelectorContainer {
<tr> <tr>
<td>classname</td> <td>classname</td>
<td> <td>
The name of your class that
implements <code>org.apache.tools.ant.types.selectors.FileSelector</code>.
The name of your class that
implements <code>org.apache.tools.ant.types.selectors.FileSelector</code>.
</td> </td>
<td>Yes</td> <td>Yes</td>
</tr> </tr>
<tr> <tr>
<td>classpath</td> <td>classpath</td>
<td> <td>
The classpath to use in order to load the custom selector
class. If neither <var>classpath</var> nor
<var>classpathref</var> are specified, the class will be
The classpath to use in order to load the custom selector class. If
neither <var>classpath</var> nor <var>classpathref</var> are specified, the class will be
loaded from the classpath that Ant uses. loaded from the classpath that Ant uses.
</td> </td>
<td>No</td> <td>No</td>
@@ -269,10 +268,9 @@ public class MatchNumberSelectors extends BaseSelectorContainer {
<tr> <tr>
<td>classpathref</td> <td>classpathref</td>
<td> <td>
A reference to a classpath previously defined. If
neither <var>classpathref</var> nor <var>classpath</var> above are
specified, the class will be loaded from the classpath that Ant
uses.
A reference to a classpath previously defined. If neither <var>classpathref</var>
nor <var>classpath</var> above are specified, the class will be loaded from the classpath
that Ant uses.
</td> </td>
<td>No</td> <td>No</td>
</tr> </tr>


+ 78
- 82
manual/install.html View File

@@ -70,8 +70,8 @@ target="_top">https://ant.apache.org/</a>
The binary distribution of Ant is available as 3 different archives The binary distribution of Ant is available as 3 different archives
</p> </p>
<ol> <ol>
<li><samp>.zip</samp>&mdash;Recommended compression format for Windows, can also be used on other platforms. Supported by many
programs and some operating systems natively.</li>
<li><samp>.zip</samp>&mdash;Recommended compression format for Windows, can also be used on other platforms. Supported
by many programs and some operating systems natively.</li>
<li><samp>.tar.gz</samp>&mdash;Using the tar program to gather files together, and gzip to compress and uncompress.</li> <li><samp>.tar.gz</samp>&mdash;Using the tar program to gather files together, and gzip to compress and uncompress.</li>
<li><samp>.tar.bz2</samp>&mdash;Using the tar program to gather files together, and bzip2 to compress and uncompress.</li> <li><samp>.tar.bz2</samp>&mdash;Using the tar program to gather files together, and bzip2 to compress and uncompress.</li>
</ol> </ol>
@@ -111,14 +111,15 @@ the <a href="#diagnostics">diagnostics</a> advice.
<h3 id="sourceEdition">Source Distribution</h3> <h3 id="sourceEdition">Source Distribution</h3>


<p> <p>
If you prefer the source distribution, you can download the source for the latest Ant release from
<a href="https://ant.apache.org/srcdownload.cgi" target="_top">https://ant.apache.org/srcdownload.cgi</a>.
If you prefer the source distribution, you can download the source for the latest Ant release
from <a href="https://ant.apache.org/srcdownload.cgi" target="_top">https://ant.apache.org/srcdownload.cgi</a>.
</p> </p>
<p> <p>
If you prefer the leading-edge code, you can access the code as it is being developed via Git. The Ant website has If you prefer the leading-edge code, you can access the code as it is being developed via Git. The Ant website has
details on <a href="https://ant.apache.org/git.html" target="_top">accessing Git</a>. All bug fixes will go in against details on <a href="https://ant.apache.org/git.html" target="_top">accessing Git</a>. All bug fixes will go in against
the HEAD of the source tree, and the first response to many bug reports will be "have you tried the latest version". Don't
be afraid to download and build a prerelease distribution, as everything other than new features are usually stable.
the HEAD of the source tree, and the first response to many bug reports will be "have you tried the latest
version". Don't be afraid to download and build a prerelease distribution, as everything other than new features are
usually stable.
</p> </p>
<p> <p>
See the section <a href="#buildingant">Building Ant</a> on how to build Ant from the source code. You can also access See the section <a href="#buildingant">Building Ant</a> on how to build Ant from the source code. You can also access
@@ -150,40 +151,39 @@ target="_top">https://archive.apache.org/dist/ant/</a>. The files are organized
<tr> <tr>
<td><samp>ant-current-bin.zip</samp></td> <td><samp>ant-current-bin.zip</samp></td>
<td> <td>
ZIP archive containing the compiled version of Ant in the last released version. It is recommended that
you do not download the latest version this way, as the standard way of downloading described above will
redirect you to a mirror closer to you, thus making the download faster for you and reducing the load
on Apache servers.
ZIP archive containing the compiled version of Ant in the last released version. It is recommended that you do not
download the latest version this way, as the standard way of downloading described above will redirect you to a
mirror closer to you, thus making the download faster for you and reducing the load on Apache servers.
</td> </td>
</tr> </tr>
<tr> <tr>
<td><samp>ant-current-src.zip</samp></td> <td><samp>ant-current-src.zip</samp></td>
<td> <td>
ZIP archive containing the sources of Ant. If you have this you can compile Ant. If you do not have the
<em>required</em> dependencies, the classes depending on them are just not built. Again, it is preferred to use the
standard way of getting the source package described above to make your download quicker and to reduce the load on
Apache servers.
ZIP archive containing the sources of Ant. If you have this you can compile Ant. If you do not have
the <em>required</em> dependencies, the classes depending on them are just not built. Again, it is preferred to use
the standard way of getting the source package described above to make your download quicker and to reduce the load
on Apache servers.
</td> </td>
</tr> </tr>
<tr> <tr>
<td><samp>ant-current-*.asc</samp></td> <td><samp>ant-current-*.asc</samp></td>
<td> <td>
Security file for checking the correctness of the zip file. This one is the
<a href="https://en.wikipedia.org/wiki/Pretty_Good_Privacy" target="_blank">PGP</a> signature.
Security file for checking the correctness of the zip file. This one is
the <a href="https://en.wikipedia.org/wiki/Pretty_Good_Privacy" target="_blank">PGP</a> signature.
</td> </td>
</tr> </tr>
<tr> <tr>
<td><samp>ant-current-*.md5</samp></td> <td><samp>ant-current-*.md5</samp></td>
<td> <td>
Security file for checking the correctness of the zip file. This one is the
<a href="https://en.wikipedia.org/wiki/Md5" target="_blank">MD5</a> checksum.
Security file for checking the correctness of the zip file. This one is
the <a href="https://en.wikipedia.org/wiki/Md5" target="_blank">MD5</a> checksum.
</td> </td>
</tr> </tr>
<tr> <tr>
<td><samp>ant-current-*.sha1</samp></td> <td><samp>ant-current-*.sha1</samp></td>
<td> <td>
Security file for checking the correctness of the zip file. This one is the
<a href="https://en.wikipedia.org/wiki/SHA-1" target="_blank">SHA1</a> checksum.
Security file for checking the correctness of the zip file. This one is
the <a href="https://en.wikipedia.org/wiki/SHA-1" target="_blank">SHA1</a> checksum.
</td> </td>
</tr> </tr>
<tr> <tr>
@@ -222,9 +222,9 @@ target="_top">https://archive.apache.org/dist/ant/</a>. The files are organized
<h2 id="sysrequirements">System Requirements</h2> <h2 id="sysrequirements">System Requirements</h2>
<p> <p>
Ant has been used successfully on many platforms, including Linux, commercial flavours of Unix such as Solaris and Ant has been used successfully on many platforms, including Linux, commercial flavours of Unix such as Solaris and
HP-UX, macOS, Windows NT descendants, OS/2 Warp, Novell Netware 6, OpenVMS. The platforms used most for development
are, in no particular order, Linux, macOS, Microsoft Windows and Unix; these are therefore that platforms that tend to
work best. <em>Since Ant 1.7</em>, Windows 9x is no longer supported.
HP-UX, macOS, Windows NT descendants, OS/2 Warp, Novell Netware 6, OpenVMS. The platforms used most for development are,
in no particular order, Linux, macOS, Microsoft Windows and Unix; these are therefore that platforms that tend to work
best. <em>Since Ant 1.7</em>, Windows 9x is no longer supported.
</p> </p>
<p> <p>
For the current version of Ant (1.10), you will also need a JDK installed on your system, version 8 or later required. For the current version of Ant (1.10), you will also need a JDK installed on your system, version 8 or later required.
@@ -271,8 +271,8 @@ other open source Java runtimes, and so strives to have a product that works wel
Only the <samp>bin</samp> and <samp>lib</samp> directories are required to run Ant. Only the <samp>bin</samp> and <samp>lib</samp> directories are required to run Ant.
</p> </p>
<p> <p>
To install Ant, choose a directory and copy the distribution files there. This directory will be known as
<code>ANT_HOME</code>.
To install Ant, choose a directory and copy the distribution files there. This directory will be known
as <code>ANT_HOME</code>.
</p> </p>


<h3>Windows 95, Windows 98 &amp; Windows ME Note</h3> <h3>Windows 95, Windows 98 &amp; Windows ME Note</h3>
@@ -280,20 +280,20 @@ To install Ant, choose a directory and copy the distribution files there. This d
<em>Note that current releases of Ant no longer support these systems. If you are using an older version of Ant, <em>Note that current releases of Ant no longer support these systems. If you are using an older version of Ant,
however, the script used to launch Ant will have problems if <code>ANT_HOME</code> is a long filename (i.e. a however, the script used to launch Ant will have problems if <code>ANT_HOME</code> is a long filename (i.e. a
filename which is not of the format known as &quot;8.3&quot;). This is due to limitations in the OS's handling of filename which is not of the format known as &quot;8.3&quot;). This is due to limitations in the OS's handling of
the <code>&quot;for&quot;</code> batch file statement. It is recommended, therefore, that Ant be installed in a
<strong>short</strong>, 8.3 path, such as <samp>C:\Ant</samp>.</em>
the <code>&quot;for&quot;</code> batch file statement. It is recommended, therefore, that Ant be installed in
a <strong>short</strong>, 8.3 path, such as <samp>C:\Ant</samp>.</em>
</p> </p>
<p> <p>
On these systems you will also need to configure more environment space to cater for the environment variables used On these systems you will also need to configure more environment space to cater for the environment variables used
in the Ant launch script. To do this, you will need to add or update the following line in the
<samp>config.sys</samp> file
in the Ant launch script. To do this, you will need to add or update the following line in
the <samp>config.sys</samp> file
</p> </p>
<pre>shell=c:\command.com c:\ /p /e:32768</pre> <pre>shell=c:\command.com c:\ /p /e:32768</pre>


<h3 id="setup">Setup</h3> <h3 id="setup">Setup</h3>
<p> <p>
Before you can run Ant there is some additional setup you will need to do unless you are installing the
<a href="#jpackage">RPM version from jpackage.org</a>:
Before you can run Ant there is some additional setup you will need to do unless you are installing
the <a href="#jpackage">RPM version from jpackage.org</a>:
</p> </p>
<ul> <ul>
<li>Add the <samp>bin</samp> directory to your path.</li> <li>Add the <samp>bin</samp> directory to your path.</li>
@@ -304,9 +304,9 @@ better to not rely on this behavior.</li>
below). This should be set to the directory where your JDK is installed.</li> below). This should be set to the directory where your JDK is installed.</li>
</ul> </ul>
<p> <p>
Operating System-specific instructions for doing this from the command line are in the <a href="#windows">Windows</a>,
<a href="#bash">Linux/Unix (bash)</a>, and <a href="#tcshcsh">Linux/Unix (csh)</a> sections. Note that using this
method, the settings will only be valid for the command line session you run them in.
Operating System-specific instructions for doing this from the command line are in
the <a href="#windows">Windows</a>, <a href="#bash">Linux/Unix (bash)</a>, and <a href="#tcshcsh">Linux/Unix (csh)</a>
sections. Note that using this method, the settings will only be valid for the command line session you run them in.
</p> </p>
<p> <p>
<strong>Note</strong>: Do not install Ant's <samp>ant.jar</samp> file into the <samp>lib/ext</samp> directory of the <strong>Note</strong>: Do not install Ant's <samp>ant.jar</samp> file into the <samp>lib/ext</samp> directory of the
@@ -316,10 +316,11 @@ security restrictions on the classes which may be loaded by an extension.


<h3>Windows Note</h3> <h3>Windows Note</h3>
<p> <p>
The <samp>ant.bat</samp> script makes use of three environment variables&mdash;<code>ANT_HOME</code>,
<code>CLASSPATH</code> and <code>JAVA_HOME</code>. <strong>Ensure</strong> that <code>ANT_HOME</code> and
<code>JAVA_HOME</code> variables are set, and that they do <strong>not</strong> have quotes (either ' or &quot;) and
they do <strong>not</strong> end with \ or with /. <code>CLASSPATH</code> should be unset or empty.
The <samp>ant.bat</samp> script makes use of three environment
variables&mdash;<code>ANT_HOME</code>, <code>CLASSPATH</code> and <code>JAVA_HOME</code>. <strong>Ensure</strong>
that <code>ANT_HOME</code> and <code>JAVA_HOME</code> variables are set, and that they do <strong>not</strong> have
quotes (either ' or &quot;) and they do <strong>not</strong> end with \ or with /. <code>CLASSPATH</code> should be
unset or empty.
</p> </p>


<h3 id="checkInstallation">Check Installation</h3> <h3 id="checkInstallation">Check Installation</h3>
@@ -347,11 +348,11 @@ If this does not work, ensure your environment variables are set right. E.g., on
<li>required: <code>%PATH%=...<i>maybe-other-entries</i>...;%ANT_HOME%\bin;...<i>maybe-other-entries</i>...</code></li> <li>required: <code>%PATH%=...<i>maybe-other-entries</i>...;%ANT_HOME%\bin;...<i>maybe-other-entries</i>...</code></li>
</ul> </ul>
<p> <p>
<code>ANT_HOME</code> is used by the launcher script for finding the libraries.
<code>JAVA_HOME</code> is used by the launcher for finding the JDK/JRE to use. (JDK is recommended as some tasks require the
Java tools.) If not set, the launcher tries to find one via the <code>%PATH%</code> environment variable.
<code>PATH</code> is set for user convenience. With that set you can just start <code>ant</code> instead of always typing
<samp>the/complete/path/to/your/ant/installation/bin/ant</samp>.
<code>ANT_HOME</code> is used by the launcher script for finding the libraries. <code>JAVA_HOME</code> is used by the
launcher for finding the JDK/JRE to use. (JDK is recommended as some tasks require the Java tools.) If not set, the
launcher tries to find one via the <code>%PATH%</code> environment variable. <code>PATH</code> is set for user
convenience. With that set you can just start <code>ant</code> instead of always
typing <samp>the/complete/path/to/your/ant/installation/bin/ant</samp>.
</p> </p>


<h3 id="optionalTasks">Optional Tasks</h3> <h3 id="optionalTasks">Optional Tasks</h3>
@@ -373,8 +374,8 @@ In <code><i>ANT_HOME</i>/lib</code>. This makes the JAR files available to all A


<li> <li>
<p> <p>
In <code>${user.home}/.ant/lib</code> (<em>since Ant 1.6</em>). This allows different users to add new libraries to Ant. All JAR
files added to this directory are available to command-line Ant.
In <code>${user.home}/.ant/lib</code> (<em>since Ant 1.6</em>). This allows different users to add new libraries to
Ant. All JAR files added to this directory are available to command-line Ant.
</p> </p>
</li> </li>


@@ -773,16 +774,16 @@ these tasks available. Please refer to the <a href="#optionalTasks">Installing A
<tr> <tr>
<td>jakarta-regexp-1.4.jar</td> <td>jakarta-regexp-1.4.jar</td>
<td><a href="Types/mapper.html#regexp-mapper">regexp</a> type with mappers (if you do not wish to use <td><a href="Types/mapper.html#regexp-mapper">regexp</a> type with mappers (if you do not wish to use
java.util.regex)</td>
java.util.regex)</td>
<td><a href="https://attic.apache.org/projects/jakarta-regexp.html" <td><a href="https://attic.apache.org/projects/jakarta-regexp.html"
target="_top">https://attic.apache.org/projects/jakarta-regexp.html</a></td>
target="_top">https://attic.apache.org/projects/jakarta-regexp.html</a></td>
</tr> </tr>
<tr> <tr>
<td>jakarta-oro-2.0.8.jar</td> <td>jakarta-oro-2.0.8.jar</td>
<td><a href="Types/mapper.html#regexp-mapper">regexp</a> type with mappers (if you do not wish to use <td><a href="Types/mapper.html#regexp-mapper">regexp</a> type with mappers (if you do not wish to use
java.util.regex) or <a href="Tasks/ftp.html">ftp</a> task with <a href="#commons-net">commons-net</a> 1.4.1</td>
java.util.regex) or <a href="Tasks/ftp.html">ftp</a> task with <a href="#commons-net">commons-net</a> 1.4.1</td>
<td><a href="https://attic.apache.org/projects/jakarta-oro.html" <td><a href="https://attic.apache.org/projects/jakarta-oro.html"
target="_top">https://attic.apache.org/projects/jakarta-oro.html</a></td>
target="_top">https://attic.apache.org/projects/jakarta-oro.html</a></td>
</tr> </tr>
<tr> <tr>
<td>junit.jar</td> <td>junit.jar</td>
@@ -812,23 +813,20 @@ these tasks available. Please refer to the <a href="#optionalTasks">Installing A
<td>Groovy JARs</td> <td>Groovy JARs</td>
<td>Groovy Ant tasks with bindings or Groovy with <a href="Tasks/script.html">script</a> <td>Groovy Ant tasks with bindings or Groovy with <a href="Tasks/script.html">script</a>
and <a href="Tasks/scriptdef.html">scriptdef</a> tasks</td> and <a href="Tasks/scriptdef.html">scriptdef</a> tasks</td>
<td>
<a href="http://groovy-lang.org/" target="_top">http://groovy-lang.org/</a><br/>
Use either groovy-ant for Groovy Ant tasks with bindings or groovy-bsf for Groovy with script and scriptdef tasks
(or groovy-all)
<td><a href="http://groovy-lang.org/" target="_top">http://groovy-lang.org/</a><br/> Use either groovy-ant for
Groovy Ant tasks with bindings or groovy-bsf for Groovy with script and scriptdef tasks (or groovy-all)
</td> </td>
</tr> </tr>
<tr> <tr>
<td>netrexx.jar</td> <td>netrexx.jar</td>
<td><a href="Tasks/netrexxc.html">netrexxc</a> task, Rexx with <a href="Tasks/script.html">script</a> task</td> <td><a href="Tasks/netrexxc.html">netrexxc</a> task, Rexx with <a href="Tasks/script.html">script</a> task</td>
<td><a href="https://www.ibm.com/software/awdtools/netrexx/library.html" <td><a href="https://www.ibm.com/software/awdtools/netrexx/library.html"
target="_top">https://www.ibm.com/software/awdtools/netrexx/library.html</a></td>
target="_top">https://www.ibm.com/software/awdtools/netrexx/library.html</a></td>
</tr> </tr>
<tr> <tr>
<td>rhino.jar<br/>
(included in Java 7 runtime, replaced by Nashorn in Java&nbsp;8 and later)</td>
<td>JavaScript with <a href="Tasks/script.html">script</a> task<br/>
<strong>Note</strong>: Apache BSF 2.4.0 works only with Rhino 1.5R4 and later versions.</td>
<td>rhino.jar<br/>(included in Java 7 runtime, replaced by Nashorn in Java&nbsp;8 and later)</td>
<td>JavaScript with <a href="Tasks/script.html">script</a> task<br/><strong>Note</strong>: Apache BSF 2.4.0 works
only with Rhino 1.5R4 and later versions.</td>
<td><a href="https://www.mozilla.org/rhino/" target="_top">https://www.mozilla.org/rhino/</a></td> <td><a href="https://www.mozilla.org/rhino/" target="_top">https://www.mozilla.org/rhino/</a></td>
</tr> </tr>
<tr> <tr>
@@ -848,8 +846,8 @@ these tasks available. Please refer to the <a href="#optionalTasks">Installing A
</tr> </tr>
<tr> <tr>
<td>BeanShell JAR(s)</td> <td>BeanShell JAR(s)</td>
<td>BeanShell with <a href="Tasks/script.html">script</a> task.<br/>
<strong>Note</strong>: Ant requires BeanShell version 1.3 or later</td>
<td>BeanShell with <a href="Tasks/script.html">script</a> task.<br/><strong>Note</strong>: Ant requires BeanShell
version 1.3 or later</td>
<td><a href="http://www.beanshell.org/" target="_top">http://www.beanshell.org/</a></td> <td><a href="http://www.beanshell.org/" target="_top">http://www.beanshell.org/</a></td>
</tr> </tr>
<tr> <tr>
@@ -875,33 +873,30 @@ these tasks available. Please refer to the <a href="#optionalTasks">Installing A
<tr id="commons-net"> <tr id="commons-net">
<td>commons-net.jar</td> <td>commons-net.jar</td>
<td><a href="Tasks/ftp.html">ftp</a>, <a href="Tasks/rexec.html">rexec</a> <td><a href="Tasks/ftp.html">ftp</a>, <a href="Tasks/rexec.html">rexec</a>
and <a href="Tasks/telnet.html">telnet</a> tasks<br/>
A minimum version of commons-net of 1.4.0 is needed to compile Ant, earlier versions did not support the full range
of configuration options.<br/>
jakarta-oro 2.0.8 is required together with commons-net 1.4.x at run time.<br/>
<strong>Note</strong>: do not use commons-net 3.2 because
of <a href="https://issues.apache.org/jira/browse/NET-493">performance issues</a>
and <a href="Tasks/telnet.html">telnet</a> tasks<br/> A minimum version of commons-net of 1.4.0 is needed to
compile Ant, earlier versions did not support the full range of configuration options.<br/>jakarta-oro 2.0.8 is
required together with commons-net 1.4.x at run time.<br/><strong>Note</strong>: do not use commons-net 3.2
because of <a href="https://issues.apache.org/jira/browse/NET-493">performance issues</a>
</td> </td>
<td><a href="https://commons.apache.org/net/" target="_top">https://commons.apache.org/net/</a></td> <td><a href="https://commons.apache.org/net/" target="_top">https://commons.apache.org/net/</a></td>
</tr> </tr>
<tr> <tr>
<td>bcel.jar</td> <td>bcel.jar</td>
<td><a href="Types/classfileset.html">classfileset</a> data type, JavaClassHelper used by the ClassConstants filter <td><a href="Types/classfileset.html">classfileset</a> data type, JavaClassHelper used by the ClassConstants filter
reader and optionally used by <a href="Tasks/ejb.html#ejbjar">ejbjar</a> task for dependency determination</td>
reader and optionally used by <a href="Tasks/ejb.html#ejbjar">ejbjar</a> task for dependency determination</td>
<td><a href="https://commons.apache.org/bcel/" target="_top">https://commons.apache.org/bcel/</a></td> <td><a href="https://commons.apache.org/bcel/" target="_top">https://commons.apache.org/bcel/</a></td>
</tr> </tr>
<tr> <tr>
<td>javax.mail-api.jar</td> <td>javax.mail-api.jar</td>
<td><a href="Tasks/mail.html">mail</a> task with MIME encoding, <td><a href="Tasks/mail.html">mail</a> task with MIME encoding,
and <em><u>deprecated</u></em> <a href="Tasks/mimemail.html">mimemail</a> task</td>
and <em><u>deprecated</u></em> <a href="Tasks/mimemail.html">mimemail</a> task</td>
<td><a href="https://javaee.github.io/javamail/" <td><a href="https://javaee.github.io/javamail/"
target="_top">https://javaee.github.io/javamail/</a></td>
target="_top">https://javaee.github.io/javamail/</a></td>
</tr> </tr>
<tr> <tr>
<td>activation.jar<br/>
(included in Java 6 and later runtime)</td>
<td>activation.jar<br/>(included in Java 6 and later runtime)</td>
<td><a href="Tasks/mail.html">mail</a> task with MIME encoding, <td><a href="Tasks/mail.html">mail</a> task with MIME encoding,
and <em><u>deprecated</u></em> <a href="Tasks/mimemail.html">mimemail</a> task</td>
and <em><u>deprecated</u></em> <a href="Tasks/mimemail.html">mimemail</a> task</td>
<td><a href="https://www.oracle.com/technetwork/java/javase/jaf-135115.html" <td><a href="https://www.oracle.com/technetwork/java/javase/jaf-135115.html"
target="_top">https://www.oracle.com/technetwork/java/javase/jaf-135115.html</a></td> target="_top">https://www.oracle.com/technetwork/java/javase/jaf-135115.html</a></td>
</tr> </tr>
@@ -914,9 +909,9 @@ these tasks available. Please refer to the <a href="#optionalTasks">Installing A
<tr> <tr>
<td>resolver.jar <strong>1.1 or later</strong></td> <td>resolver.jar <strong>1.1 or later</strong></td>
<td><a href="Types/xmlcatalog.html">xmlcatalog</a> datatype <em>only if support for external catalog files is <td><a href="Types/xmlcatalog.html">xmlcatalog</a> datatype <em>only if support for external catalog files is
desired</em></td>
desired</em></td>
<td><a href="https://xerces.apache.org/xml-commons/components/resolver/" <td><a href="https://xerces.apache.org/xml-commons/components/resolver/"
target="_top">https://xerces.apache.org/xml-commons/components/resolver/</a></td>
target="_top">https://xerces.apache.org/xml-commons/components/resolver/</a></td>
</tr> </tr>
<tr> <tr>
<td>jsch.jar <strong>0.1.54 or later</strong></td> <td>jsch.jar <strong>0.1.54 or later</strong></td>
@@ -927,13 +922,13 @@ these tasks available. Please refer to the <a href="#optionalTasks">Installing A
<td>JAI&mdash;Java Advanced Imaging</td> <td>JAI&mdash;Java Advanced Imaging</td>
<td><a href="Tasks/image.html">image</a> task</td> <td><a href="Tasks/image.html">image</a> task</td>
<td><a href="https://download.java.net/media/jai/builds/release/1_1_3/INSTALL.html" <td><a href="https://download.java.net/media/jai/builds/release/1_1_3/INSTALL.html"
target="_top">https://download.java.net/media/jai/builds/release/1_1_3/INSTALL.html</a></td>
target="_top">https://download.java.net/media/jai/builds/release/1_1_3/INSTALL.html</a></td>
</tr> </tr>
<tr> <tr>
<td>XZ&mdash;XZ for Java <strong>1.6 or later</strong></td> <td>XZ&mdash;XZ for Java <strong>1.6 or later</strong></td>
<td><a href="Tasks/pack.html">xz</a> and <a href="Tasks/unpack.html">unxz</a> <td><a href="Tasks/pack.html">xz</a> and <a href="Tasks/unpack.html">unxz</a>
tasks, <a href="Types/resources.html#xzresource">xzresource</a>, xz compression
in <a href="Tasks/tar.html">tar</a>/<a href="Tasks/unzip.html">untar</a> tasks</td>
tasks, <a href="Types/resources.html#xzresource">xzresource</a>, xz compression
in <a href="Tasks/tar.html">tar</a>/<a href="Tasks/unzip.html">untar</a> tasks</td>
<td><a href="https://www.tukaani.org/xz/java.html" target="_top">https://www.tukaani.org/xz/java.html</a></td> <td><a href="https://www.tukaani.org/xz/java.html" target="_top">https://www.tukaani.org/xz/java.html</a></td>
</tr> </tr>
</table> </table>
@@ -943,15 +938,16 @@ these tasks available. Please refer to the <a href="#optionalTasks">Installing A
<h3 id="diagnostics">Diagnostics</h3> <h3 id="diagnostics">Diagnostics</h3>


<p> <p>
Ant has a built in diagnostics feature. If you run <code>ant -diagnostics</code>, Ant will look at its internal state and
print it out. This code will check and print the following things.
Ant has a built in diagnostics feature. If you run <code>ant -diagnostics</code>, Ant will look at its internal state
and print it out. This code will check and print the following things.
</p> </p>


<ul> <ul>


<li>Where Ant is running from. Sometimes you can be surprised.</li> <li>Where Ant is running from. Sometimes you can be surprised.</li>


<li>The version of <samp>ant.jar</samp> and of the <samp>ant-*.jar</samp> containing the optional tasks&mdash;and whether they match</li>
<li>The version of <samp>ant.jar</samp> and of the <samp>ant-*.jar</samp> containing the optional tasks&mdash;and
whether they match</li>


<li>Which JAR files are in <code>ANT_HOME/lib</code></li> <li>Which JAR files are in <code>ANT_HOME/lib</code></li>


@@ -962,8 +958,8 @@ libraries that it depends on are absent.</li>


<li>JVM system properties</li> <li>JVM system properties</li>


<li>The status of the <samp>temp</samp> directory. If this is not writable, or its timestamp is horribly wrong (possible if it is on a
network drive), a lot of tasks may fail with obscure error messages.</li>
<li>The status of the <samp>temp</samp> directory. If this is not writable, or its timestamp is horribly wrong (possible
if it is on a network drive), a lot of tasks may fail with obscure error messages.</li>


<li>The current time zone as Java sees it. If this is not what it should be for your location, then dependency logic may <li>The current time zone as Java sees it. If this is not what it should be for your location, then dependency logic may
get confused.</li> get confused.</li>


Write Preview
Loading…
Cancel
Save
Please read the following content carefully:

Dear OpenI User

Thank you for your continuous support to the Openl Qizhi Community AI Collaboration Platform. In order to protect your usage rights and ensure network security, we updated the Openl Qizhi Community AI Collaboration Platform Usage Agreement in January 2024. The updated agreement specifies that users are prohibited from using intranet penetration tools. After you click "Agree and continue", you can continue to use our services. Thank you for your cooperation and understanding.

For more agreement content, please refer to the《Openl Qizhi Community AI Collaboration Platform Usage Agreement》

Agree and continue
Disagree, exit