add a comment about /etc/ant.conf and about quotes and / in ANT_HOME,CLASSPATH and JAVA_HOME

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@451487 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/install.html

@@ -211,6 +211,50 @@ directory of the JDK/JRE. Ant is an application, whilst the extension
 directory is intended for JDK extensions. In particular there are security
 restrictions on the classes which may be loaded by an extension.</p>
 
+<table width="80%">
+<tr>
+  <td colspan="2">
+    <b>Windows Note:</b>
+  </td>
+</tr>
+<tr>
+  <td width="5%">&nbsp;</td>
+  <td>
+    The ant.bat script makes use of three environment variables -
+    ANT_HOME, CLASSPATH and JAVA_HOME. <b>Ensure</b> that if
+    these variables are set, they do <b><u>not</u></b> have quotes (either
+    ' or &quot;) and they do <b><u>not</u></b> end with \ or with /.
+  </td>
+</tr>
+</table>
+<table width="80%">
+<tr>
+  <td colspan="2">
+    <b>Linux Note:</b>
+  </td>
+</tr>
+<tr>
+  <td width="5%">&nbsp;</td>
+  <td>
+    A jpackage rpm version of ant may be installed on your machine,
+    say as part of install of Fedora Core 3. If another version
+    of ant is installed, the rpm version <b><u>will</u></b> take
+    priority. This is due to the fact that ant bash script file
+    dot includes the /etc/ant.conf file from the jpackage distribution.
+    The current version of this file (sept 2006) overwrites the
+    ANT_HOME environment variable. If this happens, ant will
+    issue a warning. To fix this, modify the line in /etc/ant.conf
+    <br/>
+    <code>ANT_HOME=/usr/share/ant</code>
+    <br/>
+    to be
+    <br/>
+    <code>ANT_HOME=${ANT_HOME:-/usr/share/ant}</code>.
+  </td>
+</tr>
+</table>
+
+
 <h3><a name="optionalTasks">Optional Tasks</a></h3>
 <p>Ant supports a number of optional tasks. An optional task is a task which
 typically requires an external library to function. The optional tasks are