From d7c3057bb956391437d29cc518cbb0c458aa15a3 Mon Sep 17 00:00:00 2001 From: Stefan Bodewig Date: Wed, 26 Jul 2000 10:04:50 +0000 Subject: [PATCH] Updated documentation to Get task. Submitted by: Steve Loughran git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@267841 13f79535-47bb-0310-9956-ffa450edef68 --- docs/index.html | 39 ++++++++++++++++++++++++++++++++------- 1 file changed, 32 insertions(+), 7 deletions(-) diff --git a/docs/index.html b/docs/index.html index 71cfe2ff0..83cad9f5c 100644 --- a/docs/index.html +++ b/docs/index.html @@ -79,12 +79,14 @@ on.

Getting Ant

Binary edition

The latest stable version of Ant can be downloaded from http://jakarta.apache.org/builds/tomcat/release/v3.0/ant.zip. +href="http://jakarta.apache.org/builds/ant/release/v1.1/bin/"> +http://jakarta.apache.org/builds/ant/release/v1.1/bin/. If you like living on the edge, you can download the latest version from http://jakarta.apache.org/builds/tomcat/nightly/ant.zip.

Source edition

If you prefer the source edition, you can download Ant from http://jakarta.apache.org/builds/tomcat/release/v3.0/src/jakarta-tools.src.zip +href="http://jakarta.apache.org/builds/ant/release/v1.1/src/"> +http://jakarta.apache.org/builds/ant/release/v1.1/src/ (latest stable) or from http://jakarta.apache.org/from-cvs/jakarta-ant/ (current). See the section Building Ant on how to @@ -1048,7 +1050,7 @@ relative to the dir directory.

  <delete dir="lib" />

deletes all files in the /lib directory.

  <delete dir="."
-          include="**/*.bak"
+          includes="**/*.bak"
   />

deletes all files with the extension ".bak" from the current directory @@ -1357,11 +1359,17 @@ You never know what editor a user will use to browse README's.

Get

Description

-

Gets a file from an URL. When the verbose option is "on", this task +

Gets a file from a URL. When the verbose option is "on", this task displays a '.' for every 100 Kb retrieved.

This task should be preferred above the CVS task 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.

+ +The usetimestamps 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.

Parameters

@@ -1381,7 +1389,7 @@ archive with http/ftp.

- + @@ -1389,10 +1397,27 @@ archive with http/ftp.

+ + + + +
verboseshow verbose information ("on"/"off").show verbose progress information ("on"/"off"). No
Log errors but don't treat as fatal. No
usetimestampsconditionally download a file based on the timestamp of the local copy. + HTTP onlyNo

Examples

  <get src="http://jakarta.apache.org/" dest="help/index.html" />
-

gets the index page of http://jakarta.apache.org/, and stores it in the file help/index.html.

+

Gets the index page of http://jakarta.apache.org/, and stores it in the file help/index.html.

+ +
  <get src="http://jakarta.apache.org/builds/tomcat/nightly/ant.zip" 
+	dest="optional.jar" 
+	verbose="true"
+	usetimestamps="true"/>
+

+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. +

+

GUnzip

Description