ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bode...@locus.apache.org
Subject cvs commit: jakarta-ant/docs index.html
Date Wed, 26 Jul 2000 10:04:52 GMT
bodewig     00/07/26 03:04:51

  Modified:    docs     index.html
  Log:
  Updated documentation to Get task.
  Submitted by:	Steve Loughran <steve_l@iseran.com>
  
  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>  &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 @@
   <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 @@
     </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 @@
       <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>
  
  
  

Mime
View raw message