From 55e44c4ce74608f62c303f7db4798b23c8c3981a Mon Sep 17 00:00:00 2001
From: Stefan Bodewig <bodewig@apache.org>
Date: Mon, 29 Nov 2010 15:46:05 +0000
Subject: [PATCH] document all known differences WRT environment variables.  PR
 49366.

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@1040160 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/Tasks/property.html | 36 ++++++++++++++++++++++++---------
 1 file changed, 27 insertions(+), 9 deletions(-)

diff --git a/docs/manual/Tasks/property.html b/docs/manual/Tasks/property.html
index d3a1243ab..c0a3b9615 100644
--- a/docs/manual/Tasks/property.html
+++ b/docs/manual/Tasks/property.html
@@ -63,15 +63,6 @@ according to <a href="http://java.sun.com/dtd/properties.dtd">Suns DTD</a>,
 if Java5+ is present. For this the name of the file, resource or url has 
 to end with <tt>.xml</tt>.</p>
 
-<h4>OpenVMS Users</h4>
-<p>With the <code>environment</code> attribute this task will load all defined
-logicals on an OpenVMS system.  Logicals with multiple equivalence names get
-mapped to a property whose value is a comma separated list of all equivalence
-names.  If a logical is defined in multiple tables, only the most local
-definition is available (the table priority order being PROCESS, JOB, GROUP,
-SYSTEM).
-</p>
-
 <h3>Parameters</h3>
 <table border="1" cellpadding="2" cellspacing="0">
   <tr>
@@ -176,6 +167,33 @@ SYSTEM).
   </tr>
 </table>
 
+<h4>OpenVMS Users</h4>
+<p>With the <code>environment</code> attribute this task will load all defined
+logicals on an OpenVMS system.  Logicals with multiple equivalence names get
+mapped to a property whose value is a comma separated list of all equivalence
+names.  If a logical is defined in multiple tables, only the most local
+definition is available (the table priority order being PROCESS, JOB, GROUP,
+SYSTEM).
+</p>
+
+<h4>Any OS except OpenVMS</h4>
+<p>Starting with Ant 1.8.2 if Ant detects it is running of a Java 1.5
+  VM (or better) Ant will use <code>System.getenv</code> rather than
+  its own OS dependent native implementation.  For some OSes this
+  causes minor differences when compared to older versions of Ant.
+  For a full list
+  see <a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=49366">Bugzilla
+  Issue 49366</a>.  In particular:</p>
+<ul>
+  <li>On Windows Ant will now return additional "environment
+    variables" that correspond to the drive specific current working
+    directories when Ant is run from the command line.  The keys of
+    these variables starts with an equals sign.</li>
+  <li>Some users reported that some Cygwin specific variables (in
+    particular PROMPT) was no longer present.</li>
+  <li>On OS/2 Ant no longer returns the BEGINLIBPATH variable.</li>
+</ul>
+
 <h3>Parameters specified as nested elements</h3>
 <h4>classpath</h4>
 <p><code>Property</code>'s <i>classpath</i> attribute is a <a