Developers' information regarding the bug processing system

Initially, a bug report is submitted by a user as an ordinary mail message to submit@bugs.linux-mandrake.com. This will then be given a number, acknowledged to the user, and forwarded to a mailing list (if configured). If the submitter included a Package line listing a package with a known maintainer the maintainer will get a copy too.

The Subject line will have bug#nnn: added, and the Reply-To will be set to include both the submitter of the report and nnn@bugs.linux-mandrake.com.

Closing bug reports

A developer who receives a bug from the tracking system, or sees it on the mailing list, and takes responsibility for it should hit Reply in their favourite mailreader, and then edit the To field to say nnn-done@bugs.linux-mandrake.com instead of nnn@bugs.linux-mandrake.com (nnn-close is provided as an alias for nnn-done).

The address of the original submitter of the bug report will be included in the default To field, because the bug system included it in the Reply-To.

`Done' messages are forwarded to a mailing list if the mailing list has been set up.

The person closing the bug and the person who submitted it will each get a notification about the change in status of the report.

Followup messages

If a developer wishes to reply to a bug report without marking the bug as done they may simply reply to the message. Their reply will (by default) go to nnn@bugs.linux-mandrake.com and to the original submitter of the bug report. The bug tracking system will file the reply with the rest of the logs for that bug report and forward it to a designated mailing list. The bug will not be marked as done.

If you wish to send a followup message which is not appropriate for any mailing list you can do so by sending it to nnn-quiet@bugs.linux-mandrake.com or nnn-maintonly@bugs.linux-mandrake.com, which only file it (not forwarding it anywhere) and send it on only to the maintainer of the package in question, respectively.

Do not use the `reply to all recipients' or `followup' feature of your mailer unless you intend to edit down the recipients substantially. In particular, don't send a followup message both to nnn@bugs.linux-mandrake.com and to submit@bugs.linux-mandrake.com, because the bug system will then get two copies of it and each one will be forwarded to the designated mailing list separately.

Severity levels

The bug system records a severity level with each bug report. This is set to normal by default, but can be overridden either by supplying a Severity line in the psuedo-header when the bug is submitted (see the instructions for reporting bugs), or by using the severity command with the control request server.

The severity levels are:

critical
makes unrelated software on the system (or the whole system) break, or causes serious data loss, or introduces a security hole on systems where you install the package.
grave
makes the package in question unuseable or mostly so, or causes data loss, or introduces a security hole allowing access to the accounts of users who use the package.
normal
the default value, for normal bugs.
wishlist
for any feature request, and also for any bugs that are very difficult to fix due to major design considerations.

Recording that you have passed on a bug report

When a developer forwards a bug report to the developer of the upstream source package from which the Mandrake package is derived, they should note this in the bug tracking system as follows:

Make sure that the To field of your message to the author to has only the author(s) address(es) in it; put both the person who reported the bug and nnn-forwarded@bugs.linux-mandrake.com in the CC field.

Ask the author to preserve the CC to nnn-forwarded@bugs.linux-mandrake.com when they reply, so that the bug tracking system will file their reply with the original report.

When the bug tracking system gets a message at nnn-forwarded it will mark the relevant bug as having been forwarded to the address(es) in the To field of the message it gets.

You can also manipulate the `forwarded to' information by sending messages to control@bugs.linux-mandrake.com.

Summary postings

Every Friday, a list of outstanding bug reports is posted to a summary mailing list (if set up), sorted by age of report. Every Tuesday, a list of bug reports that have gone unanswered too long is posted, sorted by package maintainer.

Reopening, reassigning and manipulating bugs

It is possible to reassign bug reports to other packages, to reopen erroneously-closed ones, to modify the information saying to where, if anywhere, a bug report has been forwarded, to change the severities and titles of reports and to merge and unmerge bug reports. This is done by sending mail to control@bugs.linux-mandrake.com.

The format of these messages is described in another document available on the World Wide Web or in the file bug-maint-mailcontrol.txt. A plain text version can also be obtained by mailing the word help to the server at the address above.

More-or-less obsolete subject-scanning feature

(this is likely to be removed the next version)
Messages that arrive at submit or bugs whose Subject starts Bug#nnn will be treated as having been sent to nnn@bugs.linux-mandrake.com. This is both for backwards compatibility with mail forwarded from the old addresses, and to catch followup mail sent to submit by mistake (for example, by using reply to all recipients).

A similar scheme operates for maintonly, done, quiet and forwarded, which treat mail arriving with a Subject tag as having been sent to the corresponding nnn-whatever@bugs.linux-mandrake.com address.

Messages arriving at plain forwarded and done - ie, with no bug report number in the address - and without a bug number in the Subject will be filed under `junk' and kept for a few weeks, but otherwise ignored.

Future plans

At some point the Package: secondary header field may become mandatory - at the moment omitting it just produces a warning message.
Other pages:
pixel / debbugs-maintainer@linux-mandrake.com. Last modifed: 21:26:40 GMT Tue 03 Aug (timestamp page available).

Debian bug tracking system
copyright 1997 nCipher Corporation Ltd,
copyright 1994-1997 Ian Jackson,
copyright 1995 Steven Brenner.
Available under the GPL.