bodewig 2004/09/21 05:07:11
Modified: docs faq.html problems.html
xdocs faq.xml problems.xml
Log:
It is a good idea to look for a different version of Ant before reporting a
bug
Revision Changes Path
1.109 +10 -0 ant/docs/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/ant/docs/faq.html,v
retrieving revision 1.108
retrieving revision 1.109
diff -u -r1.108 -r1.109
--- faq.html 15 Sep 2004 22:58:05 -0000 1.108
+++ faq.html 21 Sep 2004 12:07:11 -0000 1.109
@@ -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 @@
</macrodef>
</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>
1.57 +22 -0 ant/docs/problems.html
Index: problems.html
===================================================================
RCS file: /home/cvs/ant/docs/problems.html,v
retrieving revision 1.56
retrieving revision 1.57
diff -u -r1.56 -r1.57
--- problems.html 16 Jun 2004 14:25:34 -0000 1.56
+++ problems.html 21 Sep 2004 12:07:11 -0000 1.57
@@ -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>
1.64 +11 -0 ant/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/ant/xdocs/faq.xml,v
retrieving revision 1.63
retrieving revision 1.64
diff -u -r1.63 -r1.64
--- faq.xml 15 Sep 2004 22:58:05 -0000 1.63
+++ faq.xml 21 Sep 2004 12:07:11 -0000 1.64
@@ -623,6 +623,17 @@
</faqsection>
<faqsection title="It doesn't work (as expected)">
+ <faq id="genral-advice">
+ <question>General Advice</question>
+ <answer>
+
+ <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>
+ </answer>
+ </faq>
+
<faq id="always-recompiles">
<question>Why does Ant always recompile all my Java files?</question>
<answer>
1.16 +26 -0 ant/xdocs/problems.xml
Index: problems.xml
===================================================================
RCS file: /home/cvs/ant/xdocs/problems.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- problems.xml 16 Feb 2004 16:38:06 -0000 1.15
+++ problems.xml 21 Sep 2004 12:07:11 -0000 1.16
@@ -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
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
