QA/Bugzilla/FAQ

From The Document Foundation Wiki
< QA‎ | Bugzilla
Jump to: navigation, search


Here you can find answers to Frequently Asked Questions about Bugzilla.

For answers to more general questions about QA, see QA/FAQ.

How to submit Enhancement Requests about Bugzilla itself

Submit Enhancement Requests for Bugzilla and other related infrastructure as Redmine ticket for category Bugzilla.

How to cite other comments

Please avoid any superfluous and lengthy citing! It's tedious to have to read endless repetitions. If you do not reply to the comment before it is useful to use the Bugzilla [reply] function. If you think it's necessary to put your comment in context, you can cite 1 or 2 relevant lines of the discussion to that point, but not a multi-line quotation.

Also: NEVER use your email interface for your comments. Add comments to the bug using the Bugzilla web page, where you have a lot of information that is not visible in the last comment you see in an email message

How to cite other LibreOffice Bugs in Bugzilla

To get a link to another bug into your comment, simply write something like Bug 12345, with "12345" replaced by the Bug Number. No "#", no other frills in the bug number. Generally it is useful to copy and paste the complete Summary line of the bug you are citing.

How to interpret Whiteboard Target information

target:3.7.0 in Whiteboard means that a fix has been "pushed" to the code for the master. The first public Version where it will be available will be 4.0.0.x. If you wonder why a fix has not been integrated into the code for particular version, be patient! Before a fix can be integrated into current code branches the fix has to be reviewed by other developers to avoid regression bugs. That takes some time. As long as the bug has not changed status to FIXED you can hope for fix integration into the current branches' code.


How to handle Bug Report Clones

Screenshot

Sometimes a reporter accidentally creates several clones of the intended bug report. Please do NOT mark those useless clones as DUPLICATES. Many Duplicates should be an indicator that a particular problem affects many users. Instead, close each unneeded report as as RESOLVED - INVALID with the comment "Clone of Bug xxxxx".


How to use attached sample documents for multiple bug reports

Screenshot, please delete "Details " after copy&paste "Attachment ..." from Window heading to comment.

It is neither necessary nor useful to attach the same document in multiple bug reports again and again. Instead, create a link with the text "attachment 12345 from Bug 6789" in the comment text or report text of the new bug report. This creates a link to download the attachment easily, and you contribute information about what other bug report may contain interesting information concerning the document. To find the attachment number, mouseover the link in the original report, as the screenshot shows. Or you can copy / paste that info from the Bugzilla Attachment Details Info page. It's important to know for what bug report the attachment has been submitted, since the Comments often contain important additional information.

This way everybody knows that the sample document in the new bug report is identical to the document in the earlier bug report, so it is much more easy to compare results.

How to add bug reports to MAB bug tracking

See the special page about Most Annoying Bugs.

How to Validate a Bug Fix

If you tried to reproduce a bug with a version which should have included the fix (see target information in Whiteboard) and you can confirm that the bug no longer exists, you can modify the bug report Status to VERIFIED. This indicates that the fix has been confirmed. If you still can reproduce the bug please keep in mind How to reopen a bug.

How to attach Backtraces

If you want to provide extra information for the developers like Backtraces and similar material, you will have to decide whether you will contribute information

  • As text in a Comment
    • Advantages:
      • queries can be done for Backtrace contents
    • Disadvantages:
      • strings in Backtrace might bring up unwanted hits in queries
      • bad readability of the Bugzilla bug report because of endless Backtrace comment texts
  • As an Attachment - text document
    • Advantages:
      • readability of the Bugzilla Bug is not reduced
      • If there are new findings you can mark an attachment as obsolete
    • Disadvantages:
      • No queries concerning Backtrace contents are possible
      • No unwanted hits in queries by strings in Backtrace matching with "normal" query strings

It's your decision what way you prefer.

How to mention Attachments or other LibO related bug reports

The most simple and reliable way is to write Bug 47712 (for example) instead of <https://bugs.documentfoundation.org/show_bug.cgi?id=47712>. Bugzilla will add a link to the text when it appears in a report or comment. For attachments, you should write attachment 61814 instead of <https://bugs.documentfoundation.org/attachment.cgi?id=61814>.

