From 0097b2ed9e942a3d57f101ea87af80d7ae705d0e Mon Sep 17 00:00:00 2001
From: Stefan Bodewig
Date: Wed, 9 Aug 2000 14:59:06 +0000
Subject: [PATCH] Documentation for nested in .
git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@267908 13f79535-47bb-0310-9956-ffa450edef68
---
WHATSNEW | 7 +++----
docs/index.html | 52 ++++++++++++++++++++++++++++++++++++++++++++++++-
2 files changed, 54 insertions(+), 5 deletions(-)
diff --git a/WHATSNEW b/WHATSNEW
index bf247d839..f09b92a46 100644
--- a/WHATSNEW
+++ b/WHATSNEW
@@ -13,7 +13,7 @@ org.apache.tools.ant to org.apache.tools.ant.types.
* the class attribute of has been removed.
-* has lost some of its attributes.
+* and have lost some of their attributes.
* and have lost some undocumented attributes.
@@ -34,10 +34,9 @@ all files if the stylesheet changes.
* New data types fileset and patternset - expected to get a broader
use, pending documentation.
-* You can specify environment variables to the exec task - pending
-documentation.
+* You can specify environment variables to .
-* Get can check whether a remote file is actually newer than a local
+* can check whether a remote file is actually newer than a local
copy before it starts a download (HTTP only).
* Added a -logger option to allow the class which performs logging to be
diff --git a/docs/index.html b/docs/index.html
index 701841c96..68e783bd7 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -25,7 +25,7 @@
Dave Walend (dwalend@cs.tufts.edu)
-Version 1.2 - 2000/07/28
+Version 1.2 - 2000/08/09
Table of Contents
@@ -1160,6 +1160,56 @@ systems.
<exec dir="${src}" command="dir" os="windows"
output="dir.txt" />
+
+Parameters specified as nested elements
+
+It is possible to specify environment variables to pass to the
+system command via nested <env>
elements.
+Please note that the environment of the current Ant process is
+not passed to the system command if you specify variables using
+<env>
.
+
+
+ Attribute |
+ Description |
+ Required |
+
+
+ key |
+ The name of the environment variable. |
+ Yes |
+
+
+ value |
+ The literal value for the environment variable. |
+ Exactly one of these. |
+
+
+ path |
+ The value for a PATH like environment
+ variable. You can use ; or : as path separators and Ant will
+ convert it to the platform's local conventions. |
+
+
+ file |
+ The value for the environment variable. Will be
+ replaced by the absolute filename of the file by Ant. |
+
+
+Examples
+
+<exec command="emacs" >
+ <env key="DISPLAY" value=":1.0" />
+</exec>
+
+starts emacs
on display 1 of the X Window System.
+
+<exec ... >
+ <env key="PATH" path="${java.library.path}:${basedir}/bin" />
+</exec>
+
+adds ${basedir}/bin
to the PATH
of the
+system command.
Description