If you have problems with some tool, ensure that you have the newest version of the tool you are using. Check the documentation of the tool to see if the examples or other guidelines can help. If you are lucky, your problem is not a bug at all.
If you feel you found a bug, please make sure you are aware of the bug etiquette explained below. Then report your bugs at bugs.locamotion.org under the relevant “Translate Toolkit”, “Pootle”, etc. components.
In order to best solve the problem we need good bug reports. Reports that do not give a full picture or which coders are unable to reproduce, end up wasting a lot of time. If you, the expert in your bug, spend a bit of time you can make sure your bug gets fixed.
Remember to first see if the bug is not already reported. Perhaps someone already reported it and you can provide some extra information in that bug report. You can also add yourself in the CC field so that you get notified of any changes to the bug report.
If you could not find the bug, you should report it. Look through each of the following sections and make sure you have given the information required.
Tell us exactly how came to see this bug. Don't say:
The Mozilla DTD files have escaping errors
I'm working on Firefox 1.5 and in the files somefile.dtd entity XXXX the \n is not escaped correctly it should be \\n
OK so we need to know:
Use --version to get the version of the tool you are working with.
moz2po --version # for Translate Toolkit PootleServer --version # for Pootle versions
We might have fixed this problem already, your version will help us know if their are still problems or whether to ask you to upgrade.
If the correct version is not available to select in bugzilla, please mention the version number in your bug report.
If possible, create a snippet of a file to demonstrate the error. Sending one large file means that the coder has to search for the error. If you can narrow it down to one key section and only attach that, it will help.
Please attach all your source files. In other words, if the error is in somefile.dtd in Firefox 1.1 please attach that file. It will save the coder having to find the Firefox version, extract the file and check. If the file is included, everything is much quicker. If the file is very large, then please place it on a server somewhere for the coder to download.
For the programs in the translate toolkit, use the parameter --errorlevel=traceback and copy the traceback to the bug report
For Pootle version 2.0, you can get this information from the error log which will be displayed on console if running from standalone PootleServer or in the webservers main error log if running under apache (usually /var/log/httpd/error_log or /var/log/apache2/error.log).
You can display last 20 lines from the log using tail command
tail -n 20 /var/log/httpd/error_log
For Pootle version 1.2 you can get this information using the command line options --logerrors or --browsererrors
this displays the traceback on the console or the logfile of the Pootle server
this displays the traceback to the user in the web browser
A traceback will give a much better clue as to what the error might be and send the coder on the right path. It may be a very simple fix, may relate to your setup or might indicate a much more complex problem. Tracebacks help coders get you information quicker.
Tell us exactly how to reproduce the error. Mention the steps if needed, or give an example command line. Without being able to reproduce the error, it will not easily get fixed.
If you can be on IRC on #pootle or the relevant mailing list (see above) to answer questions and test possible fixes then this will help to get your problem fixed quickly.