add a FAQ about Java requirements od Ant. PR 44610.

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

docs/faq.html

@@ -228,6 +228,10 @@
             </ul>
                 <h4 class="toc">Installation</h4>
         <ul>
+                <li><a href="#java-version">
+  Which version of Java is required to run
+        Ant?
+      </a></li>
                 <li><a href="#no-gnu-tar">
   I get checksum errors when I try to extract the
       <code>tar.gz</code> distribution file. Why?
@@ -712,6 +716,18 @@
       </tr>
           </table>
                                 <p class="faq">
+      <a name="java-version"></a>
+      Which version of Java is required to run
+        Ant?
+    </p>
+                  <p>You will need Java installed on your system, version 1.3 or
+          later required, 1.5 or later strongly recommended. The later
+          the version of Java, the more Ant tasks you get.</p>
+                        <p>If only the JRE is present but not a full JDK then many
+          tasks will not work.</p>
+                        <p>Ant 1.6.* works with jdk 1.2 and higher, Ant 1.1 to Ant
+          1.5.* work with jdk 1.1 and higher.</p>
+                    <p class="faq">
       <a name="no-gnu-tar"></a>
       I get checksum errors when I try to extract the
       <code>tar.gz</code> distribution file. Why?

xdocs/faq.xml

@@ -229,6 +229,23 @@
   </faqsection>
 
   <faqsection title="Installation">
+    <faq id="java-version">
+      <question>Which version of Java is required to run
+        Ant?</question>
+      <answer>
+
+        <p>You will need Java installed on your system, version 1.3 or
+          later required, 1.5 or later strongly recommended. The later
+          the version of Java, the more Ant tasks you get.</p>
+
+        <p>If only the JRE is present but not a full JDK then many
+          tasks will not work.</p>
+
+        <p>Ant 1.6.* works with jdk 1.2 and higher, Ant 1.1 to Ant
+          1.5.* work with jdk 1.1 and higher.</p>
+      </answer>
+    </faq>
+
     <faq id="no-gnu-tar">
       <question>I get checksum errors when I try to extract the
       <code>tar.gz</code> distribution file. Why?</question>