| 1 | <!--
|
|---|
| 2 | Licensed to the Apache Software Foundation (ASF) under one or more
|
|---|
| 3 | contributor license agreements. See the NOTICE file distributed with
|
|---|
| 4 | this work for additional information regarding copyright ownership.
|
|---|
| 5 | The ASF licenses this file to You under the Apache License, Version 2.0
|
|---|
| 6 | (the "License"); you may not use this file except in compliance with
|
|---|
| 7 | the License. You may obtain a copy of the License at
|
|---|
| 8 |
|
|---|
| 9 | http://www.apache.org/licenses/LICENSE-2.0
|
|---|
| 10 |
|
|---|
| 11 | Unless required by applicable law or agreed to in writing, software
|
|---|
| 12 | distributed under the License is distributed on an "AS IS" BASIS,
|
|---|
| 13 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|---|
| 14 | See the License for the specific language governing permissions and
|
|---|
| 15 | limitations under the License.
|
|---|
| 16 | -->
|
|---|
| 17 | <html>
|
|---|
| 18 |
|
|---|
| 19 | <head>
|
|---|
| 20 | <meta http-equiv="Content-Language" content="en-us">
|
|---|
| 21 | <link rel="stylesheet" type="text/css" href="stylesheets/style.css">
|
|---|
| 22 | <title>Apache Ant User Manual - Feedback</title>
|
|---|
| 23 | </head>
|
|---|
| 24 |
|
|---|
| 25 | <body>
|
|---|
| 26 |
|
|---|
| 27 | <h1><a name="feedback">Feedback</a> and Troubleshooting</h1>
|
|---|
| 28 | <p>If things do not work, especially simple things like <tt>ant -version</tt>,
|
|---|
| 29 | then something is wrong with your configuration. Before filing bug reports and
|
|---|
| 30 | emailing all the ant mailing lists</p>
|
|---|
| 31 | <ol>
|
|---|
| 32 | <li>Check your environment variables. Are ANT_HOME and JAVA_HOME correct? If
|
|---|
| 33 | they have quotes or trailing slashes, remove them.</li>
|
|---|
| 34 | <li>Unset CLASSPATH; if that is wrong things go horribly wrong. Ant does not
|
|---|
| 35 | need the CLASSPATH variable defined to anything to work.</li>
|
|---|
| 36 | <li>Make sure there are no versions of crimson.jar or other XML parsers in JRE/ext</li>
|
|---|
| 37 | <li>Is your path correct? is Ant on it? What about JDK/bin? have you tested
|
|---|
| 38 | this? If you are using Jikes, is it on the path? A createProcess error (especially
|
|---|
| 39 | with ID=2 on windows) usually means executable not found on the path.</li>
|
|---|
| 40 | <li>Which version of ant are you running? Other applications distribute a copy
|
|---|
| 41 | -it may be being picked up by accident.</li>
|
|---|
| 42 | <li>If a task is failing to run is optional.jar in ANT_HOME/lib? Are there any
|
|---|
| 43 | libraries which it depends on missing?</li>
|
|---|
| 44 | <li>If a task doesn't do what you expect, run <tt>ant -verbose</tt> or <tt>ant
|
|---|
| 45 | -debug</tt> to see what is happening</li>
|
|---|
| 46 | </ol>
|
|---|
| 47 | <p>If you can't fix your problem, start with the <a href="http://ant.apache.org/mail.html" target="_top">Ant
|
|---|
| 48 | User Mailing List</a> . These are other ant users who will help you learn to
|
|---|
| 49 | use ant. If they cannot fix it then someone may suggest filing a bug report,
|
|---|
| 50 | which will escalate the issue. Remember of course, that support, like all open
|
|---|
| 51 | source development tasks, is voluntary. If you haven't invested time in helping
|
|---|
| 52 | yourself by following the steps above, it is unlikely that anyone will invest
|
|---|
| 53 | the time in helping you. </p>
|
|---|
| 54 | <p>Also, if you don't understand something, the <a href="http://ant.apache.org/mail.html" target="_top">Ant
|
|---|
| 55 | User Mailing List</a> is the place to ask questions. Not the developer list,
|
|---|
| 56 | nor the individuals whose names appears in the source and documentation. If
|
|---|
| 57 | they answered all such emails, nobody would have any time to improve ant. </p>
|
|---|
| 58 | <p>To provide feedback on this software, please subscribe to the <a href="http://ant.apache.org/mail.html" target="_top">Ant
|
|---|
| 59 | User Mailing List</a> </p>
|
|---|
| 60 |
|
|---|
| 61 | <p>If you want to contribute to Ant or stay current with the latest
|
|---|
| 62 | development, join the
|
|---|
| 63 | <a href="http://ant.apache.org/mail.html" target="_top">Ant Development Mailing List</a>
|
|---|
| 64 | </p>
|
|---|
| 65 | <p>A searchable archive can be found at <a
|
|---|
| 66 | href="http://marc.theaimsgroup.com" target="_top">http://marc.theaimsgroup.com</a>.
|
|---|
| 67 | Other archives will be documented online at <a href="http://ant.apache.org/mail.html#Archives" target="_top">Mailing Lists Archives</a> </p>
|
|---|
| 68 |
|
|---|
| 69 |
|
|---|
| 70 | </body>
|
|---|
| 71 | </html>
|
|---|
| 72 |
|
|---|
