User Tools

Site Tools


wiki:bugs

This is an old revision of the document!


X2Go Bug Tracker

The X2Go project uses the debbugs as bug tracking system (BTS) software. The debbugs tracker is the software that's also used by the Debian project for tracking issues in the multitude of Debian packages.

Before X2Go had a bug tracker, the quest was: we need a BTS that is easily scriptable and a BTS that fully maps issue tracking to the developers' mail clients. Furthermore, we did not want a bug tracker that could be fed with content by clicking around on a web page.

The choice has been well thought of, you may find that there are better bug tracking systems in the world. For X2Go, we think we have found what we wanted.

Open / Closed Bugs

If you know either the X2Go component or the bug number you can also access the information directly:

A complete list of X2Go components with open/closed bugs can be viewed with this URL:

Reporting Bugs

How to report a bug is fully explained here. In a nutshell send a mail like the one below (everything that is written in <pointed-brackets> needs being replaced by some proper value.

Plain bug submission

To: submit@bugs.x2go.org
Subject: <a-really-good-short-description-of-the-problem>
Body:
"""
Package: <name-of-x2go-component>
Version: <a.b.c.d>

<your-not-too-long-description-of-the-discovered-problem>
"""

Bug submission with a Patch

In case you can provide a patch with your bug report, please attach the patch to your bug report. Do not copy+paste the patch into the mail body, as the result will not be usable!!!

Some of you have their own Git clones of X2Go Git. If you want to provide a patch via your public Git clone of an X2Go component, please make sure that the patch is just one commit on one of your Git branches. The rule here is simple: one Git commit on your side, one bug report in X2Go BTS. Everything else will take too much time on the patch reviewer side.

For submitting your bug report, please use this very similar template:

To: submit@bugs.x2go.org
Subject: <a-really-good-short-description-of-the-problem>
Body:
"""
Package: <name-of-x2go-component>
Version: <a.b.c.d>
Tag: patch

<your-not-too-long-description-of-the-discovered-problem>
"""
Attachment: <your-patch.diff>

Controlling Bugs

The full control command set is documented here.

Very common control sequences are shown below.

Bug has been fixed in X2Go Git

Bugs are only closed as part of the X2Go release workflow. The release manager only is allowed to close bugs (this is an agreement, not a technical constraint). To mark a bug as fixed whilst it is not yet included in a release, we tag the bug as pending and add the (next-to-be-released) version number for that the issue will be fixed:

To: <nnn>@bugs.x2go.org
Cc: control@bugs.x2go.org, <nnn>-submitter@bugs.x2go.org
Subject: Issue resolved in X2Go Git
Body:
"""
tag #<nnn> pending
fixed #<nnn> <a.b.c.d>
thanks

The reported issue has been resolved with this commit:
<http-URL-to-Gitweb-of-commitdiff>

Thanks,
<my-name>
"""

New version with a bug fixed has been released

As part of the X2Go release workflow, bugs that have been fixed for this release have to be closed. Normally, most bugs are already marked (tagged) as pending and have been marked with a version that tells the release manager if a bug has been fixed for that version or not.

Some pending bugs, though, may only have been fixed on the master branch, but not yet on a release branch. If the release is taken from a release branch, take a look at the released component's changelog before closing bugs that are not yet to be closed.

To: <nnn>@bugs.x2go.org
Cc: control@bugs.x2go.org, <nnn>-submitter@bugs.x2go.org
Subject: Issue resolved in <x2go-component> <version>
Body:
"""
close #<nnn>
thanks

The reported issue has been resolved in the lately release version <version> of <x2go-component>.

Thanks for reporting this issue,
<my-name>
"""

Bug has been reported against the wrong X2Go Component

Even for X2Go power-users and developers it is not always easy to tell, what X2Go component causes a certain buggy behaviour in X2Go. Once a problem has been narrowed down, we might need to reassign a bug to another X2Go component.

To: <nnn>@bugs.x2go.org
Cc: control@bugs.x2go.org, <nnn>-submitter@bugs.x2go.org
Subject: <a-good-subject-line>
Body:
"""
reassign #<nnn> <another-x2go-component>
thanks

The reported issue is actually a bug in <another-x2go-component>. Reassigning.

<further-info-if-any>

Thanks for reporting this issue,
<my-name>
"""

Bug submitter used a non-appropriate title

People sometimes use inappropriate titles when submitting bugs. Also, the summarizing title of a bug can be improved, once we know what the reason for the occuring error really is.

To: <nnn>@bugs.x2go.org
Cc: control@bugs.x2go.org, <nnn>-submitter@bugs.x2go.org
Subject: <a-good-subject-line>
Body:
"""
retitle #<nnn> <better-title>
thanks

<further-info-if-any>

Thanks for reporting this issue,
<my-name>
"""
wiki/bugs.1364292942.txt.gz · Last modified: 2013/03/26 10:15 by sunweaver