diff --git a/docs/problems.html b/docs/problems.html index 873e08632..28d6d36df 100644 --- a/docs/problems.html +++ b/docs/problems.html @@ -172,7 +172,7 @@ check_for_optional_packages: flag rather than -verbose. This will generally produce so much output that you may want to save the output and analyze it in an editor.

-

So, once you have all this debug information, how can you use it to solve your problem. +

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 <javac> task logs the reasons why it chooses to compile particular @@ -263,8 +263,12 @@ check_for_optional_packages:

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 Apache Bug Database. - 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 + + currently open + . + 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:

+ + + +
+ + Asking for an enhancement + +
+
+

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. +

+
+
diff --git a/xdocs/problems.xml b/xdocs/problems.xml index 34a4897dd..45e12ae76 100644 --- a/xdocs/problems.xml +++ b/xdocs/problems.xml @@ -57,7 +57,7 @@ check_for_optional_packages: you may want to save the output and analyze it in an editor.

-

So, once you have all this debug information, how can you use it to solve your problem. +

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 <javac> task logs the reasons why it chooses to compile particular @@ -115,8 +115,12 @@ check_for_optional_packages:

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 Apache Bug Database. - 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 + + currently open + . + 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.

+ + +

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. +

+

If you aren't satisfied just filing a bug report, you can try to find and fix the problem yourself. The