Here are the documentation changes to go with the already committed changes to the GET task, which describes how the timestamp option works.
While adding that, I made two other edits to the document 1. added an 's' to the include=".." line in the example for Delete, so that cut-and-paste of that example works 2. changed the URL at the beginning which points to the release copy to point at the ant1.1 bin and source directories, instead of the zip files in the tomcat3.1 release. -Steve
cvs diff -u index.html (in directory C:\JAVA\APPS\JAKARTA-ANT\DOCS) Index: index.html =================================================================== RCS file: /home/cvspublic/jakarta-ant/docs/index.html,v retrieving revision 1.54 diff -u -r1.54 index.html --- index.html 2000/07/24 16:05:27 1.54 +++ index.html 2000/07/25 17:41:09 @@ -79,12 +79,14 @@ <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 @@ <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 @@ <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 @@ </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 @@ <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> *****CVS exited normally with code 1*****
