You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ant.apache.org by an...@apache.org on 2005/11/21 08:55:49 UTC
svn commit: r345865 - in /ant/core/trunk: docs/ xdocs/ xdocs/stylesheets/
Author: antoine
Date: Sun Nov 20 23:55:27 2005
New Revision: 345865
URL: http://svn.apache.org/viewcvs?rev=345865&view=rev
Log:
creation of a new document called bugs containing a part
of what was in "problems".
updating some info.
Added:
ant/core/trunk/docs/bugs.html
ant/core/trunk/xdocs/bugs.xml
Modified:
ant/core/trunk/docs/antnews.html
ant/core/trunk/docs/bindownload.html
ant/core/trunk/docs/bylaws.html
ant/core/trunk/docs/contributors.html
ant/core/trunk/docs/external.html
ant/core/trunk/docs/faq.html
ant/core/trunk/docs/index.html
ant/core/trunk/docs/legal.html
ant/core/trunk/docs/license.html
ant/core/trunk/docs/mail.html
ant/core/trunk/docs/mission.html
ant/core/trunk/docs/problems.html
ant/core/trunk/docs/projects.html
ant/core/trunk/docs/resources.html
ant/core/trunk/docs/srcdownload.html
ant/core/trunk/docs/svn.html
ant/core/trunk/xdocs/problems.xml
ant/core/trunk/xdocs/stylesheets/project.xml
Modified: ant/core/trunk/docs/antnews.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/antnews.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/antnews.html (original)
+++ ant/core/trunk/docs/antnews.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/bindownload.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/bindownload.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/bindownload.html (original)
+++ ant/core/trunk/docs/bindownload.html Sun Nov 20 23:55:27 2005
@@ -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>
Added: ant/core/trunk/docs/bugs.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/bugs.html?rev=345865&view=auto
==============================================================================
--- ant/core/trunk/docs/bugs.html (added)
+++ ant/core/trunk/docs/bugs.html Sun Nov 20 23:55:27 2005
@@ -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>
+
+
+
+
+
+
+
+
+
+
+
Modified: ant/core/trunk/docs/bylaws.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/bylaws.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/bylaws.html (original)
+++ ant/core/trunk/docs/bylaws.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/contributors.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/contributors.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/contributors.html (original)
+++ ant/core/trunk/docs/contributors.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/external.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/external.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/external.html (original)
+++ ant/core/trunk/docs/external.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/faq.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/faq.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/faq.html (original)
+++ ant/core/trunk/docs/faq.html Sun Nov 20 23:55:27 2005
@@ -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 @@
<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
Modified: ant/core/trunk/docs/index.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/index.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/index.html (original)
+++ ant/core/trunk/docs/index.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/legal.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/legal.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/legal.html (original)
+++ ant/core/trunk/docs/legal.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/license.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/license.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/license.html (original)
+++ ant/core/trunk/docs/license.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/mail.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/mail.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/mail.html (original)
+++ ant/core/trunk/docs/mail.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/mission.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/mission.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/mission.html (original)
+++ ant/core/trunk/docs/mission.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/problems.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/problems.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/problems.html (original)
+++ ant/core/trunk/docs/problems.html Sun Nov 20 23:55:27 2005
@@ -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 @@
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 @@
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>
Modified: ant/core/trunk/docs/projects.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/projects.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/projects.html (original)
+++ ant/core/trunk/docs/projects.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/resources.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/resources.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/resources.html (original)
+++ ant/core/trunk/docs/resources.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/srcdownload.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/srcdownload.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/srcdownload.html (original)
+++ ant/core/trunk/docs/srcdownload.html Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/docs/svn.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/svn.html?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/docs/svn.html (original)
+++ ant/core/trunk/docs/svn.html Sun Nov 20 23:55:27 2005
@@ -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>
Added: ant/core/trunk/xdocs/bugs.xml
URL: http://svn.apache.org/viewcvs/ant/core/trunk/xdocs/bugs.xml?rev=345865&view=auto
==============================================================================
--- ant/core/trunk/xdocs/bugs.xml (added)
+++ ant/core/trunk/xdocs/bugs.xml Sun Nov 20 23:55:27 2005
@@ -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>
Modified: ant/core/trunk/xdocs/problems.xml
URL: http://svn.apache.org/viewcvs/ant/core/trunk/xdocs/problems.xml?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/xdocs/problems.xml (original)
+++ ant/core/trunk/xdocs/problems.xml Sun Nov 20 23:55:27 2005
@@ -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 @@
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,141 +168,27 @@
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>
Modified: ant/core/trunk/xdocs/stylesheets/project.xml
URL: http://svn.apache.org/viewcvs/ant/core/trunk/xdocs/stylesheets/project.xml?rev=345865&r1=345864&r2=345865&view=diff
==============================================================================
--- ant/core/trunk/xdocs/stylesheets/project.xml (original)
+++ ant/core/trunk/xdocs/stylesheets/project.xml Sun Nov 20 23:55:27 2005
@@ -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>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org