bodewig 00/07/26 03:04:51
Modified: docs index.html Log: Updated documentation to Get task. Submitted by: Steve Loughran <[EMAIL PROTECTED]> Revision Changes Path 1.55 +32 -7 jakarta-ant/docs/index.html Index: index.html =================================================================== RCS file: /home/cvs/jakarta-ant/docs/index.html,v retrieving revision 1.54 retrieving revision 1.55 diff -u -r1.54 -r1.55 --- index.html 2000/07/24 16:05:27 1.54 +++ index.html 2000/07/26 10:04:50 1.55 @@ -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>
