blob: cea9baa949f8bb50d5deb8a9a028244dbbf85304 [file] [log] [blame]
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<title>Apache Ant User Manual - Feedback</title>
</head>
<body>
<h1><a name="feedback">Feedback</a> and Troubleshooting</h1>
<p>If things do not work, especially simple things like <tt>ant -version</tt>,
then something is wrong with your configuration. Before filing bug reports and
emailing all the ant mailing lists</p>
<ol>
<li>Check your environment variables. Are ANT_HOME and JAVA_HOME correct? If
they have quotes or trailing slashes, remove them.</li>
<li>Unset CLASSPATH; if that is wrong things go horribly wrong. Ant does not
need the CLASSPATH variable defined to anything to work.</li>
<li>Make sure there are no versions of crimson.jar or other XML parsers in JRE/ext</li>
<li>Is your path correct? is Ant on it? What about JDK/bin? have you tested
this? If you are using Jikes, is it on the path? A createProcess error (especially
with ID=2 on windows) usually means executable not found on the path.</li>
<li>Which version of ant are you running? Other applications distribute a copy
-it may be being picked up by accident.</li>
<li>If a task is failing to run is optional.jar in ANT_HOME/lib? Are there any
libraries which it depends on missing?</li>
<li>If a task doesn't do what you expect, run <tt>ant -verbose</tt> or <tt>ant
-debug</tt> to see what is happening</li>
</ol>
<p>If you can't fix your problem, start with the <a href="http://jakarta.apache.org/site/mail.html" target="_top">Ant
User Mailing List</a> . These are other ant users who will help you learn to
use ant. If they cannot fix it then someone may suggest filing a bug report,
which will escalate the issue. Remember of course, that support, like all open
source development tasks, is voluntary. If you haven't invested time in helping
yourself by following the steps above, it is unlikely that anyone will invest
the time in helping you. </p>
<p>Also, if you don't understand something, the <a href="http://jakarta.apache.org/site/mail.html" target="_top">Ant
User Mailing List</a> is the place to ask questions. Not the developer list,
nor the individuals whose names appears in the source and documentation. If
they answered all such emails, nobody would have any time to improve ant. </p>
<p>To provide feedback on this software, please subscribe to the <a href="http://jakarta.apache.org/site/mail.html" target="_top">Ant
User Mailing List</a> </p>
<p>If you want to contribute to Ant or stay current with the latest
development, join the
<a href="http://jakarta.apache.org/site/mail.html" target="_top">Ant Development Mailing List</a>
</p>
<p>Archives of both lists can be found at <a
href="http://archive.covalent.net/" target="_top">http://archive.covalent.net/</a>. Many
thanks to Covalent Technologies. A searchable archive can be found at <a
href="http://marc.theaimsgroup.com" target="_top">http://marc.theaimsgroup.com</a>. If
you know of any additional archive sites, please report them to the
lists.</p>
<hr>
<p align="center">Copyright &copy; 2001-2002 Apache Software Foundation. All rights
Reserved.</p>
</body>
</html>