The Document Foundation Wiki
 

How to Report Bugs in LibreOffice

From The Document Foundation Wiki

Jump to: navigation, search


Contents

Great step !

You are about to make an important contribution to LibreOffice: a clear bug report is an important help for our developers. So thanks for doing this!
In order to make the life of the people that handle the bug reports a bit easier, we have some tips to help you. Important is to submit bugs that are not already known. Maybe there already is a report for your issue, in which case you may be able add a useful comment.

Both the

will help you fast with your bug report.

(If you want to read more details, you can read some of the sections below here.)

General information

  1. Is the problem really a bug? If you require help using LibreOffice, consider posting your question at LibreOffice Users Mailing List.
  2. 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.
  3. 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.
  4. Please file a separate bug report for each issue!
  5. Bugs in LibreOffice can be reported directly in Bugzilla.


How to use the Bug Submission Assistant

  1. Click here and follow instructions in the Assistant
  2. 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. If you find an existing report concerning your problem, no additional report is required, but may be you can contribute additional information.
    1. When describing your bug report description hints on What to include in bug reports and BugReport_Details might be useful.


Reporting a bug in few Steps

  1. Check for duplicates as described under Common
  2. Before you submit a new bug report, please check for existing, similar bug reports. On BugReport_Details a simple click on the Sub component name under a Component heading opens a list with Bugs already reported. A click on ⓘ leads you to help concerning the Subcomponents. With Edit Search at the bottom of the Bugzilla page you can modify the search according to your needs.
  3. Start a new report. On BugReport_Details a simple click on the ► behind the Subcomponent you used for your query opens a Bugzilla bug report page prepared for your needs. (If you did not find an appropriate Sub component, click the "for all other ..." link! Then please
    1. Select your LibreOffice version from Picker
    2. Select your Operating System from Picker
    3. Write your bug report mentioning the Bug Report and also BugReport_Details.
    4. 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.
  4. Click Submit, and your report will be added to the Bugzilla database


Additional Hints


Reporting Ubuntu bugs

To file an Ubuntu-specific bug, first check the current list of issues, then:

Remember to 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. Please file bugs at freedesktop.org, if it is not a Ubuntu-specific bug.

Detailed explanation of bug reports content

The following information help us to reproduce or locate the problem and thus the fix might be available earlier for you:

Avoid short forms like "doesn't" or "isn't" to ease queries for strings in the Summary.

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.

Providing extra information for the developers

How to get backtrace (on WINDOWS)

Here you find a screencast vido explaining how to get crash information for developers. That needs a lot of preparation, but for crashes what can't be reproduced easily that's the only chance to get required information for developers. Please do NOT copy the text you get to the comment, but attach a text document. That keeps the Bug readable and prevents from getting unusable results in Bugzilla queries.

How to get backtrace (on Linux)

The backtrace is useful when the application crashes or freezes. You might use the following steps:

  1. 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.
  2. Start the debugger with the real binary and log the output:
    cd /opt/libreoffice/program
    gdb ./soffice.bin 2>&1 | tee /tmp/gdb.log
  3. Inside the debugger, start the application:
    run
    Should you need to specify options to the LibreOffice command line, use run <options>, like eg. run -writer, or run /path/to/document.odt
  4. 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.
  5. Produce the backtrace:
    backtrace full
  6. Produce backtrace of all threads:
    thread apply all bt
  7. Quit the debugger
    quit
  8. Attach the whole gdb.log to the bug report.


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 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:

  1. Install the libreoffice*-debuginfo packages. (if available, and/or from your linux distribution)
  2. 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
  3. 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.
  4. Quit LibreOffice
  5. Please, compress the valgring.log if it is bigger that 10kB
    bzip2 /tmp/valgrind.log
  6. Attach the log into to the bug report.

Personal tools
Namespaces
Variants
Actions
Wiki
Navigation
Toolbox
donate