Updated documentation to Get task.

Submitted by:	Steve Loughran <steve_l@iseran.com>


git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@267841 13f79535-47bb-0310-9956-ffa450edef68

docs/index.html

@@ -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>  &lt;delete dir=&quot;lib&quot; /&gt;</pre>
 <p>deletes all files in the <code>/lib</code> directory.</p>
 <pre>  &lt;delete dir=&quot;.&quot;
-          include=&quot;**/*.bak&quot;
+          includes=&quot;**/*.bak&quot;
   /&gt;
 </pre>
 <p>deletes all files with the extension &quot;<code>.bak</code>&quot 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 &quot;on&quot;, this task
+<p>Gets a file from a URL. When the verbose option is &quot;on&quot;, 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 (&quot;on&quot;/&quot;off&quot;).</td>
+    <td valign="top">show verbose progress information (&quot;on&quot;/&quot;off&quot;).</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>  &lt;get src=&quot;http://jakarta.apache.org/&quot; dest=&quot;help/index.html&quot; /&gt;</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>  &lt;get src=&quot;http://jakarta.apache.org/builds/tomcat/nightly/ant.zip&quot; 
+	dest=&quot;optional.jar&quot; 
+	verbose=&quot;true&quot;
+	usetimestamps=&quot;true&quot;/&gt;</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>