Difference between revisions of "Bugzilla"

From GnuCash
Jump to: navigation, search
(Gnucash and Gnome Bugzilla minor editorial changes)
(Bugzilla - clear up information on Watch lists)
Line 7: Line 7:
 
== Bug Tracker Overview ==
 
== Bug Tracker Overview ==
 
===Third Party Components===
 
===Third Party Components===
GnuCash is using several tools and sometimes also confused with similar sounding programs, which are maintained by other teams. They have their own bug trackers:
+
GnuCash uses several tools and is sometimes also confused with similar sounding programs, which are maintained by other teams. They have their own bug trackers:
 
;[https://github.com/codinguser/gnucash-android GnuCash for Android]: Beneath [https://github.com/codinguser/gnucash-android/issues?q=is%3Aopen GitHub issues] see also [https://plus.google.com/communities/104728406764752407046 support group] and [https://gnucash.uservoice.com/forums/320493-gnucash-android feature requests].
 
;[https://github.com/codinguser/gnucash-android GnuCash for Android]: Beneath [https://github.com/codinguser/gnucash-android/issues?q=is%3Aopen GitHub issues] see also [https://plus.google.com/communities/104728406764752407046 support group] and [https://gnucash.uservoice.com/forums/320493-gnucash-android feature requests].
 
;AqBanking: has its own [https://git.aquamaniac.de/trac/aqbanking/report bugtracker].
 
;AqBanking: has its own [https://git.aquamaniac.de/trac/aqbanking/report bugtracker].
Line 15: Line 15:
  
 
===Gnucash and Gnome Bugzilla===
 
===Gnucash and Gnome Bugzilla===
Until 2018, GnuCash used [https://bugzilla.gnome.org/ Gnome Bugzilla] to track bugs. When Gnome Bugzilla was set to ''read only'' mode, GnuCash implemented its own [{{BugURL}} Bugzilla copy]. All existing GnuCash bugs on Gnome were migrated to GnuCash's copy, and all bugs on Gnome's Bugzilla refer visitors to GnuCash's Bugzilla. New bugs must be reported at GnuCash's Bugzilla.  
+
Until 2018 we used the [https://bugzilla.gnome.org/ Gnome Bugzilla]. When it was set in ''read only'' mode, GnuCash implemented its own [{{BugURL}} Bugzilla instance]. All existing GnuCash bugs were migrated and new should now be reported there. All bugs on Gnome's Bugzilla refer visitors to GnuCash's Bugzilla.
  
For all existing '''user accounts''' that touched any GnuCash bug, ''email address'' and ''full name'' were migrated. Passwords and email watch lists were not.
+
For all existing '''user accounts''' that touched any GnuCash bug ''email address'' and ''full name'' were migrated, but passwords and email "watch" lists are not.
* Migrated users, on first access to GnuCash Bugzilla, must reset their passwords by using the "Forgot Password" link at the top of the page.
+
* Existing users will have to reset their passwords ''on their first use'' by using the "Forgot Password" link at the top of the page.
* ''Watch lists'' must be re-created on the Email Preferences tab in Preferences. See [[#Configure Notifications | Notifications]] for more information.
+
* ''Watch lists'' (to get the same bug-mail as other users including the [[#Configure Notifications | "pseudo-users"]], will need to be recreated on the Email Preferences tab in Preferences reachable by selecting Preferences at the top of any page after login.
  
 
== Triage ==
 
== Triage ==
Line 56: Line 56:
 
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''.
 
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''.
  
== Configure Notifications ==
+
== Notifications ==
 +
''Notifications'' can be set to alert you about particular bugs, as well as entire categories of bug.
 +
 
 
If you want to receive email notifications about '''a particular bug''', you can add the email address that is ''your Bugzilla id'' to the '''CC''' list on the bug. Bugzilla will do this for you by default if you take any action on the bug page.
 
If you want to receive email notifications about '''a particular bug''', you can add the email address that is ''your Bugzilla id'' to the '''CC''' list on the bug. Bugzilla will do this for you by default if you take any action on the bug page.
  
If you want to be notified about '''all changes to particular categories''' of bugs, including new ones, add one or more of the ''following email addresses'' to your '''User Watch''' list in your Bugzilla Email Preferences: After login click the '''Preferences''' item in the Bugzilla menu bar and select the [{{BugURL}}/userprefs.cgi?tab=email Email Preferences tab]. The watch list is underneath the table with all of the check boxes. The email addresses and the groups they monitor are:
+
Notifications about entire categories of bugs are known as ''Watch lists''. If you want to add a watch list to your account, add one or more of the following email addresses to your '''User Watch''' list in your Bugzilla Email Preferences: After login click the '''Preferences''' item in the Bugzilla menu bar and select the [{{BugURL}}/userprefs.cgi?tab=email Email Preferences tab]. The watch list is below the table with all of the check boxes. The email addresses and the groups they monitor are:
 
{| Border="0"
 
{| Border="0"
 
! width="25%" | Group !! width="75%" | Elements  
 
! width="25%" | Group !! width="75%" | Elements  

Revision as of 15:17, 15 March 2019

This page describes the normal usage of Bugzilla. For Quality Assurance (QA) tasks see Bugzilla Administration.


Introduction

If you discover a problem with the program or its documentation (known as a bug), you should record the bug so that it can be fixed by the developers. The GnuCash project uses the Bugzilla repository, which includes bugs and enhancement requests for GnuCash. Tips for submitting enhancement requests can be found at Enhancement requests.

Bug Tracker Overview

Third Party Components

GnuCash uses several tools and is sometimes also confused with similar sounding programs, which are maintained by other teams. They have their own bug trackers:

GnuCash for Android
Beneath GitHub issues see also support group and feature requests.
AqBanking
has its own bugtracker.
Finance::Quote
can be tested by using the gnc-fq-* command line tools, see FAQ.
Use their Request Tracker at the Comprehensive Perl Archive Network (CPAN)
or GitHub issues. We do not know which is preferred.

Gnucash and Gnome Bugzilla

Until 2018 we used the Gnome Bugzilla. When it was set in read only mode, GnuCash implemented its own Bugzilla instance. All existing GnuCash bugs were migrated and new should now be reported there. All bugs on Gnome's Bugzilla refer visitors to GnuCash's Bugzilla.

For all existing user accounts that touched any GnuCash bug email address and full name were migrated, but passwords and email "watch" lists are not.

  • Existing users will have to reset their passwords on their first use by using the "Forgot Password" link at the top of the page.
  • Watch lists (to get the same bug-mail as other users including the "pseudo-users", will need to be recreated on the Email Preferences tab in Preferences reachable by selecting Preferences at the top of any page after login.

Triage

Before filing a new bug, you should check to see whether the problem or suggestion has already been made. It may be still open or already closed after the date of your release.

Here are several links to different Bugzilla sections:

Commenting on existing bugs or entering new ones

If a bug has already been entered for the problem or enhancement you have identified, you can add comments to that bug.

If there is no bug, then you can Open a new GnuCash bug.

Users new to the bug process would benefit by reading: How to Report Bugs Effectively.

If you are unsure how to use Bugzilla, read [https://bugzilla.readthedocs.io/en/5.0/using/index.html or use the "Help" or "?" links in Bugzilla.

Note: GnuCash has different versions that run under different operating systems. When you report a bug, you should include both the GnuCash version and the operating system you use in the bug report. You should also include any other information about your configuration that might be pertinent in your request. Examples of this include: your problem might depend on your Locale Settings (like currency, number and date format), which means you would add your language and region.

In many cases of errors it is helpful to provide the developers with the always generated Tracefile. See logging to learn about capturing and providing error messages and filtering detail.

When reporting an actual crash of GnuCash see whether you can generate a stack trace. See Stack Trace for information on how to produce a stack trace for your bug report.

Tips
* 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 or other longer output in your comments. Instead append them as attachments.

Attachments

If a program crash or freeze only happens on a specific file (for example, a data file, an import file, or a (modified) report), it can be useful to attach a copy of that file to your bug report.

If the crash is caused by a data file, you should attach the XML file in uncompressed format (see Edit->Preferences->General->Files->Compress Files). Bear in mind that this data is available on the internet, and take steps to protect your financial data, e.g., by using 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.

Notifications

Notifications can be set to alert you about particular bugs, as well as entire categories of bug.

If you want to receive email notifications about a particular bug, you can add the email address that is your Bugzilla id to the CC list on the bug. Bugzilla will do this for you by default if you take any action on the bug page.

Notifications about entire categories of bugs are known as Watch lists. If you want to add a watch list to your account, add one or more of the following email addresses to your User Watch list in your Bugzilla Email Preferences: After login click the Preferences item in the Bugzilla menu bar and select the Email Preferences tab. The watch list is below the table with all of the check boxes. The email addresses and the groups they monitor are:

Group Elements
core@gnucash.bugs Backend-SQL, Backend-XML, Budgets, Build System, Business, Currency and Commodity, Engine, Python Bindings, Scheduled Transactions
documentation@gnucash.bugs Documentation, Translations, Website
general@gnucash.bugs General
import@gnome.bugs Import-AqBanking, Import-CSV, Import-OFX, Import-Other, Import-QIF, Import-QSF, TXF Export
macos@gnucash.bugs MacOS
reports@gnucash.bugs Check Printing, Reports
ui@gnucash.bugs Register, Regist-2, User Interface General
windows@gnucash.bugs Windows
all-bugs@gnucash.bugs Everything

Help Wanted

For those people who might like to help manage bugs on Bugzilla, there is additional information in Bugzilla Administration.