QA/BugReport: Difference between revisions
m (New: Apache OOo Bugzilla) |
(Add reminders for actions to complement what's not implemented yet in the Bug Submission Assistant) |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 5: | Line 5: | ||
= Introduction = | = Introduction = | ||
This document provides information for reporting bugs on the '''''{{Fdosubmit|Bugzilla for LibreOffice}}'''''. If you are going to file your first report, please read carefully at least information from ''LibreOffice Bug Reports'' and ''What to include in bug reports''! | This document provides information for reporting bugs on the '''''{{Fdosubmit|Bugzilla for LibreOffice}}'''''. If you are going to file your first report, please use the [http://libreoffice.org/get-help/bug/ Bug Submission Assistant] and read carefully at least information from ''LibreOffice Bug Reports'' and ''What to include in bug reports''! | ||
: | : | ||
= Process= | = Process= | ||
== LibreOffice Bug Reports == | == LibreOffice Bug Reports == | ||
Bugs in LibreOffice packages should be '''{{Fdosubmit|reported}}''' into the ''[https://bugs.freedesktop.org/ Freedesktop Bugzilla]''. You can file a bug directly at [https://bugs.freedesktop.org/enter_bug.cgi?product=LibreOffice "LibreOffice" product], but beginners should follow instructions from [[#Reporting a bug in 4 Steps]]. | Bugs in LibreOffice packages should be '''{{Fdosubmit|reported}}''' into the ''[https://bugs.freedesktop.org/ Freedesktop Bugzilla]''. You can file a bug directly at [https://bugs.freedesktop.org/enter_bug.cgi?product=LibreOffice "LibreOffice" product], but beginners should use the [http://libreoffice.org/get-help/bug/ Bug Submission Assistant] and follow instructions from [[#Reporting a bug in 4 Steps]]. | ||
<br> | <br> | ||
=== Reporting a bug in | === Reporting a bug in 5 Steps === | ||
# Is the problem really a bug? If you require help using LibreOffice, consider posting your question at [http://nabble.documentfoundation.org/Users-f1639498.html LibreOffice Users Mailing List]. | # Is the problem really a bug? If you require help using LibreOffice, consider posting your question at [http://nabble.documentfoundation.org/Users-f1639498.html LibreOffice Users Mailing List]. | ||
# '''Before''' you | # '''Before''' you submit a new bug report, please check for existing, similar bug reports. After selecting a subcomponent in the [http://libreoffice.org/get-help/bug/ Bug Submission Assistant] a list with Bugs already reported for the same component will be shown. If the short description of the bug matches your problem, click on the link to see more. With ''Edit Search'' at the bottom of the corresponding Bugzilla page you can modify the search according to your needs. | ||
# | # When describing your bug report description read the [[#What to include in bug reports | following hints]] and from [[BugReport_Details]]. | ||
# After you submitted a new report with the [http://libreoffice.org/get-help/bug/ Bug Submission Assistant], click on the link that confirms the creation of the report and: | |||
## Select your Operating System from Picker | ## Select your Operating System from Picker | ||
## Decide what ''[https://bugs.freedesktop.org/page.cgi?id=fields.html#bug_severity Severity]'' might be appropriate for your report. Leave it where it is if you do not have much experience, the bug will not become fixed more quick if you select blocker. | ## Decide what ''[https://bugs.freedesktop.org/page.cgi?id=fields.html#bug_severity Severity]'' might be appropriate for your report. Leave it where it is if you do not have much experience, the bug will not become fixed more quick if you select blocker. | ||
# Click ''Submit'', and your report will be | # Click ''Submit'', and your report will be updated in the Bugzilla database | ||
<br> | <br> | ||
Revision as of 16:07, 23 September 2011
TDF LibreOffice Document Liberation Project Community Blogs Weblate Nextcloud Redmine Ask LibreOffice Donate
Introduction
This document provides information for reporting bugs on the Bugzilla for LibreOffice. If you are going to file your first report, please use the Bug Submission Assistant and read carefully at least information from LibreOffice Bug Reports and What to include in bug reports!
Process
LibreOffice Bug Reports
Bugs in LibreOffice packages should be reported into the Freedesktop Bugzilla. You can file a bug directly at "LibreOffice" product, but beginners should use the Bug Submission Assistant and follow instructions from #Reporting a bug in 4 Steps.
Reporting a bug in 5 Steps
- Is the problem really a bug? If you require help using LibreOffice, consider posting your question at LibreOffice Users Mailing List.
- Before you submit a new bug report, please check for existing, similar bug reports. After selecting a subcomponent in the Bug Submission Assistant a list with Bugs already reported for the same component will be shown. If the short description of the bug matches your problem, click on the link to see more. With Edit Search at the bottom of the corresponding Bugzilla page you can modify the search according to your needs.
- When describing your bug report description read the following hints and from BugReport_Details.
- After you submitted a new report with the Bug Submission Assistant, click on the link that confirms the creation of the report and:
- Select your Operating System from Picker
- Decide what Severity might be appropriate for your report. Leave it where it is if you do not have much experience, the bug will not become fixed more quick if you select blocker.
- Click Submit, and your report will be updated in the Bugzilla database
Additional Hints
- If you are not sure what component your problem is about, choose the Libreoffice component. A bug triager will assign the proper component. For more information about that have a look at "BugTriage". If it is a higher priority issue (broken parts, regression, etc), experienced users can assign it to one of the developers listed on the FindTheExpert page.
- If nobody reviewed your report within appropriate time (24 h for a critical bug 14 days for an enhancement request) consider asking someone else to reproduce your bug report on the users@global.libreoffice.org mailing list, or on the #libreoffice IRC channel.
- Please file a separate bug report for every issue!
- If that bug tracking system seems daunting to you with all its selections and rules, you should post your problem in an users@global.libreoffice.org mailing list or libreofficeforum.org; you will get help there.
Reporting Ubuntu bugs
The current list of Ubuntu-specific issues is available here:
You should only file an Ubuntu-specific bug if you installed LibreOffice from the corresponding PPA.
To file an Ubuntu-specific bug, first check the current list of issues, then:
- If you're using Ubuntu 10.04 LTS or Ubuntu 10.10, use this form and specify libreoffice under In what package did you find this bug?.
- If you're using Ubuntu 11.04, open a terminal window (under Applications > Accessories > Terminal) and type ubuntu-bug libreoffice[Enter], then follow the prompts to complete the report
Remember to tag the report with lo33 and include details such as how you installed LibreOffice, what platform you use (32-bit or 64-bit) and steps to reproduce the problem.
Filing a bug report at FreeDesktop.org as described above is also useful as such "upstream reports" can then be checked (and possibly tested and fixed) for other LibreOffice versions.
What to include in bug reports
The following information help us to reproduce or locate the problem and thus the fix might be available earlier for you:
- If you do not have much experience in bug reporting, please read the bug writing guidelines, you will find a link at the top of the Enter Bug page!
- Use Correct selection for Component, Version, Initial Status and Severity, please mind hints on BugReport Details.
- Additionally to pulldown selections details concerning system version and architecture, e.g. openSUSE 11.2 on x86_64, 32-bit Windows 7
- for Linux, what desktop, e.g. KDE or GNOME
- LibreOffice version, e.g. 3.2.0. Get it from the the dialog "Help/About LibreOffice". If using a pre-built LibreOffice, on Linux tell the exact versions of LibreOffice packages in your package management system. For Windows, the exact file name of the installer, and from where downloaded.
- Additionally information concerning installed and used localization (UI language, document language) might be useful
- whether a 32-bit LibreOffice is used on a 64 bit (Linux) system
- the package source if it's not the official LibreOffice build
- Please contribute a meaningful Summary for the problem you want to report:
- Not: "UI broken"
- But: Menu 'File -> Save as' not available (greyed out)
- Avoid short forms like "doesn't" or "isn't" to ease queries for strings in the Summary.
- Steps to reproduce the problem, please mention that every little detail might be important. Describe 1 simple way how to reproduce your problem in a step by step instruction; numbered items will ease to reference to your observations for other users. Be very exact,
- do not write: "Open document"
- but: "In new empty LibO Spreadsheet document, use menu 'File -> Open (LibO dialog) - file type "Text documents" -> select attached sample document -> double click'
- Provide an exact description of your problem
- Not: "Formatting not correct"
- But like: "I expect xxx because of yyy, but I see zzz
- Other useful details (e.g. screenshots, sample documents, backtrace, strace). Please mention that your sample document might not show your problem if some other user opens it because he uses a different operating system, has other settings for LibO or something else. So a screenshot can help. Often a screenshot is more useful if you edit it (with DRAW) adding comments and marking relevant areas.
- Reference to an existing Openoffice.org bug might be useful. Please mention: Active OOo Bugzilla has moved to Apache OOo Bugzilla
- Attachments (sample documents, ...)
- If you want to attach more than one screenshot you should collect them all in 1 document (copy / paste to a DRAW document) and attach as a PDF. Please add a short comment to each screenshot to tell what you want to demonstrate with it.
- If you want to attach more than 1 document (a complete test kit, for example) you should create a .zip file containing all documents and attach that .zip.
- If your attachment is too big to be attached in Bugzilla (bigger than 1 MB) you can use the experimental upload page.
Note: if you create screenshots, it helps the developers if you switch the user interface to English first. You can do so in Tools -> Options -> Language Settings -> Languages.
How to get strace log (on Linux)
In most cases, it is enough to start the application the following way:
strace -o /tmp/strace.log -f -tt -s 512 libreoffice
Then please do the steps to reproduce the problem and quit the application. The command libreoffice might be replaced with /opt/libreoffice/program/soffice specifically when you don't have the desktop integration installed.
Please, compress the log before it is attached to the bug report:
bzip2 /tmp/strace.log
If the 32-bit LibreOffice is running on 64-bit system, you need to install the package strace-32bit and start the 32-bit binary directly:
cd /opt/libreoffice/program # (on Ubuntu/Debian: cd /usr/lib/libreoffice/program) strace32 -o /tmp/strace.log -f -tt -s 512 ./soffice.bin
How to get backtrace (on Linux)
The backtrace is useful when the application crashes or freezes. You might use the following steps:
- Install the libreoffice*-debuginfo packages, if available. If you do not have them, the backtrace is less useful, but still could potentially provide at least some information.
- Start the debugger with the real binary and log the output:
cd /opt/libreoffice/program
gdb ./soffice.bin 2>&1 | tee /tmp/gdb.log
- Inside the debugger, start the application:
run
Should you need to specify options to the LibreOffice command line, userun <options>, like eg.run -writer, orrun /path/to/document.odt - Do the steps to reproduce the application crash or freeze. If the freeze is the case, you need to press CTRL-C in gdb to get the gdb commandline back.
- Produce the backtrace:
backtrace
- Produce backtrace of all threads:
thread apply all bt
- Quit the debugger
quit
- Attach the whole gdb.log to the bug report.
How to get valgrind log (on Linux)
The valgrind log is useful when the application crashes or freezes and the backtrace is not enough. You might use the following steps:
- Install the libreoffice*-debuginfo packages. (if available, and/or from your linux distribution)
- Start the debugger with the real binary and log the output:
cd /opt/libreoffice/program
valgrind --tool=memcheck --num-callers=50 --trace-children=yes ./soffice.bin 2>&1 | tee /tmp/valgrind.log
- Do the steps to reproduce the application crash or freeze. Note that it usually works fine with valgrind because it helps to keep the memory clean. Anyway, it should detect the danger and put some useful information to the log. Note that valgrind prints many warnings all the time. You really need to do the problematic steps to put the important data into the log.
- Quit LibreOffice
- Please, compress the valgring.log if it is bigger that 10kB
bzip2 /tmp/valgrind.log
- Attach the log into to the bug report.