of what was in "problems". updating some info. git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@345865 13f79535-47bb-0310-9956-ffa450edef68master
| @@ -146,10 +146,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -138,10 +138,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -0,0 +1,345 @@ | |||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> | |||
| <html lang="en"> | |||
| <!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! --> | |||
| <head> | |||
| <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
| <title>Apache Ant - Bug database</title> | |||
| <link type="text/css" href="./page.css" rel="stylesheet"> | |||
| <meta name="author" content="Antoine Levy-Lambert"> | |||
| <meta name="email" content=""> | |||
| </head> | |||
| <body> | |||
| <p class="navpath"> | |||
| <script src="./breadcrumbs.js" language="JavaScript" type="text/javascript"></script> | |||
| </p> | |||
| <div class="logobar"> | |||
| <table width="100%" border="0" cellspacing="0" cellpadding="0"> | |||
| <tr> | |||
| <td align="left"><img border="0" alt="Apache Ant site" src="./images/group-logo.gif"></td> | |||
| <td align="center" width="100%"><img alt="Apache Ant logo" border="0" src="./images/project-logo.gif"></td> | |||
| <td align="right"> | |||
| <form target="_blank" onsubmit="q.value = query.value + ' site:ant.apache.org'" action="http://www.google.com/search" method="get"> | |||
| <table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F"> | |||
| <tr> | |||
| <td colspan="3"><img height="10" width="1" alt="" src="./images/spacer.gif"></td> | |||
| </tr> | |||
| <tr> | |||
| <td><img height="1" width="1" alt="" src="./images/spacer.gif"></td> | |||
| <td nowrap="nowrap" class="searchcaption"> | |||
| <input name="q" type="hidden"> | |||
| <input size="15" id="query" type="text"> | |||
| <img height="1" width="5" alt="" src="./images/spacer.gif"> | |||
| <input name="Search" value="Search" type="submit"> | |||
| <br> | |||
| the Apache Ant site | |||
| </td> | |||
| <td><img height="1" width="1" alt="" src="./images/spacer.gif"></td> | |||
| </tr> | |||
| <tr> | |||
| <td><img alt="" border="0" height="10" width="9" src="./images/search-left.gif"></td> | |||
| <td><img height="1" width="1" alt="" src="./images/spacer.gif"></td> | |||
| <td><img alt="" border="0" height="10" width="9" src="./images/search-right.gif"></td> | |||
| </tr> | |||
| </table> | |||
| </form> | |||
| </td> | |||
| </tr> | |||
| </table> | |||
| </div> | |||
| <div class="tab"> | |||
| <table summary="tab bar" border="0" cellpadding="0" cellspacing="0"> | |||
| <tr> | |||
| <td width="8"><img alt="" height="5" width="8" src="./images/spacer.gif"></td><td valign="bottom"> | |||
| <table summary="selected tab" style="height: 1.5em" border="0" cellpadding="0" cellspacing="0"> | |||
| <tr> | |||
| <td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="./images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b>Home</b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="./images/tabSel-right.gif"></td> | |||
| </tr> | |||
| </table> | |||
| </td> | |||
| <td width="5"><img alt="" height="8" width="8" src="./images/spacer.gif"></td><td valign="bottom"> | |||
| <table summary="non selected tab" style="height: 1.4em" border="0" cellpadding="0" cellspacing="0"> | |||
| <tr> | |||
| <td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="./images/tab-left.gif"></td><td valign="middle" bgcolor="#B2C4E0"><a href="./projects/index.html"><font size="2" face="Arial, Helvetica, Sans-serif">Projects</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="./images/tab-right.gif"></td> | |||
| </tr> | |||
| </table> | |||
| </td> | |||
| </tr> | |||
| </table> | |||
| </div> | |||
| <div class="bluebar"></div> | |||
| <div class="menucontainer"> | |||
| <div align="center"> | |||
| <a href="http://ApacheCon.Com/"><img width="125" height="125" | |||
| border="0" style="background-color: white" | |||
| src="http://www.apache.org/images/ac2005us_blue_125x125.jpg" | |||
| alt="ApacheCon!" title="Come to ApacheCon!"/></a> | |||
| </div> | |||
| <div class="menu"> | |||
| <ul> | |||
| <li class="menuheader">Apache Ant | |||
| <ul> | |||
| <li> | |||
| <a href="./index.html">Welcome</a> | |||
| </li> | |||
| <li> | |||
| <a href="./license.html">License</a> | |||
| </li> | |||
| <li> | |||
| <a href="./antnews.html">News</a> | |||
| </li> | |||
| </ul> | |||
| </li> | |||
| <li class="menuheader">Documentation | |||
| <ul> | |||
| <li> | |||
| <a href="./manual/index.html">Manual</a> | |||
| </li> | |||
| <li> | |||
| <a href="./projects.html">Related Projects</a> | |||
| </li> | |||
| <li> | |||
| <a href="./external.html">External Tools and Tasks</a> | |||
| </li> | |||
| <li> | |||
| <a href="./resources.html">Resources</a> | |||
| </li> | |||
| <li> | |||
| <a href="./faq.html">Frequently Asked Questions</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://wiki.apache.org/ant/FrontPage">Wiki</a> | |||
| </li> | |||
| <li> | |||
| <a href="./problems.html">Having Problems?</a> | |||
| </li> | |||
| </ul> | |||
| </li> | |||
| <li class="menuheader">Download | |||
| <ul> | |||
| <li> | |||
| <a href="http://ant.apache.org/bindownload.cgi">Binary Distributions</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://ant.apache.org/srcdownload.cgi">Source Distributions</a> | |||
| </li> | |||
| </ul> | |||
| </li> | |||
| <li class="menuheader">Contributing | |||
| <ul> | |||
| <li> | |||
| <a href="./mail.html">Mailing Lists</a> | |||
| </li> | |||
| <li> | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| </li> | |||
| </ul> | |||
| </li> | |||
| <li class="menuheader">Project Management | |||
| <ul> | |||
| <li> | |||
| <a href="./contributors.html">Contributors</a> | |||
| </li> | |||
| <li> | |||
| <a href="./mission.html">Apache Ant Mission</a> | |||
| </li> | |||
| <li> | |||
| <a href="./bylaws.html">Project Bylaws</a> | |||
| </li> | |||
| <li> | |||
| <a href="./legal.html">Legal</a> | |||
| </li> | |||
| </ul> | |||
| </li> | |||
| </ul> | |||
| </div> | |||
| <img style="float: left" height="10" width="10" border="0" alt="" src="./images/menu-left.gif"> | |||
| <img style="float: right" height="10" width="10" border="0" alt="" src="./images/menu-right.gif"> | |||
| </div> | |||
| <div class="lightbluebar"> </div> | |||
| <div class="main"> | |||
| <div class="content"> | |||
| <h1 class="title">Bug database</h1> | |||
| <h3 class="section"> | |||
| <a name="Bug Database"></a> | |||
| Bug Database | |||
| </h3> | |||
| <p> | |||
| This page gives you some bookmarks to use the Bugzilla <a href="http://issues.apache.org/bugzilla/"> | |||
| Apache Bug Database</a>. | |||
| </p> | |||
| <p> | |||
| This link <a href="http://issues.apache.org/">issues.apache.org</a> connects you | |||
| to the complete list of Apache Bug Database systems. | |||
| </p> | |||
| <h4 class="subsection"> | |||
| <a name="Has It Been Reported?"></a> | |||
| Has It Been Reported? | |||
| </h4> | |||
| <p> | |||
| If the current nightly build doesn't resolve your problem, it is | |||
| possible that someone else has reported the issue. It is time to | |||
| look at . This system is easy to use, and it will | |||
| let you search the <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Ant&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.bug_id"> | |||
| currently open</a> and resolved bugs to see if your problem has | |||
| already been reported. If your problem has been reported, you can | |||
| see whether any of the developers have commented, suggesting | |||
| workarounds, or the reason for the bug, etc. Or you may have | |||
| information to add (see about creating and modifying bug reports | |||
| below), in which case, go right ahead and add the information. | |||
| If you don't have any additional information, you may just want | |||
| to vote for this bug, and perhaps | |||
| add yourself to the <code>CC</code> list to follow the progress | |||
| of this bug. | |||
| </p> | |||
| <p><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Ant&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&field0-0-0=noop&type0-0-0=noop&value0-0-0=">Open Ant bugs by order of priority</a>.</p> | |||
| <p><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Ant&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.votes,bugs.priority%2Cbugs.bug_severity&query_based_on=">Open Ant bugs by number of votes</a>.</p> | |||
| <h4 class="subsection"> | |||
| <a name="Filing a Bug Report"></a> | |||
| Filing a Bug Report | |||
| </h4> | |||
| <p> | |||
| Please read our document about <a href="problems.html">problems</a> | |||
| before deciding that there is an unreported | |||
| bug in Ant. | |||
| </p> | |||
| <p> | |||
| You have a few choices at this point. You can send | |||
| an email to the <code>user</code> mailing list | |||
| to see if | |||
| others have encountered your issue and find out how they may | |||
| have worked around it. If after some discussion, you feel it | |||
| is time to create | |||
| a bug report, this is a simple operation in the bug database. | |||
| Please try to provide as much information as possible in order | |||
| to assist the developers in resolving the bug. Please try to enter | |||
| correct values for the various inputs when creating the bug, such | |||
| as which version of Ant you are running, and on which platform, | |||
| etc. Once the bug is created, you can also add attachments to | |||
| the bug report. | |||
| </p> | |||
| <p> | |||
| What information should you include in your bug report? The | |||
| easiest bugs to fix are those that are most easily reproducible, | |||
| so it is really helpful if you can produce a small test case that | |||
| exhibits the problem. In this case, you would attach the build file | |||
| and any other files necessary to reproduce the problem, probably | |||
| packed together in an archive. If you can't produce a test case, | |||
| you should try to include a snippet from your build file and the | |||
| relevant sections from the verbose or debug output from Ant. Try | |||
| to include the header information where Ant states the version, | |||
| the OS and VM information, etc. As debug output is likely to be | |||
| very large, it's best to remove any output that is not | |||
| relevant. Once the bug is entered into the bug database, you | |||
| will be kept informed by email about progress on the bug. If | |||
| you receive email asking for further information, please try to | |||
| respond, as it will aid in the resolution of your bug. | |||
| </p> | |||
| <p> | |||
| To create the bug report hit this | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant"> | |||
| link</a>. | |||
| </p> | |||
| <h4 class="subsection"> | |||
| <a name="Asking for an Enhancement"></a> | |||
| Asking for an Enhancement | |||
| </h4> | |||
| <p> | |||
| Sometimes, you may find that Ant just doesn't do what you need it | |||
| to. It isn't a bug, as such, since Ant is working the way it is | |||
| supposed to work. Perhaps it is some additional functionality for | |||
| a task that hasn't been thought of yet, or maybe a completely new | |||
| task. For these situations, you will | |||
| want to raise an <i>enhancement request</i>. Enhancement requests | |||
| are managed using the same Apache Bug Database described above. | |||
| These are just a different type of bug report. If you look in the | |||
| bug database, you will see that one of the severity settings for | |||
| a bug is "Enhancement". Just fill the bug report in, | |||
| set the severity of the bug to "Enhancement", and | |||
| state in the description how you would like to have Ant enhanced. | |||
| Again, you should first check whether there are any existing | |||
| enhancment requests that cover your needs. If so, just add your | |||
| vote to these. | |||
| </p> | |||
| <p> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement"> | |||
| Create an enhancement report</a> | |||
| </p> | |||
| <h4 class="subsection"> | |||
| <a name="Fixing the Bug"></a> | |||
| Fixing the Bug | |||
| </h4> | |||
| <p> | |||
| If you aren't satisfied with just filing a bug report, you can | |||
| try to find the cause of the problem and provide a fix yourself. | |||
| The best way to do that is by working with the latest code from CVS. | |||
| Alternatively, you can work with the source code available from the | |||
| <a href="http://ant.apache.org/srcdownload.cgi"> | |||
| source distributions</a>. If you | |||
| are going to tackle the problem at this level, you may want to | |||
| discuss some details first on the <code>dev</code> | |||
| mailing list. Once you have a fix for the problem, you may submit | |||
| the fix as a <i>patch</i> to either the | |||
| <code>dev</code> mailing | |||
| list, or enter the bug database as described above and attach the | |||
| patch to the bug report. Using the bug database has the advantage | |||
| of being able to track the progress of your patch. | |||
| </p> | |||
| <p> | |||
| If you have a patch to submit and are sending it to the | |||
| <code>dev</code> mailing list, | |||
| prefix "[PATCH]" | |||
| to your message subject. Please include any relevant bug numbers. | |||
| Patch files should be created with the <code>-u</code> | |||
| option of the | |||
| <code>diff</code> or <code>cvs diff</code> command. For | |||
| example:<br /><br /> | |||
| <font face="verdana" size="-1"> | |||
| diff -u Javac.java.orig Javac.java > javac.diffs<br /><br /> | |||
| </font> | |||
| or, if you have source from CVS:<br /><br /> | |||
| <font face="verdana" size="-1"> | |||
| cvs diff -u Javac.java > javac.diffs<br /><br /> | |||
| </font> | |||
| Note: You should give your patch files meaningful names. | |||
| This makes it easier for developers who need to apply a number | |||
| of different patch files. | |||
| </p> | |||
| </div> | |||
| </div> | |||
| <p class="copyright"> | |||
| Copyright © 2000-2005 The Apache Software Foundation. All rights reserved. | |||
| <script type="text/javascript" language="JavaScript"><!-- | |||
| document.write(" - "+"Last Published: " + document.lastModified); | |||
| // --> | |||
| </script> | |||
| </p> | |||
| </body> | |||
| </html> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -1666,7 +1663,7 @@ mv /tmp/foo $ANT_HOME/bin/antRun | |||
| <code>org.apache.tools.ant.taskdefs.XSLTLiaison</code> | |||
| class.</p> | |||
| <p>Ant's class loader implementation uses Java's | |||
| delegation model, see <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/ClassLoader.html">http://java.sun.com/j2se/1.5.0/docs/api/java/lang/ClassLoader.html</a> | |||
| delegation model, see <a href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/ClassLoader.html">http://java.sun.com/products/jdk/1.2/docs/api/java/lang/ClassLoader.html</a> | |||
| the paragraph</p> | |||
| <blockquote>The <code>ClassLoader</code> class uses a | |||
| delegation model to search for classes and resources. Each | |||
| @@ -142,10 +142,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -240,7 +237,7 @@ | |||
| <br /><br /> | |||
| <font face="verdana" size="-1">ant -v</font> | |||
| <br /><br /> | |||
| This will produce output that starts like the following:</p> | |||
| <table class="ForrestTable" cellspacing="1" cellpadding="4"> | |||
| <tr> | |||
| @@ -289,7 +286,7 @@ Complete build sequence is [debug, gensrc, compile, jar, test]<br /> | |||
| skipping another. | |||
| This is followed by which compiler it will be using, the | |||
| arguments that will get passed to the compiler, | |||
| and a list of all the class files to be compiled. | |||
| and a list of all the class files to be compiled. | |||
| </p> | |||
| <table class="ForrestTable" cellspacing="1" cellpadding="4"> | |||
| <tr> | |||
| @@ -330,143 +327,26 @@ D:\src\java\Unset.java<br /> | |||
| After examining the debug output, if you still believe that the | |||
| problem you are having is caused by Ant, chances are that someone | |||
| else may have already encountered this problem, and perhaps it has | |||
| been fixed. The next step, therefore, may be to try a nightly build | |||
| of Ant to see if the problem has been fixed. <!--Nightly builds for Ant | |||
| are available from the | |||
| <a href="http://brutus.apache.org/~nightlybuild/builds/ant/"> | |||
| Ant web site</a>.--> While Ant nightly builds are typically quite | |||
| stable and are used by | |||
| <a href="http://brutus.apache.org/gump/public/">Gump</a> | |||
| to build many other Jakarta projects, these builds should | |||
| nonetheless be treated as experimental. Note that nightly builds | |||
| do not build many of the optional tasks the come with Ant. | |||
| A snapshot of these optional tasks is occasionally uploaded to | |||
| the nightly download | |||
| <a href="http://cvs.apache.org/builds/ant/nightly/optional/"> | |||
| area</a>. However, even this snapshot does not contain every | |||
| optional task. | |||
| been fixed. The next step, therefore, would be to download the | |||
| sources of ant, see <a href="svn.html">svn</a>. | |||
| </p> | |||
| <h4 class="subsection"> | |||
| <a name="Has It Been Reported?"></a> | |||
| Has It Been Reported? | |||
| </h4> | |||
| <p> | |||
| If the current nightly build doesn't resolve your problem, it is | |||
| possible that someone else has reported the issue. It is time to | |||
| look at the <a href="http://issues.apache.org/bugzilla/"> | |||
| Apache Bug Database</a>. This system is easy to use, and it will | |||
| let you search the <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Ant&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.bug_id"> | |||
| currently open</a> and resolved bugs to see if your problem has | |||
| already been reported. If your problem has been reported, you can | |||
| see whether any of the developers have commented, suggesting | |||
| workarounds, or the reason for the bug, etc. Or you may have | |||
| information to add (see about creating and modifying bug reports | |||
| below), in which case, go right ahead and add the information. | |||
| If you don't have any additional information, you may just want | |||
| to vote for this bug, and perhaps | |||
| add yourself to the <code>CC</code> list to follow the progress | |||
| of this bug. | |||
| </p> | |||
| <h4 class="subsection"> | |||
| <a name="Filing a Bug Report"></a> | |||
| Filing a Bug Report | |||
| </h4> | |||
| <p> | |||
| By this time, you may have decided that there is an unreported | |||
| bug in Ant. You have a few choices at this point. You can send | |||
| an email to the <code>user</code> mailing list | |||
| to see if | |||
| others have encountered your issue and find out how they may | |||
| have worked around it. If after some discussion, you feel it | |||
| is time to create | |||
| a bug report, this is a simple operation in the bug database. | |||
| Please try to provide as much information as possible in order | |||
| to assist the developers in resolving the bug. Please try to enter | |||
| correct values for the various inputs when creating the bug, such | |||
| as which version of Ant you are running, and on which platform, | |||
| etc. Once the bug is created, you can also add attachments to | |||
| the bug report. | |||
| </p> | |||
| <p> | |||
| What information should you include in your bug report? The | |||
| easiest bugs to fix are those that are most easily reproducible, | |||
| so it is really helpful if you can produce a small test case that | |||
| exhibits the problem. In this case, you would attach the build file | |||
| and any other files necessary to reproduce the problem, probably | |||
| packed together in an archive. If you can't produce a test case, | |||
| you should try to include a snippet from your build file and the | |||
| relevant sections from the verbose or debug output from Ant. Try | |||
| to include the header information where Ant states the version, | |||
| the OS and VM information, etc. As debug output is likely to be | |||
| very large, it's best to remove any output that is not | |||
| relevant. Once the bug is entered into the bug database, you | |||
| will be kept informed by email about progress on the bug. If | |||
| you receive email asking for further information, please try to | |||
| respond, as it will aid in the resolution of your bug. | |||
| </p> | |||
| <h4 class="subsection"> | |||
| <a name="Asking for an Enhancement"></a> | |||
| Asking for an Enhancement | |||
| </h4> | |||
| <p> | |||
| Sometimes, you may find that Ant just doesn't do what you need it | |||
| to. It isn't a bug, as such, since Ant is working the way it is | |||
| supposed to work. Perhaps it is some additional functionality for | |||
| a task that hasn't been thought of yet, or maybe a completely new | |||
| task. For these situations, you will | |||
| want to raise an <i>enhancement request</i>. Enhancement requests | |||
| are managed using the same Apache Bug Database described above. | |||
| These are just a different type of bug report. If you look in the | |||
| bug database, you will see that one of the severity settings for | |||
| a bug is "Enhancement". Just fill the bug report in, | |||
| set the severity of the bug to "Enhancement", and | |||
| state in the description how you would like to have Ant enhanced. | |||
| Again, you should first check whether there are any existing | |||
| enhancment requests that cover your needs. If so, just add your | |||
| vote to these. | |||
| </p> | |||
| <h4 class="subsection"> | |||
| <a name="Fixing the Bug"></a> | |||
| Fixing the Bug | |||
| </h4> | |||
| <p> | |||
| If you aren't satisfied with just filing a bug report, you can | |||
| try to find the cause of the problem and provide a fix yourself. | |||
| The best way to do that is by working with the latest code from CVS. | |||
| Alternatively, you can work with the source code available from the | |||
| <a href="http://ant.apache.org/srcdownload.cgi"> | |||
| source distributions</a>. If you | |||
| are going to tackle the problem at this level, you may want to | |||
| discuss some details first on the <code>dev</code> | |||
| mailing list. Once you have a fix for the problem, you may submit | |||
| the fix as a <i>patch</i> to either the | |||
| <code>dev</code> mailing | |||
| list, or enter the bug database as described above and attach the | |||
| patch to the bug report. Using the bug database has the advantage | |||
| of being able to track the progress of your patch. | |||
| </p> | |||
| <p> | |||
| If you have a patch to submit and are sending it to the | |||
| <code>dev</code> mailing list, | |||
| prefix "[PATCH]" | |||
| to your message subject. Please include any relevant bug numbers. | |||
| Patch files should be created with the <code>-u</code> | |||
| option of the | |||
| <code>diff</code> or <code>cvs diff</code> command. For | |||
| example:<br /><br /> | |||
| <font face="verdana" size="-1"> | |||
| diff -u Javac.java.orig Javac.java > javac.diffs<br /><br /> | |||
| </font> | |||
| or, if you have source from CVS:<br /><br /> | |||
| <font face="verdana" size="-1"> | |||
| cvs diff -u Javac.java > javac.diffs<br /><br /> | |||
| </font> | |||
| Note: You should give your patch files meaningful names. | |||
| This makes it easier for developers who need to apply a number | |||
| of different patch files. | |||
| <a href="http://vmgump.apache.org/gump/public/index.html">Gump</a> | |||
| is building ant every night and using the ant built from the | |||
| latest source to build a long list of open source projects. However, | |||
| the version of ant built by gump is not available for download. Even | |||
| if it were, it would not include most of the optional tasks. | |||
| </p> | |||
| <p> | |||
| We currently do not have nightly builds including the optional tasks. | |||
| </p> | |||
| <h3 class="section"> | |||
| <a name="bugs"></a> | |||
| bugs | |||
| </h3> | |||
| <p>If you ar convinced that you have identified an unfixed bug, please turn to | |||
| our document concerning the <a href="bugs.html">bug database</a>.</p> | |||
| </div> | |||
| </div> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -138,10 +138,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -140,10 +140,7 @@ | |||
| <a href="./svn.html">Subversion Repositories</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement">Enhancement Requests</a> | |||
| <a href="./bugs.html">Bug Database</a> | |||
| </li> | |||
| <li> | |||
| <a href="http://www.apache.org/foundation/contributing.html">Donations</a> | |||
| @@ -0,0 +1,168 @@ | |||
| <?xml version="1.0"?> | |||
| <!-- | |||
| Copyright 2005 The Apache Software Foundation | |||
| Licensed 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. | |||
| --> | |||
| <document> | |||
| <properties> | |||
| <author email="">Antoine Levy-Lambert</author> | |||
| <title>Bug database</title> | |||
| </properties> | |||
| <body> | |||
| <section name="Bug Database"> | |||
| <p> | |||
| This page gives you some bookmarks to use the Bugzilla <a href="http://issues.apache.org/bugzilla/"> | |||
| Apache Bug Database</a>. | |||
| </p> | |||
| <p> | |||
| This link <a href="http://issues.apache.org/">issues.apache.org</a> connects you | |||
| to the complete list of Apache Bug Database systems. | |||
| </p> | |||
| <subsection name="Has It Been Reported?"> | |||
| <p> | |||
| If the current nightly build doesn't resolve your problem, it is | |||
| possible that someone else has reported the issue. It is time to | |||
| look at . This system is easy to use, and it will | |||
| let you search the <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Ant&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.bug_id"> | |||
| currently open</a> and resolved bugs to see if your problem has | |||
| already been reported. If your problem has been reported, you can | |||
| see whether any of the developers have commented, suggesting | |||
| workarounds, or the reason for the bug, etc. Or you may have | |||
| information to add (see about creating and modifying bug reports | |||
| below), in which case, go right ahead and add the information. | |||
| If you don't have any additional information, you may just want | |||
| to vote for this bug, and perhaps | |||
| add yourself to the <code>CC</code> list to follow the progress | |||
| of this bug. | |||
| </p> | |||
| <p><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Ant&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&field0-0-0=noop&type0-0-0=noop&value0-0-0=">Open Ant bugs by order of priority</a>.</p> | |||
| <p><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Ant&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.votes,bugs.priority%2Cbugs.bug_severity&query_based_on=">Open Ant bugs by number of votes</a>.</p> | |||
| </subsection> | |||
| <subsection name="Filing a Bug Report"> | |||
| <p> | |||
| Please read our document about <a href="problems.html">problems</a> | |||
| before deciding that there is an unreported | |||
| bug in Ant. | |||
| </p> | |||
| <p> | |||
| You have a few choices at this point. You can send | |||
| an email to the <code>user</code> mailing list | |||
| to see if | |||
| others have encountered your issue and find out how they may | |||
| have worked around it. If after some discussion, you feel it | |||
| is time to create | |||
| a bug report, this is a simple operation in the bug database. | |||
| Please try to provide as much information as possible in order | |||
| to assist the developers in resolving the bug. Please try to enter | |||
| correct values for the various inputs when creating the bug, such | |||
| as which version of Ant you are running, and on which platform, | |||
| etc. Once the bug is created, you can also add attachments to | |||
| the bug report. | |||
| </p> | |||
| <p> | |||
| What information should you include in your bug report? The | |||
| easiest bugs to fix are those that are most easily reproducible, | |||
| so it is really helpful if you can produce a small test case that | |||
| exhibits the problem. In this case, you would attach the build file | |||
| and any other files necessary to reproduce the problem, probably | |||
| packed together in an archive. If you can't produce a test case, | |||
| you should try to include a snippet from your build file and the | |||
| relevant sections from the verbose or debug output from Ant. Try | |||
| to include the header information where Ant states the version, | |||
| the OS and VM information, etc. As debug output is likely to be | |||
| very large, it's best to remove any output that is not | |||
| relevant. Once the bug is entered into the bug database, you | |||
| will be kept informed by email about progress on the bug. If | |||
| you receive email asking for further information, please try to | |||
| respond, as it will aid in the resolution of your bug. | |||
| </p> | |||
| <p> | |||
| To create the bug report hit this | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant"> | |||
| link</a>. | |||
| </p> | |||
| </subsection> | |||
| <subsection name="Asking for an Enhancement"> | |||
| <p> | |||
| Sometimes, you may find that Ant just doesn't do what you need it | |||
| to. It isn't a bug, as such, since Ant is working the way it is | |||
| supposed to work. Perhaps it is some additional functionality for | |||
| a task that hasn't been thought of yet, or maybe a completely new | |||
| task. For these situations, you will | |||
| want to raise an <i>enhancement request</i>. Enhancement requests | |||
| are managed using the same Apache Bug Database described above. | |||
| These are just a different type of bug report. If you look in the | |||
| bug database, you will see that one of the severity settings for | |||
| a bug is "Enhancement". Just fill the bug report in, | |||
| set the severity of the bug to "Enhancement", and | |||
| state in the description how you would like to have Ant enhanced. | |||
| Again, you should first check whether there are any existing | |||
| enhancment requests that cover your needs. If so, just add your | |||
| vote to these. | |||
| </p> | |||
| <p> | |||
| <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&bug_severity=enhancement"> | |||
| Create an enhancement report</a> | |||
| </p> | |||
| </subsection> | |||
| <subsection name="Fixing the Bug"> | |||
| <p> | |||
| If you aren't satisfied with just filing a bug report, you can | |||
| try to find the cause of the problem and provide a fix yourself. | |||
| The best way to do that is by working with the latest code from CVS. | |||
| Alternatively, you can work with the source code available from the | |||
| <a href="http://ant.apache.org/srcdownload.cgi"> | |||
| source distributions</a>. If you | |||
| are going to tackle the problem at this level, you may want to | |||
| discuss some details first on the <code>dev</code> | |||
| mailing list. Once you have a fix for the problem, you may submit | |||
| the fix as a <i>patch</i> to either the | |||
| <code>dev</code> mailing | |||
| list, or enter the bug database as described above and attach the | |||
| patch to the bug report. Using the bug database has the advantage | |||
| of being able to track the progress of your patch. | |||
| </p> | |||
| <p> | |||
| If you have a patch to submit and are sending it to the | |||
| <code>dev</code> mailing list, | |||
| prefix "[PATCH]" | |||
| to your message subject. Please include any relevant bug numbers. | |||
| Patch files should be created with the <code>-u</code> | |||
| option of the | |||
| <code>diff</code> or <code>cvs diff</code> command. For | |||
| example:<br></br><br></br> | |||
| <font face="verdana" size="-1"> | |||
| diff -u Javac.java.orig Javac.java > javac.diffs<br></br><br></br> | |||
| </font> | |||
| or, if you have source from CVS:<br></br><br></br> | |||
| <font face="verdana" size="-1"> | |||
| cvs diff -u Javac.java > javac.diffs<br></br><br></br> | |||
| </font> | |||
| Note: You should give your patch files meaningful names. | |||
| This makes it easier for developers who need to apply a number | |||
| of different patch files. | |||
| </p> | |||
| </subsection> | |||
| </section> | |||
| </body> | |||
| </document> | |||
| @@ -33,7 +33,7 @@ | |||
| you may encounter - these are just some suggestions to point | |||
| 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 | |||
| @@ -57,7 +57,7 @@ | |||
| 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"> | |||
| @@ -84,7 +84,7 @@ | |||
| <br></br><br></br> | |||
| <font face="verdana" size="-1">ant -v</font> | |||
| <br></br><br></br> | |||
| This will produce output that starts like the following:</p> | |||
| <table> | |||
| <tr> | |||
| @@ -130,7 +130,7 @@ Complete build sequence is [debug, gensrc, compile, jar, test]<br></br> | |||
| skipping another. | |||
| This is followed by which compiler it will be using, the | |||
| arguments that will get passed to the compiler, | |||
| and a list of all the class files to be compiled. | |||
| and a list of all the class files to be compiled. | |||
| </p> | |||
| <table> | |||
| <tr> | |||
| @@ -168,142 +168,28 @@ D:\src\java\Unset.java<br></br> | |||
| After examining the debug output, if you still believe that the | |||
| problem you are having is caused by Ant, chances are that someone | |||
| else may have already encountered this problem, and perhaps it has | |||
| been fixed. The next step, therefore, may be to try a nightly build | |||
| of Ant to see if the problem has been fixed. <!--Nightly builds for Ant | |||
| are available from the | |||
| <a href="http://brutus.apache.org/~nightlybuild/builds/ant/"> | |||
| Ant web site</a>.--> While Ant nightly builds are typically quite | |||
| stable and are used by | |||
| <a href="http://brutus.apache.org/gump/public/">Gump</a> | |||
| to build many other Jakarta projects, these builds should | |||
| nonetheless be treated as experimental. Note that nightly builds | |||
| do not build many of the optional tasks the come with Ant. | |||
| A snapshot of these optional tasks is occasionally uploaded to | |||
| the nightly download | |||
| <a href="http://cvs.apache.org/builds/ant/nightly/optional/"> | |||
| area</a>. However, even this snapshot does not contain every | |||
| optional task. | |||
| been fixed. The next step, therefore, would be to download the | |||
| sources of ant, see <a href="svn.html">svn</a>. | |||
| </p> | |||
| </subsection> | |||
| <subsection name="Has It Been Reported?"> | |||
| <p> | |||
| If the current nightly build doesn't resolve your problem, it is | |||
| possible that someone else has reported the issue. It is time to | |||
| look at the <a href="http://issues.apache.org/bugzilla/"> | |||
| Apache Bug Database</a>. This system is easy to use, and it will | |||
| let you search the <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Ant&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.bug_id"> | |||
| currently open</a> and resolved bugs to see if your problem has | |||
| already been reported. If your problem has been reported, you can | |||
| see whether any of the developers have commented, suggesting | |||
| workarounds, or the reason for the bug, etc. Or you may have | |||
| information to add (see about creating and modifying bug reports | |||
| below), in which case, go right ahead and add the information. | |||
| If you don't have any additional information, you may just want | |||
| to vote for this bug, and perhaps | |||
| add yourself to the <code>CC</code> list to follow the progress | |||
| of this bug. | |||
| </p> | |||
| </subsection> | |||
| <subsection name="Filing a Bug Report"> | |||
| <p> | |||
| By this time, you may have decided that there is an unreported | |||
| bug in Ant. You have a few choices at this point. You can send | |||
| an email to the <code>user</code> mailing list | |||
| to see if | |||
| others have encountered your issue and find out how they may | |||
| have worked around it. If after some discussion, you feel it | |||
| is time to create | |||
| a bug report, this is a simple operation in the bug database. | |||
| Please try to provide as much information as possible in order | |||
| to assist the developers in resolving the bug. Please try to enter | |||
| correct values for the various inputs when creating the bug, such | |||
| as which version of Ant you are running, and on which platform, | |||
| etc. Once the bug is created, you can also add attachments to | |||
| the bug report. | |||
| </p> | |||
| <p> | |||
| What information should you include in your bug report? The | |||
| easiest bugs to fix are those that are most easily reproducible, | |||
| so it is really helpful if you can produce a small test case that | |||
| exhibits the problem. In this case, you would attach the build file | |||
| and any other files necessary to reproduce the problem, probably | |||
| packed together in an archive. If you can't produce a test case, | |||
| you should try to include a snippet from your build file and the | |||
| relevant sections from the verbose or debug output from Ant. Try | |||
| to include the header information where Ant states the version, | |||
| the OS and VM information, etc. As debug output is likely to be | |||
| very large, it's best to remove any output that is not | |||
| relevant. Once the bug is entered into the bug database, you | |||
| will be kept informed by email about progress on the bug. If | |||
| you receive email asking for further information, please try to | |||
| respond, as it will aid in the resolution of your bug. | |||
| </p> | |||
| </subsection> | |||
| <subsection name="Asking for an Enhancement"> | |||
| <p> | |||
| Sometimes, you may find that Ant just doesn't do what you need it | |||
| to. It isn't a bug, as such, since Ant is working the way it is | |||
| supposed to work. Perhaps it is some additional functionality for | |||
| a task that hasn't been thought of yet, or maybe a completely new | |||
| task. For these situations, you will | |||
| want to raise an <i>enhancement request</i>. Enhancement requests | |||
| are managed using the same Apache Bug Database described above. | |||
| These are just a different type of bug report. If you look in the | |||
| bug database, you will see that one of the severity settings for | |||
| a bug is "Enhancement". Just fill the bug report in, | |||
| set the severity of the bug to "Enhancement", and | |||
| state in the description how you would like to have Ant enhanced. | |||
| Again, you should first check whether there are any existing | |||
| enhancment requests that cover your needs. If so, just add your | |||
| vote to these. | |||
| </p> | |||
| </subsection> | |||
| <subsection name="Fixing the Bug"> | |||
| <p> | |||
| If you aren't satisfied with just filing a bug report, you can | |||
| try to find the cause of the problem and provide a fix yourself. | |||
| The best way to do that is by working with the latest code from CVS. | |||
| Alternatively, you can work with the source code available from the | |||
| <a href="http://ant.apache.org/srcdownload.cgi"> | |||
| source distributions</a>. If you | |||
| are going to tackle the problem at this level, you may want to | |||
| discuss some details first on the <code>dev</code> | |||
| mailing list. Once you have a fix for the problem, you may submit | |||
| the fix as a <i>patch</i> to either the | |||
| <code>dev</code> mailing | |||
| list, or enter the bug database as described above and attach the | |||
| patch to the bug report. Using the bug database has the advantage | |||
| of being able to track the progress of your patch. | |||
| </p> | |||
| <p> | |||
| If you have a patch to submit and are sending it to the | |||
| <code>dev</code> mailing list, | |||
| prefix "[PATCH]" | |||
| to your message subject. Please include any relevant bug numbers. | |||
| Patch files should be created with the <code>-u</code> | |||
| option of the | |||
| <code>diff</code> or <code>cvs diff</code> command. For | |||
| example:<br></br><br></br> | |||
| <font face="verdana" size="-1"> | |||
| diff -u Javac.java.orig Javac.java > javac.diffs<br></br><br></br> | |||
| </font> | |||
| or, if you have source from CVS:<br></br><br></br> | |||
| <font face="verdana" size="-1"> | |||
| cvs diff -u Javac.java > javac.diffs<br></br><br></br> | |||
| </font> | |||
| Note: You should give your patch files meaningful names. | |||
| This makes it easier for developers who need to apply a number | |||
| of different patch files. | |||
| <p> | |||
| <a href="http://vmgump.apache.org/gump/public/index.html">Gump</a> | |||
| is building ant every night and using the ant built from the | |||
| latest source to build a long list of open source projects. However, | |||
| the version of ant built by gump is not available for download. Even | |||
| if it were, it would not include most of the optional tasks. | |||
| </p> | |||
| <p> | |||
| We currently do not have nightly builds including the optional tasks. | |||
| </p> | |||
| </subsection> | |||
| </section> | |||
| <section name="bugs"> | |||
| <p>If you ar convinced that you have identified an unfixed bug, please turn to | |||
| our document concerning the <a href="bugs.html">bug database</a>.</p> | |||
| </section> | |||
| </body> | |||
| </document> | |||
| @@ -52,8 +52,7 @@ | |||
| <menu name="Contributing"> | |||
| <item name="Mailing Lists" href="/mail.html"/> | |||
| <item name="Subversion Repositories" href="/svn.html"/> | |||
| <item name="Bug Database" href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant"/> | |||
| <item name="Enhancement Requests" href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Ant&amp;bug_severity=enhancement"/> | |||
| <item name="Bug Database" href="/bugs.html"/> | |||
| <item name="Donations" href="http://www.apache.org/foundation/contributing.html"/> | |||
| </menu> | |||