From 17f55de7cfe119bc1e916f414be70c0ab429ddf7 Mon Sep 17 00:00:00 2001
From: Stefan Bodewig <bodewig@apache.org>
Date: Tue, 21 Sep 2004 12:07:11 +0000
Subject: [PATCH] It is a good idea to look for a different version of Ant
 before reporting a bug

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@276876 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/faq.html      | 10 ++++++++++
 docs/problems.html | 22 ++++++++++++++++++++++
 xdocs/faq.xml      | 11 +++++++++++
 xdocs/problems.xml | 26 ++++++++++++++++++++++++++
 4 files changed, 69 insertions(+)

diff --git a/docs/faq.html b/docs/faq.html
index 79b3ec0b9..1efb343bc 100644
--- a/docs/faq.html
+++ b/docs/faq.html
@@ -250,6 +250,9 @@
             </ul>
                 <h4 class="toc">It doesn't work (as expected)</h4>
         <ul>
+                <li><a href="#genral-advice">
+  General Advice
+      </a></li>
                 <li><a href="#always-recompiles">
   Why does Ant always recompile all my Java files?
       </a></li>
@@ -990,6 +993,13 @@ shell-prompt&gt; m4 foo.m4 &gt; foo
 &lt;/macrodef&gt;
 </pre>
                                 <p class="faq">
+      <a name="genral-advice"></a>
+      General Advice
+    </p>
+                  <p>There are many reasons why Ant doesn't behave as
+        expected, not all of them are due to Ant bugs.  See our <a href="problems.html">Having Problems?</a> page for hints that
+        may help pinning down the reasons for your problem.</p>
+                    <p class="faq">
       <a name="always-recompiles"></a>
       Why does Ant always recompile all my Java files?
     </p>
diff --git a/docs/problems.html b/docs/problems.html
index 30a7d42b2..f08fd5530 100644
--- a/docs/problems.html
+++ b/docs/problems.html
@@ -184,6 +184,28 @@
            you in the right direction.
         </p>
                                       <h4 class="subsection">
+        <a name="Ensure that you are actually running the version of Ant that you think you do"></a>
+        Ensure that you are actually running the version of Ant that you think you do
+      </h4>
+                        <p>Many tools include a version of Ant and some Operating
+        Systems even install it by default now, so you may have a
+        version of Ant installed that you haven't been aware of.</p>
+                                <p>One of the first things to do is to run
+          <br /><br />
+          <font face="verdana" size="-1">ant -version</font>
+          <br /><br />
+          and
+          <br /><br />
+          <font face="verdana" size="-1">ant -diagnostics</font>
+          <br /><br />
+          to be sure.  Also, we highly recommend that you run Ant with
+          an empty CLASSPATH.  If any other version of Ant can be
+          loaded from the CLASSPATH, many types of errors may happen
+          because of incompatible classes being loaded.</p>
+                                <p>See <a href="faq.html">the FAQ</a> for <a href="faq.html#NoClassDefFoundError">some</a> <a href="faq.html#InstantiationException">examples</a>, but many
+        other problems are a result of an old version of Ant on your
+        system as well.</p>
+                                                    <h4 class="subsection">
         <a name="Read the Manual"></a>
         Read the Manual
       </h4>
diff --git a/xdocs/faq.xml b/xdocs/faq.xml
index 7dba002c0..7149f092d 100644
--- a/xdocs/faq.xml
+++ b/xdocs/faq.xml
@@ -623,6 +623,17 @@ shell-prompt> m4 foo.m4 > foo
   </faqsection>
 
   <faqsection title="It doesn&apos;t work (as expected)">
+    <faq id="genral-advice">
+      <question>General Advice</question>
+      <answer>
+
+        <p>There are many reasons why Ant doesn&apos;t behave as
+        expected, not all of them are due to Ant bugs.  See our <a
+        href="problems.html">Having Problems?</a> page for hints that
+        may help pinning down the reasons for your problem.</p>
+      </answer>
+    </faq>
+
     <faq id="always-recompiles">
       <question>Why does Ant always recompile all my Java files?</question>
       <answer>
diff --git a/xdocs/problems.xml b/xdocs/problems.xml
index 3523c8f32..8528a15da 100644
--- a/xdocs/problems.xml
+++ b/xdocs/problems.xml
@@ -34,6 +34,32 @@
            you in the right direction.
         </p>
          
+      <subsection name="Ensure that you are actually running the version of Ant that you think you do">
+        <p>Many tools include a version of Ant and some Operating
+        Systems even install it by default now, so you may have a
+        version of Ant installed that you haven't been aware of.</p>
+
+        <p>One of the first things to do is to run
+          <br></br><br></br>
+          <font face="verdana" size="-1">ant -version</font>
+          <br></br><br></br>
+          and
+          <br></br><br></br>
+          <font face="verdana" size="-1">ant -diagnostics</font>
+          <br></br><br></br>
+          to be sure.  Also, we highly recommend that you run Ant with
+          an empty CLASSPATH.  If any other version of Ant can be
+          loaded from the CLASSPATH, many types of errors may happen
+          because of incompatible classes being loaded.</p>
+
+        <p>See <a href="faq.html">the FAQ</a> for <a
+        href="faq.html#NoClassDefFoundError">some</a> <a
+        href="faq.html#InstantiationException">examples</a>, but many
+        other problems are a result of an old version of Ant on your
+        system as well.</p>
+          
+      </subsection>
+
       <subsection name="Read the Manual">
          <p>
             The first step to take when you have a problem with Ant is to read