|
- <!DOCTYPE html>
- <!--
- 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
-
- https://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 lang="en">
-
- <head>
- <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 <kbd>ant -version</kbd>, 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 <kbd>ant -verbose</kbd> or <kbd>ant -debug</kbd>
- 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>
|