From f710134d16c1bd05448ef4fbd6ec9b3110f62cac Mon Sep 17 00:00:00 2001
From: Jan Materne <jhm@apache.org>
Date: Wed, 20 Dec 2006 08:54:39 +0000
Subject: [PATCH] Show the list of supported platforms for <property env=""/>

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@488981 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/CoreTasks/property.html | 59 ++++++++++++++++++++++++++---
 1 file changed, 54 insertions(+), 5 deletions(-)

diff --git a/docs/manual/CoreTasks/property.html b/docs/manual/CoreTasks/property.html
index 55eac9832..64ecd1e87 100644
--- a/docs/manual/CoreTasks/property.html
+++ b/docs/manual/CoreTasks/property.html
@@ -122,12 +122,11 @@ SYSTEM).
     &quot;.&quot; it will not be doubled. ie environment=&quot;myenv.&quot; will still
     allow access of environment variables through &quot;myenv.PATH&quot; and
     &quot;myenv.TERM&quot;. This functionality is currently only implemented
-    on select platforms. Feel free to send patches to increase the number of platforms
-    this functionality is supported on ;).<br>
+    on <a href="#notes-env">select platforms</a>. Feel free to send patches to increase the
+    number of platforms this functionality is supported on ;).<br>
     Note also that properties are case sensitive, even if the
     environment variables on your operating system are not, e.g. it
     will be ${env.Path} not ${env.PATH} on Windows 2000.</td>
-
   </tr>
   <tr>
     <td valign="top">classpath</td>
@@ -210,7 +209,57 @@ deploy.url=http://${deploy.server}:${deploy.port}/
 </pre>
 
 
+<a name="notes-env"></a>
+<h3>Notes about environment variables</h3>
+<p>
+  Ant runs on Java 1.2 therefore it cant use Java5 features for accessing environment
+  variables. So it starts a command in a new process which prints the environment variables,
+  analyzes the output and creates the properties. <br>
+  There are commands for the following operating systems implemented in
+  <a href="http://svn.apache.org/viewvc/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Execute.java?view=markup">
+  Execute.java</a> (method <tt>getProcEnvCommand()</tt>):
+  <table>
+    <tr>
+      <th>OS</th>
+      <th>command</th>
+    </tr>
+    <tr>
+      <td> os/2 </td>
+      <td> cmd /c set </td>
+    </tr>
+    <tr>
+      <td colspan="2"> windows </td>
+    </tr>
+    <tr>
+      <td> * win9x </td>
+      <td> command.com /c set </td>
+    </tr>
+    <tr>
+      <td> * other </td>
+      <td> cmd /c set </td>
+    </tr>
+    <tr>
+      <td> z/os </td>
+      <td> /bin/env <b>OR</b> /usr/bin/env <b>OR</b> env   <i>(depending on read rights)</i> </td>
+    </tr>
+    <tr>
+      <td> unix </td>
+      <td> /bin/env <b>OR</b> /usr/bin/env <b>OR</b> env   <i>(depending on read rights)</i> </td>
+    </tr>
+    <tr>
+      <td> netware </td>
+      <td> env </td>
+    </tr>
+    <tr>
+      <td> os/400 </td>
+      <td> env </td>
+    </tr>
+    <tr>
+      <td> openvms </td>
+      <td> show logical </td>
+    </tr>
+  </table>
+</p>
 
 </body>
-</html>
-
+</html>
\ No newline at end of file