Difference between revisions of "Using the bug tracker"

From Gramps
Jump to: navigation, search
m
(11 intermediate revisions by 6 users not shown)
Line 1: Line 1:
It’s http://www.suprashop.net/Supra-Skytop II_18_1.htm cheap supra skytop particularly crucial in vogue ahead and know your finances when organising a wedding day. You don’t wish any setbacks to damper the big day http://www.suprashop.net/Supra-Skytop-I_17_1.htm Supra shoes sale sale ,like an outrageous creditcard bill with which to add unnecessary stress. Plan out your financial a lot more payable just for this gift-you’ll be happy gain knowledge of.By selecting jewelry that matches and enhances your man’s style, you can be getting a http://www.suprashop.net/ cheap supra skytop winning gift which could be enjoyed annually.Give all guy the know how he really should take http://www.suprashop.net/ Supra shoes sale his look from ordinary to extraordinary utilizing a sheet of fine jewelry. From exquisite and complicated pieces to strong and masculine styles Yves Saint Laurent Boots , you’ll encounter many various designs http://www.suprashop.net/ Supra shoes online that should revamp any appearance.
+
{{languages|How to report bugs}}
 +
The bug/issue tracker for GRAMPS is located at the following URL: http://bugs.gramps-project.org
 +
This bug/issue tracker allows users and developers to log new issues and track them as they progress. Please take some time to read the issue tracker instructions below and read '''[[How to create a good bug report|how to create a good bug report]]'''. Also, have a look at '''[[Known_issues|known issues]]''' and '''[[Common_problems|common problems]]'''.
 +
 
 +
==Report a bug==
 +
===1. Login===
 +
To report a bug, you must have a login account on http://bugs.gramps-project.org, which is the GRAMPS bug tracker. When you create a user account, remember that it can take up to 12 hours before a notification email is send to you. Only after clicking on the link in the email can you submit bugs. Your email address will be handled confidentially.
 +
 
 +
===2. Search existing bugs===
 +
Perhaps the bug you want to report has been submitted before. To check this, click on 'View Issues'. The top of the page is reserved for filters, which you set. Normally the default filters are just fine. Under these filters, there is a search box. Enter the terms best describing the bug, and click apply filter. If you have an error message, try pasting a part of the error, to see if it is has been reported already.
 +
 
 +
If the bug is already reported, read the bug report over, and see if you can add to the information. If so, you can leave a note with extra information to help the developers.
 +
 
 +
===3. Submit new bug===
 +
Click on Report Issue, and enter the required information, see below on how to select the project to which the bug belongs. Be verbose, the developers are bad at mind reading. Do not forget to list the GRAMPS version you are using. You can check this in GRAMPS by clicking in the GRAMPS program the Help menu, option About.
 +
 
 +
==== Projects ====
 +
In the upper right corner of the issue tracker, there is a place to select the "project" for the bugs. "Projects" are a way to categorize issues. There are three types of projects in the issue tracker:
 +
 
 +
#The '''Feature Requests''' project is a place for recording requests for new features.
 +
#The projects with names that look like '''Gramps x.x.X''' are where issues are reported that apply specifically to a maintenance branch (see [http://www.gramps-project.org/wiki/index.php?title=Brief_introduction_to_SVN#Types_of_branches Types of Branches]). A separate project exists for each maintenance branch.
 +
#The '''Gramps Trunk''' project should only be used by developers and testers of the latest code. It is a place for recording issues that only apply to the trunk in Subversion (see [http://www.gramps-project.org/wiki/index.php?title=Brief_introduction_to_SVN#Types_of_branches Types of Branches]). There is only one "Gramps Trunk" project because there is only one trunk in the Subversion repository
 +
 
 +
==== How to proceed ====
 +
The first step in submitting an issue on the tracker is to determine which project it belongs to.  
 +
 
 +
*If the issue represents functionality that does not currently exist in GRAMPS, then the issue should be filed under the '''Feature Requests''' project.
 +
 
 +
*If the issue represents a problem with functionality that has been released in a stable release of code, then the issue should be filed under the project that corresponds to the maintenance branch for that release. For example, a bug found in GRAMPS 3.2.6 should be filed under the '''Gramps 3.2.X''' project.
 +
 
 +
*If the issue represents a problem with functionality that only exists in trunk, or the problem exists in trunk, but not any stable releases, then the issue should be filed under the '''Gramps Trunk''' project.
 +
 
 +
== Resolving bugs ==
 +
This information is for the developers following up on the submitted issues.
 +
 
 +
In general, when resolving an issue, it is always a good idea to add a note with the SVN revision number of the commit that fixed the problem.
 +
 
 +
