git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@269536 13f79535-47bb-0310-9956-ffa450edef68master
@@ -172,7 +172,7 @@ check_for_optional_packages: | |||||
flag rather than <code>-verbose</code>. This will generally produce so much output that | 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. | you may want to save the output and analyze it in an editor. | ||||
</p> | </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 | 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 | different aspects of its operation, but it will give you an idea of what is going on. For | ||||
example, the <javac> task logs the reasons why it chooses to compile particular | example, the <javac> task logs the reasons why it chooses to compile particular | ||||
@@ -263,8 +263,12 @@ check_for_optional_packages: | |||||
<p> | <p> | ||||
If the current nightly build doesn't resolve your problem, it is possible that someone else has reported | 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>. | 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&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. You may have more information to add (see about | 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 | 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 | 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> | </p> | ||||
</blockquote> | </blockquote> | ||||
</td></tr> | </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> | ||||
<table border="0" cellspacing="0" cellpadding="2" width="100%"> | <table border="0" cellspacing="0" cellpadding="2" width="100%"> | ||||
<tr><td bgcolor="#828DA6"> | <tr><td bgcolor="#828DA6"> | ||||
@@ -57,7 +57,7 @@ check_for_optional_packages: | |||||
you may want to save the output and analyze it in an editor. | you may want to save the output and analyze it in an editor. | ||||
</p> | </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 | 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 | different aspects of its operation, but it will give you an idea of what is going on. For | ||||
example, the <javac> task logs the reasons why it chooses to compile particular | example, the <javac> task logs the reasons why it chooses to compile particular | ||||
@@ -115,8 +115,12 @@ check_for_optional_packages: | |||||
<p> | <p> | ||||
If the current nightly build doesn't resolve your problem, it is possible that someone else has reported | 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>. | 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&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. You may have more information to add (see about | 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 | 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 | 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. | asking for further information, please try to respond as it will aid in the resolution of your bug. | ||||
</p> | </p> | ||||
</subsection> | </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 "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> | |||||
</subsection> | |||||
<subsection name="Fixing the Bug"> | <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 | <p>If you aren't satisfied just filing a bug report, you can try to find and fix the problem yourself. The | ||||