|
- <!--
- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- -->
- <html>
-
- <head>
- <meta http-equiv="Content-Language" content="en-us">
- <link rel="stylesheet" type="text/css" href="stylesheets/style.css">
- <title>Apache Ant User Manual—Feedback</title>
- </head>
-
- <body>
-
- <h1 id="feedback">Feedback and Troubleshooting</h1>
- <p>If things do not work, especially simple things like <code>ant -version</code>,
- then something is wrong with your configuration. Before filing bug reports and
- emailing all the Apache Ant mailing lists</p>
- <ol>
- <li>Check your environment variables. Are <code>ANT_HOME</code> and <code>JAVA_HOME</code> correct? If
- they have quotes or trailing slashes, remove them.</li>
- <li>Unset <code>CLASSPATH</code>; if that is wrong things go horribly wrong. Ant does not
- need the <code>CLASSPATH</code> variable defined to anything to work.</li>
- <li>Make sure there are no versions of <samp>crimson.jar</samp> or other XML parsers in <samp>JAVA_HOME/jre/lib/ext</samp></li>
- <li>Is your path correct? is Ant on it? What about <samp>JAVA_HOME/bin</samp>? have you tested
- this? If you are using Jikes, is it on the path? A CreateProcess error (especially
- with <code>error=2</code>) 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 failing to run is from <samp>optional.jar</samp> in <samp>ANT_HOME/lib</samp>? Are there any
- libraries which it depends on missing?</li>
- <li>If a task doesn't do what you expect, run <code>ant -verbose</code> or <code>ant
- -debug</code> to see what is happening</li>
- </ol>
- <p>If you can't fix your problem, start with the <a href="https://ant.apache.org/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="https://ant.apache.org/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="https://ant.apache.org/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="https://ant.apache.org/mail.html" target="_top">Ant Development Mailing List</a></p>
- <p>A searchable archive can be found
- at <a href="https://marc.info" target="_top">https://marc.info</a>. Other
- archives will be documented online
- at <a href="https://ant.apache.org/mail.html#Archives" target="_top">Mailing Lists Archives</a></p>
-
- </body>
- </html>
|