Author: bodewig
Date: Mon Nov 29 15:46:05 2010
New Revision: 1040160
URL: http://svn.apache.org/viewvc?rev=1040160&view=rev
Log:
document all known differences WRT environment variables. PR 49366.
Modified:
ant/core/trunk/docs/manual/Tasks/property.html
Modified: ant/core/trunk/docs/manual/Tasks/property.html
URL:
http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/Tasks/property.html?rev=1040160&r1=1040159&r2=1040160&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/Tasks/property.html (original)
+++ ant/core/trunk/docs/manual/Tasks/property.html Mon Nov 29 15:46:05 2010
@@ -63,15 +63,6 @@ according to <a href="http://java.sun.co
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
