Usertagstag icon

Usertags is a new nice feature in the bug tracking system that can be used to tag bugs how you like to do it. The tags are bound to a user, and a user is in this case an email address. Usertags can be used to create different views on bugs and it can also be used to track stuff across packages.

The KDE packagers mostly use the tags associated with debian-qt-kde@lists.debian.org to create views of related bugs or bugs with special needs. The special views are for larger programs like konqueror that have many different functions to show bugs only for one of the tasks. The special needs could be that the bug is related to interaction with a Microsoft Exchange server.

How to set usertags

Usertags are set by emails to control@bugs.debian.org just like ordinary tags. The syntax is a bit different and there is not a predefined set of tags, so beware of typos.

user debian-qt-kde@lists.debian.org
usertag #1234 +kde-foo

Please only set the predefined tags already used by the KDE packagers. If you find a need for a new tag, please approach the packagers before using it, or alternatively tag bugs as your own user.

How to view usertags

The usertags are viewed by handcrafting urls to the bug system, more specifically adding arguments to pkgreport.cgi. The different arguments are seperated by semicolon (;).
The following arguments are recognized:

pkg
include all bugs by binary package
src
include all bugs by source package
maint
include all bugs by package maintainer (email address)
dist
include bugs that applies to distribution (stable, testing, unstable)
users
Set the user for usertags. Multiple users can be seperated with colon (:)
tag
include bugs with the following tags. Can be specified multiple times or alternatively tags can be comma (,) seperated
exclude
exclude bugs with the following tags. Can be specified multiple times or alternatively tags can be comma (,) seperated

With these arguments, most views are created. A couple of examples:

http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-qt-kde@lists.debian.org;tag=kmail-imap;dist=unstable
Bugs in unstable tagged kmail-imap by the user debian-qt-kde@lists.debian.org
http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=konqueror;users=debian-qt-kde@lists.debian.org;exclude=konqueror-filemanager;exclude=konqueror-webbrowser;dist=unstable
Bugs in unstable in binary package konqueror not tagged konqueror-filemanager or konqueror-webbrowser by the user debian-qt-kde@lists.debian.org

The usertags used by the KDE packagers

Some usertags are in the KDE packages only used in specific source packages. Other usertags are used across all source packages.

kdepim

kmail-imap
Imap-related bugs in konqueror
kmail-ssl
bugs in kmail related to ssl-connections

kdebase

konqueror-webbrowser
Bugs in konqueror as browser on world wide web. Mostly crashes on webpages and bad rendering
konqueror-filemanager
Bugs in konqueror related to its use as a filemanager

kdenetwork

kopete-msn
kopete as a client for msn network
kopete-icq
kopete as a icq client
kopete-irc
kopete as irc client

Tags across source packages

kde-needs-ldap
Bugs related to interaction with a ldap server
kde-needs-exchange
Bugs related to interaction with a Exchange server
kde-needs-home-on-nfs
Bugs related to having home on a kind of network file system
kde-fancy-x
Bugs related to special settings related to X. Including, but not limited to xinerama, transluciency, compiz, beryl and openGL in general
kde-app-not-in-kde
Bugs only appearing when KDE apps are used outside kde (in gnome/xfce/windowmaker etc)
fixed-kde4
Bugs fixed in KDE 4
qt3libs-removal and kde3libs-removal
The Debian Qt/KDE team is planning to remove the KDE3 and Qt3 libraries from Debian shortly after the Squeeze release. The transition phase to KDE4 and Qt4 will finish since both KDE and Nokia upstream don't maintain the old versions of those libraries anymore.
fixed-kde3.5.6
Bugs fixed in KDE 3.5.6