tags 367876 + patch thanks > IMO it is a best-practice to set usertags when filing lots of bugs for > a given problem, Patch attached. > please get consensus how it should be chosen and what will be the choice > of e-mail adress for each types of reasons on debin-devel@LDO. I don't really see the benefit of this -- it's not really the job of the devref to to document how various groups use their usertags, so enumerating them here would only really lead to developers usertagging bugs--with good intentions--but incorrectly. Futhermore, some usertags are likely to be "restricted" in an informal manner (similar to how the "etch" and "lenny" tags operate at the moment). Regards, -- Chris Lamb, UK chris@chris-lamb.co.uk GPG: 0x634F9A20
commit 64804ff791bdcbd49b62a8de4332906a0066f10c Author: Chris Lamb <chris@chris-lamb.co.uk> Date: Sat Jul 12 18:54:43 2008 +0100 Add information about usertags with resepect to mass bug filing. (Closes: #367876) Signed-off-by: Chris Lamb <chris@chris-lamb.co.uk> diff --git a/beyond-pkging.dbk b/beyond-pkging.dbk index 77a9739..6cc5d63 100644 --- a/beyond-pkging.dbk +++ b/beyond-pkging.dbk @@ -94,6 +94,41 @@ Note that when sending lots of bugs on the same subject, you should send the bug report to <email>maintonly@&bugs-host;</email> so that the bug report is not forwarded to the bug distribution mailing list. </para> +<section id="usertags"> +<title>Usertags</title> +<para> +You may wish to use BTS usertags when submitting bugs across a number of +packages. Usertags are similar to normal tags such as 'patch' and 'wishlist' +but differ in that they are user-defined and occupy a namespace that is +unique to a particular user. This allows multiple sets of developers to +'usertag' the same bug in different ways without conflicting. +</para> +<para> +To add usertags when filing bugs, specify the <literal>User</literal> and +<literal>Usertags</literal> pseudo-headers: +</para> +<screen> +To: submit@bugs.debian.org +Subject: <replaceable><title-of-bug></replaceable> + +Package: <replaceable><pkgname></replaceable> +<replaceable>[ ... ]</replaceable> +User: <replaceable><email-addr></replaceable> +Usertags: <replaceable><tag-name> [ <tag-name> ... ]</replaceable> + +<replaceable><description-of-bug ...></replaceable> +</screen> +<para> +Note that tags are seperated by spaces and cannot contain underscores. If you +are filing bugs for for a particular group or team it is recommended that you +set the <literal>User</literal> to an appropriate mailing list after describing +your intention there. +</para> +<para> +To view bugs tagged with a specific usertag, visit +<literal>http://&bugs-host;/cgi-bin/pkgreport.cgi?users=<replaceable><email-addr></replaceable>&tag=<replaceable><tag-name></replaceable></literal>. +</para> +</section> </section> </section>
Attachment:
signature.asc
Description: PGP signature