Difference between revisions of "Bugzilla"

From GnuCash
Jump to: navigation, search
(Using Bugzilla: Insert section structure, explain how to save uncompressed)
(Using Bugzilla: more structure, link tip)
Line 7: Line 7:
  
 
== Using Bugzilla ==
 
== Using Bugzilla ==
There is a specific GnuCash "Product" subsection which allows you to specifically search for GnuCash bugs. You can use the following quick links to perform actions on the GnuCash Bugs Database:
+
There is a specific [https://bugzilla.gnome.org/browse.cgi?product=GnuCash GnuCash "Product" page] which inter alia allows you to specifically search for GnuCash bugs. E.g. can you there click number right of the interesting component and will get the list of the open bugs.
  
Strongly recommended:
+
=== Triage ===
 +
At first you should check for existing reports of the same problem or improvement suggestion.
  
* [https://bugzilla.gnome.org/browse.cgi?product=GnuCash GnuCash bug overview]
+
Example links into GnuCash's bugzilla section:
  
Other links into bugzilla:
+
* [http://bugzilla.gnome.org/query.cgi Search the entire GNOME bug database] (overwhelming)
 
 
* [http://bugzilla.gnome.org/query.cgi Search the entire GNOME bug database]
 
 
* [http://bugzilla.gnome.org/buglist.cgi?product=GnuCash&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=NEEDINFO&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&status_whiteboard=&status_whiteboard_type=substring&keywords=&keywords_type=anywords&op_sys_details=&op_sys_details_type=substring&version_details=&version_details_type=substring&namedcmd=Gnucash+Bugs&newqueryname=Gnucash+Bugs&order=Bug+Number&form_name=query  Search for open GnuCash bugs and enhancements]
 
* [http://bugzilla.gnome.org/buglist.cgi?product=GnuCash&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=NEEDINFO&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&status_whiteboard=&status_whiteboard_type=substring&keywords=&keywords_type=anywords&op_sys_details=&op_sys_details_type=substring&version_details=&version_details_type=substring&namedcmd=Gnucash+Bugs&newqueryname=Gnucash+Bugs&order=Bug+Number&form_name=query  Search for open GnuCash bugs and enhancements]
 
* [http://bugzilla.gnome.org/buglist.cgi?product=GnuCash&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=NEEDINFO&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&status_whiteboard=&status_whiteboard_type=substring&keywords=&keywords_type=anywords&op_sys_details=&op_sys_details_type=substring&version_details=&version_details_type=substring&namedcmd=Gnucash+Bugs&newqueryname=Gnucash+Bugs&order=Bug+Number&form_name=query&version=2.0.x&version=CVS&version=SVN&version=unspecified Search for open GnuCash bugs and enhancements, restricted to post-1.8 or unspecified versions]
 
* [http://bugzilla.gnome.org/buglist.cgi?product=GnuCash&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=NEEDINFO&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&status_whiteboard=&status_whiteboard_type=substring&keywords=&keywords_type=anywords&op_sys_details=&op_sys_details_type=substring&version_details=&version_details_type=substring&namedcmd=Gnucash+Bugs&newqueryname=Gnucash+Bugs&order=Bug+Number&form_name=query&version=2.0.x&version=CVS&version=SVN&version=unspecified Search for open GnuCash bugs and enhancements, restricted to post-1.8 or unspecified versions]
  
 
+
=== Entering of or commenting on bugs ===
 
: You might probably read the [[FAQ#Q:_What_should_I_obey_as_a_beginner_in_bug_reporting.2C_enhacement_requesting_....3F | FAQ section about bug reporting]] before you continue ...
 
: You might probably read the [[FAQ#Q:_What_should_I_obey_as_a_beginner_in_bug_reporting.2C_enhacement_requesting_....3F | FAQ section about bug reporting]] before you continue ...
 
: Also [http://www.bugzilla.org/docs/3.4/en/html/using.html bugzillas help] has useful parts.
 
: Also [http://www.bugzilla.org/docs/3.4/en/html/using.html bugzillas help] has useful parts.
  
 
* [http://bugzilla.gnome.org/enter_bug.cgi?product=GnuCash Open a new GnuCash bug or enhancement Request]; when reporting a crash, see [[Stack Trace]] and [[Tracefile]] for information on how to produce a stack trace for your bug report.
 
* [http://bugzilla.gnome.org/enter_bug.cgi?product=GnuCash Open a new GnuCash bug or enhancement Request]; when reporting a crash, see [[Stack Trace]] and [[Tracefile]] for information on how to produce a stack trace for your bug report.
 
+
;Tip: If you refer to other bugs in your text, we suggest to use the form ''bug nnnnnn - Title''. Bugzilla will then add a link and the reader saves time if the title can be read without following the link.
=== Attachments ===
+
Do not copy and paste log files. Instead append them as:
 +
==== Attachments ====
 
If a program crash or freeze only happens on a specific file like
 
If a program crash or freeze only happens on a specific file like
 
* data file
 
* data file
Line 36: Line 36:
 
When uploading adjust the mime type of your file:
 
When uploading adjust the mime type of your file:
 
* ''Uncompressed'' gnucash data files are of type ''text/xml'',
 
* ''Uncompressed'' gnucash data files are of type ''text/xml'',
* most import files are of type ''text/plain''.
+
* most import files and log files are of type ''text/plain''.
  
=== Answer ===
+
==== Answers ====
 
If a developer asked you for some information or one of the files above and you attached them, do not forget, to '''reset the bug status''' from ''needinfo'' to ''unconfirmed'' again.
 
If a developer asked you for some information or one of the files above and you attached them, do not forget, to '''reset the bug status''' from ''needinfo'' to ''unconfirmed'' again.
  
 
== Bug Triage ==
 
== Bug Triage ==
 
For people, which like to help us e.g. on bug triage, are some additional informations in [[QA/BugzillaAdministration]].
 
For people, which like to help us e.g. on bug triage, are some additional informations in [[QA/BugzillaAdministration]].

Revision as of 10:59, 15 August 2016

Bugzilla is a repository of bugs and enhancement requests maintained by the Gnome Project and used by the GnuCash project.

Other Resources

  • Also, uservoice.com is an interesting forum for discussion of new feature requests (but not bug reports).
  • If Finance::Quote is not working correctly - you can test it by using the gnc-fq-* command line tools - use their Request Tracker at the Comprehensive Perl Archive Network (CPAN).

Using Bugzilla

There is a specific GnuCash "Product" page which inter alia allows you to specifically search for GnuCash bugs. E.g. can you there click number right of the interesting component and will get the list of the open bugs.

Triage

At first you should check for existing reports of the same problem or improvement suggestion.

Example links into GnuCash's bugzilla section:

Entering of or commenting on bugs

You might probably read the FAQ section about bug reporting before you continue ...
Also bugzillas help has useful parts.
Tip
If you refer to other bugs in your text, we suggest to use the form bug nnnnnn - Title. Bugzilla will then add a link and the reader saves time if the title can be read without following the link.

Do not copy and paste log files. Instead append them as:

Attachments

If a program crash or freeze only happens on a specific file like

  • data file
  • import file
  • (modified) report

it can be useful to attach a copy of that file to your bug report, but:

  • It is easier, if you attach your XML data file uncompressed. Before you save your file, uncheck Edit->Preferences->General->Files->Compress Files. It can then already be seen in the web interface.
  • If the file contains confidential data do not forget to anonymize your data e.g. with the ObfuscateScript.
  • If the file is really big, try to create a minimal example.

When uploading adjust the mime type of your file:

  • Uncompressed gnucash data files are of type text/xml,
  • most import files and log files are of type text/plain.

Answers

If a developer asked you for some information or one of the files above and you attached them, do not forget, to reset the bug status from needinfo to unconfirmed again.

Bug Triage

For people, which like to help us e.g. on bug triage, are some additional informations in QA/BugzillaAdministration.