What's libreoffice.org/bugzilla?

No, not a new bugzilla of our own, but the Bugzilla environment for our Bugzilla. Mostly if you find such a link (in an URL field) concerning reported Bugs you should replace it by a bugs.documentfoundation.org/ URL to avoid login problems and similar (please compare Bug Links in #How to mention Attachments or other LibO related bug reports.

How do I find information I need?

Here you can find several useful queries:

For users of 64-bit operating systems

It is possible to run 32-bit applications on 64-bit operating systems. This might make the Platform chooser in Bugzilla a bit confusing. In general, please enter what your version of LibreOffice was built for. This information is sadly not visible in the application, however:

  • Windows users: there is currently no official 64-bit version. You are most probably using a 32-bit version, use "x86 (IA32)". Please mention your operating system under Description.
  • Linux users: in most cases you should be using a 64-bit version of LibreOffice, if your system is also 64-bit. Your package manager might give further hints. It's most probable that you can use "x86-64 (AMD64)".
  • MacOS users: MacOS does only support 64-bit.

How to reopen a bug report

See details here.

How to Mark a Bug Report as a Duplicate

MarkAsDuplicate.png

If you find out that a bug report (for example tdf#40691) is a DUPLICATE of an existing one (tdf#37195), decide which of the two to retain. Usually you retain the older report, but sometimes the newer report has additional valuable information, or has a more advanced status (Assigned).

When you have decided which report to retain, mark the other report as Duplicate, (tdf#40691) inserting the number of the report you are retaining (37195) into the pane that opens when you click Mark as Duplicate. It is not necessary to transfer reporter and CC list to the remaining report tdf#37195, because Bugzilla will send information on all changes in the remaining report to reporters and CC of reports closed as duplicates.

How to close a bug report if the bug can't be reproduced any longer

If a bug report has been confirmed, but the problem vanished with a later LibreOffice version, do not use Resolved Fixed to close the report. That is reserved for bugs with a real reviewed Fix. The appropriate Status for a Bug where the problem simply vanished is Resolved WORKSFORME.

A reviewed Fix is a much more reliable solution that an unknown reason for a vanished problem. This difference should be visible in the Status information. The Version where the bug can no longer be reproduced should be mentioned in the Whiteboard as Target. Especially if it's your first contact with the particular bug (so that you have never reproduced the problem), describe, step by step, how you did your test. That might provide important information:

  • Possible reasons why it "works" now
    • Step by step instructions to reproduce the bug are too unclear so that you did a test different from the reporter's test.
    • the problem is real, but is related to a particular, so far unknown, condition. Your test did not include that condition.

How to assign a bug report (QA Team only)

  • User Account of Friendly Expert (or known developer for the issue) will be inserted in CC by an experienced user. Status remains (or becomes) New
  • Developer accepts the bug report by
    • adding himself to Assigned to and
    • changing Status to ASSIGNED

or does not accept the bug assignment.

Bug still visible although bug status FIXED?

The fix may not have been integrated into the next release. Please see Target information in Whiteboard or GIT link.

RC Version vanished?

You filed a bug report, but now you can't find it with "Search by Version" (for example using a link you bookmarked)? The reason might be that you discovered the bug in the last Release Candidate before the release. If the LibreOffice Release version is bit by bit identical to the last RC, the RC version from Version Picker will be changed to Release Version (for Example: 3.4.2 RC to 3.4.2 release) by the administrator.

Bugzilla Voting?

Bugzilla has a feature that lets project members vote for bug reports that they think should get attention sooner. LibreOffice does not use this feature, as the Engineering Steering Committee does not believe that simply voting brings enough new information.

That does not mean that there is a fundamental resistance to any sort of "user poll", however. If someone has a well-founded, convincing concept to propose, we can discuss the question again; and if feedback is positive we will find an infrastructure for the process.

Bugzilla Statistics

See QA/Bugzilla/Statistics.