When resolving issues in a maintenance branch, one should always set the "Fixed in version" field to the version of the next release that will be made from that branch. This is done so that the issue properly appears in the ChangeLog page for that project (http://bugs.gramps-project.org/changelog_page.php).
 +
 
 +
Bugs in maintenance branch projects should not be marked as closed until the developer has committed the change into the corresponding maintenance branch. Additionally, it is the developers responsibility to make sure the change has been merged into trunk.
 +
 
 +
==Bug triage==
 +
 
 +
Help the GRAMPS project [[Bug triage]].
 +
 
 +
==Syntax==
 +
 
 +
[http://www.mantisbt.org/ Mantis bug tracker] uses its own syntax code :
 +
* ''#'' before a bug number writes a link to the bug.
 +
* ''~'' before a comment number writes a link to the comment, same as : ''{url}#c{comment number}''.
 +
* we can try to use some HTML tags into text field, like : <code> < pre >< /pre > < i > < / i > < b > < / b></code> 
 +
 
 +
[[Category:Developers/General]]

Revision as of 05:37, 5 December 2012

The bug/issue tracker for GRAMPS is located at the following URL: http://bugs.gramps-project.org This bug/issue tracker allows users and developers to log new issues and track them as they progress. Please take some time to read the issue tracker instructions below and read how to create a good bug report. Also, have a look at known issues and common problems.

Report a bug

1. Login

To report a bug, you must have a login account on http://bugs.gramps-project.org, which is the GRAMPS bug tracker. When you create a user account, remember that it can take up to 12 hours before a notification email is send to you. Only after clicking on the link in the email can you submit bugs. Your email address will be handled confidentially.

2. Search existing bugs

Perhaps the bug you want to report has been submitted before. To check this, click on 'View Issues'. The top of the page is reserved for filters, which you set. Normally the default filters are just fine. Under these filters, there is a search box. Enter the terms best describing the bug, and click apply filter. If you have an error message, try pasting a part of the error, to see if it is has been reported already.

If the bug is already reported, read the bug report over, and see if you can add to the information. If so, you can leave a note with extra information to help the developers.

3. Submit new bug

Click on Report Issue, and enter the required information, see below on how to select the project to which the bug belongs. Be verbose, the developers are bad at mind reading. Do not forget to list the GRAMPS version you are using. You can check this in GRAMPS by clicking in the GRAMPS program the Help menu, option About.

Projects

In the upper right corner of the issue tracker, there is a place to select the "project" for the bugs. "Projects" are a way to categorize issues. There are three types of projects in the issue tracker:

  1. The Feature Requests project is a place for recording requests for new features.
  2. The projects with names that look like Gramps x.x.X are where issues are reported that apply specifically to a maintenance branch (see Types of Branches). A separate project exists for each maintenance branch.
  3. The Gramps Trunk project should only be used by developers and testers of the latest code. It is a place for recording issues that only apply to the trunk in Subversion (see Types of Branches). There is only one "Gramps Trunk" project because there is only one trunk in the Subversion repository

How to proceed

The first step in submitting an issue on the tracker is to determine which project it belongs to.

  • If the issue represents functionality that does not currently exist in GRAMPS, then the issue should be filed under the Feature Requests project.
  • If the issue represents a problem with functionality that has been released in a stable release of code, then the issue should be filed under the project that corresponds to the maintenance branch for that release. For example, a bug found in GRAMPS 3.2.6 should be filed under the Gramps 3.2.X project.
  • If the issue represents a problem with functionality that only exists in trunk, or the problem exists in trunk, but not any stable releases, then the issue should be filed under the Gramps Trunk project.

Resolving bugs

This information is for the developers following up on the submitted issues.

In general, when resolving an issue, it is always a good idea to add a note with the SVN revision number of the commit that fixed the problem.

When resolving issues in a maintenance branch, one should always set the "Fixed in version" field to the version of the next release that will be made from that branch. This is done so that the issue properly appears in the ChangeLog page for that project (http://bugs.gramps-project.org/changelog_page.php).

Bugs in maintenance branch projects should not be marked as closed until the developer has committed the change into the corresponding maintenance branch. Additionally, it is the developers responsibility to make sure the change has been merged into trunk.

Bug triage

Help the GRAMPS project Bug triage.

Syntax

Mantis bug tracker uses its own syntax code :

  • # before a bug number writes a link to the bug.
  • ~ before a comment number writes a link to the comment, same as : {url}#c{comment number}.
  • we can try to use some HTML tags into text field, like : < pre >< /pre > < i > < / i > < b > < / b>