Browse Source

Updates to the problem procedure

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@269536 13f79535-47bb-0310-9956-ffa450edef68
master
Conor MacNeill 24 years ago
parent
commit
ae04df6475
2 changed files with 46 additions and 6 deletions
  1. +27
    -3
      docs/problems.html
  2. +19
    -3
      xdocs/problems.xml

+ 27
- 3
docs/problems.html View File

@@ -172,7 +172,7 @@ check_for_optional_packages:
flag rather than <code>-verbose</code>. This will generally produce so much output that
you may want to save the output and analyze it in an editor.
</p>
<p>So, once you have all this debug information, how can you use it to solve your problem.
<p>So, once you have all this debug information, how can you use it to solve your problem?
That will depend on the task in question and the nature of your problem. Each task logs
different aspects of its operation, but it will give you an idea of what is going on. For
example, the &lt;javac&gt; task logs the reasons why it chooses to compile particular
@@ -263,8 +263,12 @@ check_for_optional_packages:
<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://nagoya.apache.org/bugzilla/">Apache Bug Database</a>.
This system is easy to use and it will let you search the currently open and resolved bugs to see if your
problem has already been reported. If it has, you can see whether any of the developers have commented,
This system is easy to use and it will let you search the
<a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Ant&amp;short_desc=&amp;short_desc_type=substring&amp;long_desc=&amp;long_desc_type=substring&amp;bug_file_loc=&amp;bug_file_loc_type=substring&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;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. You may have more information to add (see about
creating bug reports below), in which case, go right ahead and add it. If you can't add more information
you may just want to vote for this bug, and perhaps add yourself to the CC list to follow the progress of
@@ -301,6 +305,26 @@ check_for_optional_packages:
</p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Asking for an enhancement"><strong>Asking for an enhancement</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>Sometimes, you may find that Ant just doesn't do what you want. It isn't a bug, as such, since Ant
is working the way it is supposed to. Perhaps it is something that hasn't been thought of yet, or
a completely new task. For these situations you will want to raise an enhancement request.
Enhancement requests are managed using the same Apache Bug Database described above.
These are just a different type of report. If you look in the database, you will see that one of
the severity settings for a bug is "Enhancement". So, just fill the bug report in, and
in the description, state how you would like to have Ant enhanced. Again you should check whether
there are any existing enhancment requests that cover your needs. If so, just add your vote to these.
</p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">


+ 19
- 3
xdocs/problems.xml View File

@@ -57,7 +57,7 @@ check_for_optional_packages:
you may want to save the output and analyze it in an editor.
</p>
<p>So, once you have all this debug information, how can you use it to solve your problem.
<p>So, once you have all this debug information, how can you use it to solve your problem?
That will depend on the task in question and the nature of your problem. Each task logs
different aspects of its operation, but it will give you an idea of what is going on. For
example, the &lt;javac&gt; task logs the reasons why it chooses to compile particular
@@ -115,8 +115,12 @@ check_for_optional_packages:
<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://nagoya.apache.org/bugzilla/">Apache Bug Database</a>.
This system is easy to use and it will let you search the currently open and resolved bugs to see if your
problem has already been reported. If it has, you can see whether any of the developers have commented,
This system is easy to use and it will let you search the
<a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Ant&amp;short_desc=&amp;short_desc_type=substring&amp;long_desc=&amp;long_desc_type=substring&amp;bug_file_loc=&amp;bug_file_loc_type=substring&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;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. You may have more information to add (see about
creating bug reports below), in which case, go right ahead and add it. If you can't add more information
you may just want to vote for this bug, and perhaps add yourself to the CC list to follow the progress of
@@ -145,6 +149,18 @@ check_for_optional_packages:
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 want. It isn't a bug, as such, since Ant
is working the way it is supposed to. Perhaps it is something that hasn't been thought of yet, or
a completely new task. For these situations you will want to raise an enhancement request.
Enhancement requests are managed using the same Apache Bug Database described above.
These are just a different type of report. If you look in the database, you will see that one of
the severity settings for a bug is &quot;Enhancement&quot;. So, just fill the bug report in, and
in the description, state how you would like to have Ant enhanced. Again you should 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 just filing a bug report, you can try to find and fix the problem yourself. The


Loading…
Cancel
Save