Current File : //usr/share/doc/xorg/howto/triage-bugs.txt
How to triage bugs
==================
:toc:
Cyril Brulebois <kibi@debian.org>
Packaging bugs or upstream bugs?
--------------------------------
It’d be nice to get all upstream bugs tagged as such (`upstream` tag),
forwarded upstream (which means the bugzilla instance on
https://bugs.freedesktop.org/ for most packages), and marked as such.
A mail to `control@bugs.debian.org` would look like:
----
tag X upstream
forwarded X https://bugs.freedesktop.org/show_bug.cgi?id=Y
thanks
----
Then https://bts-link.alioth.debian.org/[`bts-link`] comes into play
and helps us tracking upstream status, which is pretty nice to have.
<<<
Usertags
--------
Another feature of the BTS is usertagging. That lets people keep track
of additional tags, “attached” to a given mail address. For XSF,
that’s `debian-x@lists.debian.org`.
The list of all usertagged bugs can be seen on the following page; the
list of all used usertags is at the bottom, in the form. +
→ https://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org
Let’s give some examples:
* `i810`, `i915`: helps triaging `-video-intel` bugs depending on the
chipset.
* `r200`, `r300`: ditto for `-video-ati`.
* `xset`, `xrandr`: helps triaging `x11-xserver-utils` bugs depending
on the affected tool (like other `x11-*` packages, that’s a bundle
of teeny tiny apps).
* `squeeze-candidate`: helps keeping a list of bugs we’d like to get
fixed in a point release (through a stable update).
* `needs-forwarding`: of course, it’d be nice to have all upstream
bugs reported upstream, but some might need special attention
(_e.g._ security bugs).
Here’s an example of URL, for the last tags: +
→ https://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org&tag=squeeze-candidate +
→ https://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org&tag=needs-forwarding
By the way one should keep an eye on the list of found/fixed
versions since those bugs are likely marked as resolved (in `unstable`
or `experimental`), but might still affect a stable release.
To list the bugs marked `squeeze-candidate` but not
`squeeze-accepted`: +
→ https://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org&tag=squeeze-candidate&exclude=tag:squeeze-accepted
<<<
Categories
----------
The BTS has yet another feature which can help, categories. That’s
based on usertags as well, but one has to use the package address
(`$package@packages.debian.org`), so that’s package-specific rather
than team-specific.
Categories are
https://wiki.debian.org/bugs.debian.org/usertags[documented on the wiki],
and they would probably be welcome in the `intel` and `ati` cases
above, as well as in the “multiple tools in a single bundle”
cases… An example of what we could achieve is the
https://bugs.debian.org/devscripts[devscripts bug page] (it takes
some time to load, plenty of bugs).
Needed steps for that to happen:
* create usercategories.
* move usertags from `debian-x@lists.debian.org` to
`$package@packages.debian.org`, probably using the `bts select`
command to get the list over which to iterate.
* profit!
To move the usertags, something like that should do the job:
----
# Adding usertags:
user $package1@packages.debian.org
usertag X xset
usertag Y xrandr
user $package2@packages.debian.org
usertag Z i810
# Removing tags which are no longer needed:
user debian-x@lists.debian.org
usertag X - xset
usertag Y - xrandr
usertag Z - i810
----
Mini Shell