@@ -79,12 +79,14 @@ on.</p>
<h2><a name="getting">Getting Ant</a></h2>
<h3>Binary edition</h3>
<p>The latest stable version of Ant can be downloaded from <a
href="http://jakarta.apache.org/builds/tomcat/release/v3.0/ant.zip">http://jakarta.apache.org/builds/tomcat/release/v3.0/ant.zip</a>.
href="http://jakarta.apache.org/builds/ant/release/v1.1/bin/">
http://jakarta.apache.org/builds/ant/release/v1.1/bin/</a>.
If you like living on the edge, you can download the latest version from <a
href="http://jakarta.apache.org/builds/tomcat/nightly/ant.zip">http://jakarta.apache.org/builds/tomcat/nightly/ant.zip</a>.</p>
<h3>Source edition</h3>
<p>If you prefer the source edition, you can download Ant from <a
href="http://jakarta.apache.org/builds/tomcat/release/v3.0/src/jakarta-tools.src.zip">http://jakarta.apache.org/builds/tomcat/release/v3.0/src/jakarta-tools.src.zip</a>
href="http://jakarta.apache.org/builds/ant/release/v1.1/src/">
http://jakarta.apache.org/builds/ant/release/v1.1/src/</a>
(latest stable) or from <a
href="http://jakarta.apache.org/from-cvs/jakarta-tools/">http://jakarta.apache.org/from-cvs/jakarta-ant/</a>
(current). See the section <a href="#buildingant">Building Ant</a> on how to
@@ -1048,7 +1050,7 @@ relative to the <i>dir</i> directory.</p>
<pre> <delete dir="lib" /></pre>
<p>deletes all files in the <code>/lib</code> directory.</p>
<pre> <delete dir="."
include="**/*.bak"
includes ="**/*.bak"
/>
</pre>
<p>deletes all files with the extension "<code>.bak</code>" from the current directory
@@ -1357,11 +1359,17 @@ You never know what editor a user will use to browse README's.</p>
<hr>
<h2><a name="get">Get</a></h2>
<h3>Description</h3>
<p>Gets a file from an URL. When the verbose option is "on", this task
<p>Gets a file from a URL. When the verbose option is "on", this task
displays a '.' for every 100 Kb retrieved.</p>
<p>This task should be preferred above the <a href="#cvs">CVS task</a> when
doing automated builds. CVS is significant slower than loading a compressed
doing automated builds. CVS is significantly slower than loading a compressed
archive with http/ftp.</p>
The <i>usetimestamps</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,
if the JVM is Java1.2 or later.
NB: This timestamp facility only works on downloads using the HTTP protocol.
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
@@ -1381,7 +1389,7 @@ archive with http/ftp.</p>
</tr>
<tr>
<td valign="top">verbose</td>
<td valign="top">show verbose information ("on"/"off").</td>
<td valign="top">show verbose progress information ("on"/"off").</td>
<td align="center" valign="top">No</td>
</tr>
<tr>
@@ -1389,10 +1397,27 @@ archive with http/ftp.</p>
<td valign="top">Log errors but don't treat as fatal.</td>
<td align="center" valign="top">No</td>
</tr>
<tr>
<td valign="top">usetimestamps</td>
<td valign="top">conditionally download a file based on the timestamp of the local copy.
HTTP only</td>
<td align="center" valign="top">No</td>
</tr>
</table>
<h3>Examples</h3>
<pre> <get src="http://jakarta.apache.org/" dest="help/index.html" /></pre>
<p>gets the index page of http://jakarta.apache.org/, and stores it in the file <code>help/index.html</code>.</p>
<p>Gets the index page of http://jakarta.apache.org/, and stores it in the file <code>help/index.html</code>.</p>
<pre> <get src="http://jakarta.apache.org/builds/tomcat/nightly/ant.zip"
dest="optional.jar"
verbose="true"
usetimestamps="true"/></pre>
<p>
Gets the nightly ant build from the tomcat distribution, if the local copy
is missing or out of date. Uses the verbose option
for progess information.
</p>
<hr>
<h2><a name="gunzip">GUnzip</a></h2>
<h3>Description</h3>
Stefan Bodewig