annotate admin/notes/bugtracker @ 108830:0d7ed8742a5f

emulation/cua-base.el: Recognize `right-char', `left-char' as movement commands.
author Juanma Barranquero <lekktu@gmail.com>
date Sun, 30 May 2010 06:44:46 +0200
parents 85d6810f63ed
children f82a793ed06b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
1 NOTES ON THE EMACS BUG TRACKER -*- outline -*-
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2
106610
033513eeca72 emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents: 106337
diff changeset
3 The Emacs Bug Tracker can be found at http://debbugs.gnu.org/
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4
106995
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
5 * Quick-start guide
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
6
107943
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
7 This is 95% of all you will ever need to know.
106995
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
8
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
9 ** How do I report a bug?
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
10 Use M-x report-emacs-bug, or send mail to bug-gnu-emacs@gnu.org.
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
11 If you want to Cc someone, use an "X-Debbugs-CC" header instead.
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
12
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
13 ** How do I comment on a bug?
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
14 Reply to a mail on the bug-gnu-emacs list in the normal way.
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
15 Or send a mail to 123@debbugs.gnu.org.
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
16
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
17 If the bug is old and closed, you may have to unarchive it first.
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
18 Send a mail to control@debbugs.gnu.org with
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
19 unarchive 123
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
20 on the first line of the body.
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
21
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
22 ** How do I close a bug?
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
23 Send a mail to 123-done@debbugs.gnu.org. In the body, explain
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
24 why the bug is being closed.
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
25
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
26 ** How do I set bug meta-data?
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
27 By mailing commands to control@debbugs.gnu.org. Place commands at the
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
28 start of the message body, one per line.
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
29
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
30 severity 123 serious|important|normal|minor|wishlist
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
31 tags 123 moreinfo|unreproducible|wontfix|patch
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
32
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
33 * More detailed information
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
34
106611
09979dbce827 Refer to the static bug page (rather than the dynamic one) for a list
Glenn Morris <rgm@gnu.org>
parents: 106610
diff changeset
35 For a list of all bugs, see http://debbugs.gnu.org/db/pa/lemacs.html
106612
8eda61c377f7 Expand on previous change.
Glenn Morris <rgm@gnu.org>
parents: 106611
diff changeset
36 This is a static page, updated once a day. There is also a dynamic
107943
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
37 list, generated on request. This accepts various options, eg to see
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
38 the most recent bugs:
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
39
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
40 http://debbugs.gnu.org/cgi/pkgreport.cgi?newest=100
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
41
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
42 Or follow the links on the front page http://debbugs.gnu.org .
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
43
97973
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
44 ** How do I report a bug in Emacs now?
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
45 The same way as you always did. Send mail to bug-gnu-emacs@gnu.org,
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
46 or use M-x report-emacs-bug.
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
47
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
48 The only differences are:
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
49
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
50 i) Your report will be assigned a number and generate an automatic reply.
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
51
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
52 ii) Optionally, you can set some database parameters when you first
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
53 report a bug (see "Setting bug parameters" below).
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
54
98568
ff2b87be96f9 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 98523
diff changeset
55 iii) If you want to CC: someone, use X-Debbugs-CC: (this is important;
ff2b87be96f9 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 98523
diff changeset
56 see below).
97973
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
57
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
58 Once your report is filed and assigned a number, it is sent out to the
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
59 bug mailing list. In some cases, it may be appropriate to just file a
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
60 bug, without sending out a copy. To do this, send mail to
106610
033513eeca72 emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents: 106337
diff changeset
61 quiet@debbugs.gnu.org.
97973
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
62
0127639d1179 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97931
diff changeset
63 ** How do I reply to an existing bug report?
106610
033513eeca72 emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents: 106337
diff changeset
64 Reply to 123@debbugs.gnu.org, replacing 123 with the number
98513
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
65 of the bug you are interested in. NB this only sends mail to the
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
66 bug-list, it does NOT (?) send a CC to the original bug submitter.
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
67 So you need to explicitly CC him/her (and anyone else you like).
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
68
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
69 (Many people think the submitter SHOULD be automatically subscribed
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
70 to subsequent discussion, but this does not seem to be implemented.
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
71 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=37078)
106967
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
72 See also http://debbugs.gnu.org/5439
98513
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
73
106968
8c9b1893adfe Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents: 106967
diff changeset
74 Do NOT send a separate copy to the bug list address, since this may
8c9b1893adfe Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents: 106967
diff changeset
75 generate a new report. The only time to send mail to the bug list
8c9b1893adfe Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents: 106967
diff changeset
76 address is to create a new report.
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
77
101597
fb07b238e55a Update message-dont-reply-to-names section.
Glenn Morris <rgm@gnu.org>
parents: 101512
diff changeset
78 Gnus users can add the following to message-dont-reply-to-names;
fb07b238e55a Update message-dont-reply-to-names section.
Glenn Morris <rgm@gnu.org>
parents: 101512
diff changeset
79 similarly with Rmail and rmail-dont-reply-to-names:
fb07b238e55a Update message-dont-reply-to-names section.
Glenn Morris <rgm@gnu.org>
parents: 101512
diff changeset
80
106971
9fa45b0cc7d9 Add the aliases bug-emacs and bug-gnumacs.
Glenn Morris <rgm@gnu.org>
parents: 106969
diff changeset
81 "\\(emacs-pretest-bug\\|bug-gnu-emacs\\|bug-\\(e\\|gnu\\)macs\\)@gnu\\.org\\|\
106626
9306e1ad9272 Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents: 106612
diff changeset
82 \\(submit\\|control\\|owner\\)@debbugs\\.gnu\\.org"
101512
80672b7f9b76 Add some addresses for rmail users to ignore.
Glenn Morris <rgm@gnu.org>
parents: 101312
diff changeset
83
106626
9306e1ad9272 Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents: 106612
diff changeset
84 The "owner@debbugs.gnu.org" entry is there because it appears in the
9306e1ad9272 Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents: 106612
diff changeset
85 "Resent-To" header. For a long time Rmail erroneously included such
9306e1ad9272 Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents: 106612
diff changeset
86 headers in replies. If you correspond with an Rmail user on a bug,
9306e1ad9272 Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents: 106612
diff changeset
87 these addresses may end up in the Cc. Mailing to them does nothing
9306e1ad9272 Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents: 106612
diff changeset
88 but create duplicates and errors. (It is possible you might want to
9306e1ad9272 Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents: 106612
diff changeset
89 have a dialog with the owner address, outside of normal bug
9306e1ad9272 Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents: 106612
diff changeset
90 reporting.)
100191
56005ec017c3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 98568
diff changeset
91
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
92 ** When reporting a bug, to send a Cc to another address
98568
ff2b87be96f9 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 98523
diff changeset
93 (e.g. bug-cc-mode@gnu.org), do NOT just use a Cc: header.
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
94 Instead, use "X-Debbugs-CC:". This ensures the Cc address will get a
98568
ff2b87be96f9 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 98523
diff changeset
95 mail with the bug report number in. If you do not do this, each reply
106969
5824bdf04287 Small fixes.
Glenn Morris <rgm@gnu.org>
parents: 106968
diff changeset
96 in the subsequent discussion will end up creating a new bug.
5824bdf04287 Small fixes.
Glenn Morris <rgm@gnu.org>
parents: 106968
diff changeset
97 This is annoying.
95486
23898c5b8565 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95474
diff changeset
98
107943
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
99 (So annoying that a form of message-id tracking has been implemented
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
100 to hopefully stop this happening, but it is still better to use X-Debbugs-CC.)
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
101
106967
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
102 If a new report contains X-Debbugs-CC in the input, this is
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
103 converted to a real Cc header in the output. (See Bug#1720).
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
104 It is also merged into the Resent-CC header (see below).
102276
b8be61499474 Mention bug 1720.
Glenn Morris <rgm@gnu.org>
parents: 101949
diff changeset
105
b8be61499474 Mention bug 1720.
Glenn Morris <rgm@gnu.org>
parents: 101949
diff changeset
106 ** How does Debbugs send out mails?
b8be61499474 Mention bug 1720.
Glenn Morris <rgm@gnu.org>
parents: 101949
diff changeset
107
106968
8c9b1893adfe Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents: 106967
diff changeset
108 The mails are sent out to the bug list by being resent. The From:
8c9b1893adfe Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents: 106967
diff changeset
109 header is unchanged. In new reports only (at present), the To:
8c9b1893adfe Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents: 106967
diff changeset
110 address is altered as follows. Any "bug-gnu-emacs",
8c9b1893adfe Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents: 106967
diff changeset
111 "emacs-pretest-bug", or "submit@debbugs" address is replaced by
8c9b1893adfe Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents: 106967
diff changeset
112 123@debbugs in the mail that gets sent out. (This also applies to any
8c9b1893adfe Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents: 106967
diff changeset
113 Cc: header, though you should be using X-Debbugs-CC instead in new
8c9b1893adfe Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents: 106967
diff changeset
114 reports). The original header is stored as X-Debbugs-Original-To, if
8c9b1893adfe Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents: 106967
diff changeset
115 it was changed. Any X-Debbugs-CC is merged into the Cc.
102276
b8be61499474 Mention bug 1720.
Glenn Morris <rgm@gnu.org>
parents: 101949
diff changeset
116
b8be61499474 Mention bug 1720.
Glenn Morris <rgm@gnu.org>
parents: 101949
diff changeset
117 Mails arriving at the bug list have the following Resent-* headers:
b8be61499474 Mention bug 1720.
Glenn Morris <rgm@gnu.org>
parents: 101949
diff changeset
118
b8be61499474 Mention bug 1720.
Glenn Morris <rgm@gnu.org>
parents: 101949
diff changeset
119 Resent-From: person who submitted the bug
106626
9306e1ad9272 Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents: 106612
diff changeset
120 Resent-To: owner@debbugs.gnu.org
102276
b8be61499474 Mention bug 1720.
Glenn Morris <rgm@gnu.org>
parents: 101949
diff changeset
121 Resent-CC: maintainer email address, plus any X-Debbugs-CC: entries
b8be61499474 Mention bug 1720.
Glenn Morris <rgm@gnu.org>
parents: 101949
diff changeset
122
106626
9306e1ad9272 Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents: 106612
diff changeset
123 The "maintainer email address" is "bug-gnu-emacs@gnu.org" in most cases.
102276
b8be61499474 Mention bug 1720.
Glenn Morris <rgm@gnu.org>
parents: 101949
diff changeset
124
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
125 ** To not get acknowledgement mail from the tracker,
98513
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
126 add an "X-Debbugs-No-Ack:" header (with any value). If you use Gnus,
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
127 you can add an element to gnus-posting-styles to do this automatically, eg:
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
128
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
129 ("gnu-emacs\\(-pretest\\)?-bug"
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
130 ("X-Debbugs-No-Ack" "yes"))
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
131
7a46a52ccfaf *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97989
diff changeset
132 (adjust the regexp according to the name you use for the bug lists)
95486
23898c5b8565 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95474
diff changeset
133
96467
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
134 ** To record a bug in the tracker without sending mail to the bug list.
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
135 This can be useful to make a note of something discussed on
96468
5c93e68f7620 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96467
diff changeset
136 emacs-devel that needs fixing. In other words, this can be the
5c93e68f7620 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96467
diff changeset
137 equivalent of adding something to FOR-RELEASE.
96467
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
138
106610
033513eeca72 emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents: 106337
diff changeset
139 To: quiet@debbugs.gnu.org
96467
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
140 [headers end]
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
141 Package: emacs
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
142 Version: 23.0.60
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
143 Severity: minor
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
144
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
145 Remember to fix FOO, as discussed on emacs-devel at http://... .
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
146
96401
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
147 ** Not interested in tracker control messages (tags being set, etc)?
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
148 Discard mails matching:
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
149
107493
883859fd8369 * bugtracker: Debbugs's X-Emacs mail headers are now X-GNU headers.
Glenn Morris <rgm@gnu.org>
parents: 107078
diff changeset
150 ^X-GNU-PR-Message: (transcript|closed)
96402
7f88a1df4a80 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96401
diff changeset
151
96401
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
152 ** How to avoid multiple copies of mails.
106967
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
153 If you reply to reports in the normal way, this should work fine.
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
154 Basically, reply only to the numbered bug address (and any individual
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
155 people's addresses). Do not send mail direct to bug-gnu-emacs or
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
156 emacs-pretest-bug unless you are reporting a new bug.
96401
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
157
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
158 ** To close bug #123 (for example), send mail
95486
23898c5b8565 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95474
diff changeset
159
106610
033513eeca72 emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents: 106337
diff changeset
160 To: 123-done@debbugs.gnu.org
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
161
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
162 with a brief explanation in the body as to why the bug was closed.
106005
d44e34269048 No need to cc on -done messages.
Glenn Morris <rgm@gnu.org>
parents: 104535
diff changeset
163 There is no need to cc the address without the "-done" part or the
d44e34269048 No need to cc on -done messages.
Glenn Morris <rgm@gnu.org>
parents: 104535
diff changeset
164 submitter; they get copies anyway so this will just result in more
d44e34269048 No need to cc on -done messages.
Glenn Morris <rgm@gnu.org>
parents: 104535
diff changeset
165 duplicate mail.
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
166
106995
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
167 ** Details of closing a bug.
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
168 (For information only)
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
169 Sending a mail to 123-done does the following:
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
170
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
171 1) Mark the bug as closed in the database.
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
172
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
173 2) Send a mail to the original submitter telling them that their bug
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
174 has been closed. This mail has a header:
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
175
107493
883859fd8369 * bugtracker: Debbugs's X-Emacs mail headers are now X-GNU headers.
Glenn Morris <rgm@gnu.org>
parents: 107078
diff changeset
176 X-GNU-PR-Message: they-closed 123
106995
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
177
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
178 3) Send a mail to you and to the emacs-bug-tracker list confirming
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
179 that the bug has been closed. This mail has a header:
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
180
107493
883859fd8369 * bugtracker: Debbugs's X-Emacs mail headers are now X-GNU headers.
Glenn Morris <rgm@gnu.org>
parents: 107078
diff changeset
181 X-GNU-PR-Message: closed 123
106995
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
182
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
183 4) Send a copy of your mail to the bug-gnu-emacs list in exactly the
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
184 same way as if you had sent mail to "123" (sans -done). This mail has
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
185 headers:
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
186
107493
883859fd8369 * bugtracker: Debbugs's X-Emacs mail headers are now X-GNU headers.
Glenn Morris <rgm@gnu.org>
parents: 107078
diff changeset
187 X-GNU-PR-Message: cc-closed 123
107018
ee105028fee8 Add some details of bzr's --fixes option.
Glenn Morris <rgm@gnu.org>
parents: 106995
diff changeset
188 Mail-Followup-To: 123@debbugs.gnu.org, person-who-closed
106995
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
189
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
190 (This is Emacs-specific. Normally the bug list gets the same mail as in 3).
001a0729d255 Add a quick-start guide.
Glenn Morris <rgm@gnu.org>
parents: 106971
diff changeset
191
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
192 ** Setting bug parameters.
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
193 There are two ways to set the parameters of bugs in the database
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
194 (tags, severity level, etc). When you report a new bug, you can
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
195 provide a "pseudo-header" at the start of the report, eg:
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
196
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
197 Package: emacs
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
198 Version: 23.0.60
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
199 Severity: minor
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
200
107943
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
201 This can also include tags. Some things (e.g. submitter) don't seem to
97782
cb78e0393bd9 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97753
diff changeset
202 work here.
cb78e0393bd9 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97753
diff changeset
203
106610
033513eeca72 emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents: 106337
diff changeset
204 Otherwise, send mail to the control server, control@debbugs.gnu.org.
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
205 At the start of the message body, supply the desired commands, one per
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
206 line:
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
207
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
208 command bug-number [arguments]
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
209 ...
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
210 quit|stop|thank|thanks|thankyou|thank you
95473
762c4fbf32b0 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95446
diff changeset
211
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
212 The control server ignores anything after the last line above. So you
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
213 can place control commands at the beginning of a reply to a bug
96506
675709b2568f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96482
diff changeset
214 report, and Bcc: the control server (note the commands have no effect
675709b2568f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96482
diff changeset
215 if you just send them to the bug-report number). Bcc: is better than Cc:
675709b2568f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96482
diff changeset
216 in case people use Reply-to-All in response.
95473
762c4fbf32b0 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95446
diff changeset
217
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
218 Some useful control commands:
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
219
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
220 *** To reopen a closed bug:
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
221 reopen 123
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
222
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
223 *** Bugs can be tagged in various ways (eg wontfix, patch, etc).
96506
675709b2568f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96482
diff changeset
224 The available tags are:
675709b2568f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96482
diff changeset
225 patch wontfix moreinfo unreproducible fixed notabug
106845
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
226 See http://debbugs.gnu.org/Developer#tags
96506
675709b2568f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96482
diff changeset
227 The list of tags can be prefixed with +, - or =, meaning to add (the
675709b2568f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96482
diff changeset
228 default), remove, or reset the tags. E.g.:
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
229
96506
675709b2568f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96482
diff changeset
230 tags 123 + wontfix
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
231
106845
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
232 ** URL shortcuts
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
233
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
234 http://debbugs.gnu.org/...
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
235
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
236 123 # given bug number
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
237 123;mbox=yes # mbox version of given bug
107943
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
238 package # bugs in given package
106845
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
239 from:submitter@email.address
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
240 severity:severity # all bugs of given severity
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
241 tag:tag # all bugs with given tag
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
242
106337
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
243 ** Usertags
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
244
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
245 See <http://wiki.debian.org/bugs.debian.org/usertags>
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
246
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
247 "Usertags" are very similar to tags: a set of labels that can be added
106969
5824bdf04287 Small fixes.
Glenn Morris <rgm@gnu.org>
parents: 106968
diff changeset
248 to a bug. There are two differences between normal tags and user tags:
106337
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
249
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
250 1) Anyone can define any valid usertag they like. In contrast, only a
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
251 limited, predefined set of normal tags are available (see above).
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
252
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
253 2) A usertag is associated with a specific email address.
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
254
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
255 You set usertags in the same way as tags, by talking to the control
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
256 server. One difference is that you can also specify the associated
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
257 email address. If you don't explicitly specify an address, then it
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
258 will use the one from which you send the control message. The address
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
259 must have the form of an email address (with an "@" sign and least 4
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
260 characters after the "@").
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
261
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
262 *** Setting usertags
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
263
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
264 a) In a control message:
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
265
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
266 user bug-gnu-emacs@gnu.org
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
267 usertags 1234 any-tag-you-like
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
268
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
269 This will add a usertag "any-tag-you-like" to bug 1234. The tag will
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
270 be associated with the address "bug-gnu-emacs@gnu.org". If you omit
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
271 the first line, the tag will be associated with your email address.
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
272
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
273 The syntax of the usertags command is the same as that of tags (eg wrt
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
274 the optional [=+-] argument).
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
275
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
276 b) In an initial submission, in the pseudo-header:
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
277
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
278 User: bug-gnu-emacs@gnu.org
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
279 Usertags: a-new-tag
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
280
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
281 Again, the "User" is optional.
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
282
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
283 *** Searching by usertags
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
284
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
285 The search interface is not as advanced as for normal tags. You need
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
286 to construct the relevant url yourself rather than just typing in a
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
287 search box. The only piece you really need to add is the "users"
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
288 portion, the rest has the same syntax as normal.
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
289
107943
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
290 **** To browse bugs by usertag:
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
291 http://debbugs.gnu.org/cgi/pkgindex.cgi?indexon=users
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
292
106337
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
293 **** To find all bugs usertagged by a given email address:
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
294
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
295 http://debbugs.gnu.org/cgi/pkgreport.cgi?users=bug-gnu-emacs@gnu.org
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
296
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
297 (Supposedly, the "users" field can be a comma-separated list of more
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
298 than one email address, but it does not seem to work for me.)
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
299
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
300 **** To find bugs tagged with a specific usertag:
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
301
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
302 This works just like a normal tags search, but with the addition of a
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
303 "users" field. Eg:
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
304
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
305 http://debbugs.gnu.org/cgi/pkgreport.cgi?users=bug-gnu-emacs@gnu.org;tag=calendar
eb3324922415 Mention usertags.
Glenn Morris <rgm@gnu.org>
parents: 106113
diff changeset
306
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
307 *** To merge bugs:
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
308 Eg when bad replies create a bunch of new bugs for the same report.
104535
31a925451502 How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents: 102558
diff changeset
309 Bugs must all be in the same state (e.g. same package(s) and severity
31a925451502 How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents: 102558
diff changeset
310 -- see `reassign' and `severity' below), but need not have the same
31a925451502 How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents: 102558
diff changeset
311 tags (tags are merged). E.g.:
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
312
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
313 merge 123 124 125 ...
96389
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
314
97989
bf6ada3c3ee8 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97973
diff changeset
315 Note that merging does not affect titles. In particular, a "retitle"
bf6ada3c3ee8 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97973
diff changeset
316 of merged bugs only affects individual bugs, not all of them.
bf6ada3c3ee8 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97973
diff changeset
317
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
318 *** Forcing a merge:
97989
bf6ada3c3ee8 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97973
diff changeset
319 Like `merge', but bugs need not be in the same state. The packages
104535
31a925451502 How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents: 102558
diff changeset
320 must still match though (see `reassign' below). The first one listed
31a925451502 How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents: 102558
diff changeset
321 is the master. E.g.:
96469
40d413a9e07b *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96468
diff changeset
322
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
323 forcemerge 123 124 125 ...
96469
40d413a9e07b *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96468
diff changeset
324
100191
56005ec017c3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 98568
diff changeset
325 Note: you cannot merge with an archived bug - you must unarchive it first.
56005ec017c3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 98568
diff changeset
326
97713
5f641e3c827d *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96506
diff changeset
327 *** To unmerge bugs:
5f641e3c827d *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96506
diff changeset
328 To disconnect a bug from all bugs it is merged with:
5f641e3c827d *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96506
diff changeset
329
5f641e3c827d *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96506
diff changeset
330 unmerge 123
5f641e3c827d *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96506
diff changeset
331
5f641e3c827d *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96506
diff changeset
332 This command accepts only one bug number.
5f641e3c827d *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96506
diff changeset
333
98523
2bd72d98abe8 Mention cloning.
Glenn Morris <rgm@gnu.org>
parents: 98513
diff changeset
334 *** To clone bugs:
2bd72d98abe8 Mention cloning.
Glenn Morris <rgm@gnu.org>
parents: 98513
diff changeset
335 Useful when one report refers to more than one bug.
2bd72d98abe8 Mention cloning.
Glenn Morris <rgm@gnu.org>
parents: 98513
diff changeset
336
2bd72d98abe8 Mention cloning.
Glenn Morris <rgm@gnu.org>
parents: 98513
diff changeset
337 clone 123 -1 [-2 ...]
2bd72d98abe8 Mention cloning.
Glenn Morris <rgm@gnu.org>
parents: 98513
diff changeset
338 retitle -1 second bug
2bd72d98abe8 Mention cloning.
Glenn Morris <rgm@gnu.org>
parents: 98513
diff changeset
339 retitle -2 third bug
2bd72d98abe8 Mention cloning.
Glenn Morris <rgm@gnu.org>
parents: 98513
diff changeset
340
2bd72d98abe8 Mention cloning.
Glenn Morris <rgm@gnu.org>
parents: 98513
diff changeset
341 The negative numbers provide a way to refer to the cloned bugs (which
2bd72d98abe8 Mention cloning.
Glenn Morris <rgm@gnu.org>
parents: 98513
diff changeset
342 will be assigned proper numbers).
2bd72d98abe8 Mention cloning.
Glenn Morris <rgm@gnu.org>
parents: 98513
diff changeset
343
101763
9268e7d84955 Can't clone a merged bug.
Glenn Morris <rgm@gnu.org>
parents: 101597
diff changeset
344 NB you cannot clone a merged bug. You'd think that trying to do so
9268e7d84955 Can't clone a merged bug.
Glenn Morris <rgm@gnu.org>
parents: 101597
diff changeset
345 would just give you an unmerged copy of the specified bug number, but no:
9268e7d84955 Can't clone a merged bug.
Glenn Morris <rgm@gnu.org>
parents: 101597
diff changeset
346
9268e7d84955 Can't clone a merged bug.
Glenn Morris <rgm@gnu.org>
parents: 101597
diff changeset
347 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=474742
9268e7d84955 Can't clone a merged bug.
Glenn Morris <rgm@gnu.org>
parents: 101597
diff changeset
348
9268e7d84955 Can't clone a merged bug.
Glenn Morris <rgm@gnu.org>
parents: 101597
diff changeset
349 You must unmerge, clone, then re-merge.
9268e7d84955 Can't clone a merged bug.
Glenn Morris <rgm@gnu.org>
parents: 101597
diff changeset
350
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
351 *** To set severity:
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
352 severity 123 critical|grave|serious|important|normal|minor|wishlist
96389
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
353
106610
033513eeca72 emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents: 106337
diff changeset
354 See http://debbugs.gnu.org/Developer#severities for the meanings.
96447
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
355
97931
5c4b2431ff57 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97782
diff changeset
356 *** To set the owner of a bug:
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
357 owner 123 A Hacker <none@example.com>
96447
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
358
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
359 The shorthand `!' means your own address.
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
360
97931
5c4b2431ff57 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97782
diff changeset
361 *** To remove the owner of a bug:
5c4b2431ff57 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97782
diff changeset
362 noowner 123
5c4b2431ff57 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97782
diff changeset
363
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
364 *** To mark a bug as fixed in a particular version:
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
365 fixed 123 23.0.60
96447
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
366
96506
675709b2568f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96482
diff changeset
367 *** To remove a "fixed" mark:
675709b2568f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96482
diff changeset
368 notfixed 123 23.0.60
675709b2568f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96482
diff changeset
369
104535
31a925451502 How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents: 102558
diff changeset
370 *** To assign or reassign a bug to a package or list of packages:
107943
0ddcd935235c * admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents: 107493
diff changeset
371 reassign 1234 emacs
104535
31a925451502 How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents: 102558
diff changeset
372
96482
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
373 ** To remove spam from the tracker, move it to the `spam' pseudo-package:
33f362ef6010 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96469
diff changeset
374 reassign 123 spam
97753
dc98fbae8129 Add retitle, submitter.
Glenn Morris <rgm@gnu.org>
parents: 97713
diff changeset
375
dc98fbae8129 Add retitle, submitter.
Glenn Morris <rgm@gnu.org>
parents: 97713
diff changeset
376 ** To change the title of a bug:
dc98fbae8129 Add retitle, submitter.
Glenn Morris <rgm@gnu.org>
parents: 97713
diff changeset
377 retitle 123 Some New Title
dc98fbae8129 Add retitle, submitter.
Glenn Morris <rgm@gnu.org>
parents: 97713
diff changeset
378
dc98fbae8129 Add retitle, submitter.
Glenn Morris <rgm@gnu.org>
parents: 97713
diff changeset
379 ** To change the submitter address:
dc98fbae8129 Add retitle, submitter.
Glenn Morris <rgm@gnu.org>
parents: 97713
diff changeset
380 submitter 123 none@example.com
97782
cb78e0393bd9 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97753
diff changeset
381
cb78e0393bd9 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97753
diff changeset
382 Note that it does not seem to work to specify "Submitter:" in the
cb78e0393bd9 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 97753
diff changeset
383 pseudo-header when first reporting a bug.
100967
2897f8b17f00 Mention archiving.
Glenn Morris <rgm@gnu.org>
parents: 100191
diff changeset
384
2897f8b17f00 Mention archiving.
Glenn Morris <rgm@gnu.org>
parents: 100191
diff changeset
385 ** How does archiving work?
2897f8b17f00 Mention archiving.
Glenn Morris <rgm@gnu.org>
parents: 100191
diff changeset
386 You can still send mail to a bug after it is closed. After 28 days with
2897f8b17f00 Mention archiving.
Glenn Morris <rgm@gnu.org>
parents: 100191
diff changeset
387 no activity, the bug is archived, at which point no more changes can
2897f8b17f00 Mention archiving.
Glenn Morris <rgm@gnu.org>
parents: 100191
diff changeset
388 be made. If you try to send mail to the bug after that (or merge with
2897f8b17f00 Mention archiving.
Glenn Morris <rgm@gnu.org>
parents: 100191
diff changeset
389 it), it will be rejected. To make any changes, you must unarchive it first:
2897f8b17f00 Mention archiving.
Glenn Morris <rgm@gnu.org>
parents: 100191
diff changeset
390
2897f8b17f00 Mention archiving.
Glenn Morris <rgm@gnu.org>
parents: 100191
diff changeset
391 unarchive 123
2897f8b17f00 Mention archiving.
Glenn Morris <rgm@gnu.org>
parents: 100191
diff changeset
392
2897f8b17f00 Mention archiving.
Glenn Morris <rgm@gnu.org>
parents: 100191
diff changeset
393 The bug will be re-archived after the next 28 day period of no activity.
101312
9dea7f9ad305 Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents: 101299
diff changeset
394
9dea7f9ad305 Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents: 101299
diff changeset
395 ** The web-page with the list of bugs is slow to load
9dea7f9ad305 Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents: 101299
diff changeset
396
9dea7f9ad305 Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents: 101299
diff changeset
397 It's a function of the number of displayed bugs. You can speed things
9dea7f9ad305 Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents: 101299
diff changeset
398 up by only looking at the newest 100 bugs:
106610
033513eeca72 emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents: 106337
diff changeset
399 http://debbugs.gnu.org/cgi-bin/pkgreport.cgi?newest=100;package=emacs
101312
9dea7f9ad305 Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents: 101299
diff changeset
400
106845
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
401 Or use the static index:
eb0820fd350a Some more pointless updates.
Glenn Morris <rgm@gnu.org>
parents: 106628
diff changeset
402 http://debbugs.gnu.org/db/ix/full.html
101949
3d4ab04238a6 Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents: 101763
diff changeset
403
107042
fb827ff9ec83 Explain mbox folder links.
Glenn Morris <rgm@gnu.org>
parents: 107018
diff changeset
404 ** What are those "mbox folder" links on the bug report pages?
fb827ff9ec83 Explain mbox folder links.
Glenn Morris <rgm@gnu.org>
parents: 107018
diff changeset
405
fb827ff9ec83 Explain mbox folder links.
Glenn Morris <rgm@gnu.org>
parents: 107018
diff changeset
406 "mbox folder" = messages as they arrived at the tracker
fb827ff9ec83 Explain mbox folder links.
Glenn Morris <rgm@gnu.org>
parents: 107018
diff changeset
407
fb827ff9ec83 Explain mbox folder links.
Glenn Morris <rgm@gnu.org>
parents: 107018
diff changeset
408 "status mbox" = as above, but with a fake message at the start
fb827ff9ec83 Explain mbox folder links.
Glenn Morris <rgm@gnu.org>
parents: 107018
diff changeset
409 summarizing the bug status
fb827ff9ec83 Explain mbox folder links.
Glenn Morris <rgm@gnu.org>
parents: 107018
diff changeset
410
fb827ff9ec83 Explain mbox folder links.
Glenn Morris <rgm@gnu.org>
parents: 107018
diff changeset
411 "maintainer mbox" = messages as sent out from the tracker to the
fb827ff9ec83 Explain mbox folder links.
Glenn Morris <rgm@gnu.org>
parents: 107018
diff changeset
412 maintainers (ie, bug-gnu-emacs). These have some changed headers
fb827ff9ec83 Explain mbox folder links.
Glenn Morris <rgm@gnu.org>
parents: 107018
diff changeset
413 (Resent-*, Subject, etc).
fb827ff9ec83 Explain mbox folder links.
Glenn Morris <rgm@gnu.org>
parents: 107018
diff changeset
414
107078
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
415 ** What do the pkgreport.cgi sort options mean?
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
416
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
417 "normal" = by open/closed status, then severity, then tag, then bug number
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
418
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
419 "oldview" = as above, but without the tag part
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
420
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
421 "age" = as normal, but sort in decreasing order of last modification
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
422 time, rather than by increasing bug number
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
423
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
424 "raw" = ?
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
425
102558
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
426 ** ChangeLog issues
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
427
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
428 *** When you fix a bug, it can be helpful to put the bug number in the
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
429 ChangeLog entry, for example:
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
430
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
431 * foo.el (foofunc): Fix the `foo' case. (Bug#123)
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
432
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
433 Then the relevant bug can be found for easy reference. If it's an
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
434 obvious fix (e.g. a typo), there's no need to clutter the log with the
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
435 bug number.
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
436
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
437 Similarly, when you close a bug, it can be helpful to include the
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
438 relevant ChangeLog entry in the message to the bug tracker, so people
106967
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
439 can see exactly what the fix was.
102558
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
440
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
441 *** bug-reference-mode
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
442
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
443 Activate `bug-reference-mode' in ChangeLogs to get clickable links to
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
444 the bug web-pages.
47e37f294247 Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents: 102276
diff changeset
445
106113
d1444d6e526a *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 106005
diff changeset
446 *** Debian stuff
d1444d6e526a *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 106005
diff changeset
447
d1444d6e526a *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 106005
diff changeset
448 http://lists.gnu.org/archive/html/emacs-devel/2009-11/msg00440.html
d1444d6e526a *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 106005
diff changeset
449
106967
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
450 ** Bazaar stuff
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
451
106969
5824bdf04287 Small fixes.
Glenn Morris <rgm@gnu.org>
parents: 106968
diff changeset
452 *** You can use `bzr commit --fixes emacs:123' to mark that a commit fixes
107018
ee105028fee8 Add some details of bzr's --fixes option.
Glenn Morris <rgm@gnu.org>
parents: 106995
diff changeset
453 Emacs bug 123. You will first need to add a line to your bazaar.conf:
106967
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
454
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
455 bugtracker_emacs_url = http://debbugs.gnu.org/{id}
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
456
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
457 Note that all this does is add some metadata to the commit, it doesn't
107018
ee105028fee8 Add some details of bzr's --fixes option.
Glenn Morris <rgm@gnu.org>
parents: 106995
diff changeset
458 actually mark the bug as closed in the tracker. There seems to be no
ee105028fee8 Add some details of bzr's --fixes option.
Glenn Morris <rgm@gnu.org>
parents: 106995
diff changeset
459 way to see this "metadata" with `bzr log', which is rather poor, but
ee105028fee8 Add some details of bzr's --fixes option.
Glenn Morris <rgm@gnu.org>
parents: 106995
diff changeset
460 it will show up as a link in a recent loggerhead installation, or with
ee105028fee8 Add some details of bzr's --fixes option.
Glenn Morris <rgm@gnu.org>
parents: 106995
diff changeset
461 some of the graphical frontends to bzr log.
106967
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
462
101949
3d4ab04238a6 Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents: 101763
diff changeset
463 ** Gnus-specific voodoo
3d4ab04238a6 Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents: 101763
diff changeset
464
3d4ab04238a6 Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents: 101763
diff changeset
465 *** Put point on a bug-number and try: M-x gnus-read-ephemeral-emacs-bug-group
3d4ab04238a6 Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents: 101763
diff changeset
466
3d4ab04238a6 Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents: 101763
diff changeset
467 *** If the above is not available:
3d4ab04238a6 Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents: 101763
diff changeset
468 (add-hook 'gnus-article-mode-hook
3d4ab04238a6 Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents: 101763
diff changeset
469 (lambda ()
106610
033513eeca72 emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents: 106337
diff changeset
470 (setq bug-reference-url-format "http://debbugs.gnu.org/%s")
101949
3d4ab04238a6 Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents: 101763
diff changeset
471 (bug-reference-mode 1)))
3d4ab04238a6 Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents: 101763
diff changeset
472
3d4ab04238a6 Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents: 101763
diff changeset
473 and you can click on the bug number in the subject header.
106627
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
474
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
475
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
476 * Technical Notes
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
477
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
478 The following are technical notes on how it works. These are just for
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
479 reference, you don't need to read these as a user of the system.
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
480
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
481 Getting mail from the Emacs bug list into the tracker requires the
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
482 assistance of sysadmin at gnu.org. The test tracker set-up was, I
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
483 think, [gnu.org #359140]:
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
484 http://lists.gnu.org/archive/html/savannah-hackers/2008-03/msg00074.html
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
485 http://lists.gnu.org/archive/html/savannah-hackers/2008-04/msg00034.html
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
486
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
487 ** The debbugs.gnu.org setup was handled in [gnu.org #510605].
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
488 There are two pieces (replace AT with @ in the following):
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
489
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
490 i) fencepost has an /etc/aliases entry:
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
491 emacs-pretest-bug: submit AT debbugs.gnu.org
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
492
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
493 ii) An exim router:
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
494 emacsbugs_router:
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
495 driver = redirect
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
496 senders = !Debian-debbugs AT debbugs.gnu.org
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
497 local_parts = bug-gnu-emacs
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
498 domains = gnu.org
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
499 data = submit AT debbugs.gnu.org
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
500
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
501 This says, for mail arriving at bug-gnu-emacs, only allow it through
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
502 to the list if it was sent from debbugs.gnu.org. Otherwise, send
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
503 it to the submit address at the bug-tracker.
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
504
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
505 FIXME There's probably an issue with the mail-news gateway here that
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
506 still needs to be addressed (bug#936).
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
507
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
508 ** fencepost's /etc/exim4/local_domains configuration needs a line
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
509 !debbugs.gnu.org adding [gnu.org #503532]. Otherwise people on
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
510 fencepost can't report bugs, since *.gnu.org addresses are assumed to
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
511 be handled locally on fencepost, unless otherwise specified.
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
512
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
513 ** All mail arriving at debbugs.gnu.org is first run through SpamAssassin.
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
514 Obvious spam is rejected, the rest is sent on to the moderated list
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
515 debbugs-submit. Approved mail is passed on to the tracker.
106628
30345c2102a5 Comment on out-of-sequence messages.
Glenn Morris <rgm@gnu.org>
parents: 106627
diff changeset
516 (Note this means that messages may appear out of sequence in the
30345c2102a5 Comment on out-of-sequence messages.
Glenn Morris <rgm@gnu.org>
parents: 106627
diff changeset
517 tracker, since mail from whitelisted senders goes straight through.)
106627
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
518
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
519 NOTE: An alternative to this would be to use listhelper AT nongnu.org
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
520 as a moderator address. Eg the emacs-bug-tracker list uses this.
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
521 It does basic spam processing on the moderator requests and
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
522 automatically rejects the obviously bogus ones. Someone still has to
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
523 accept the good ones though. The advantage of this would not be having
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
524 to run and tune our own spam filter. See
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
525 http://savannah.nongnu.org/projects/listhelper
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
526
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
527 An "X-Debbugs-Envelope-To" header is used to keep track of where the
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
528 mail was actually bound for:
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
529 http://lists.gnu.org/archive/html/emacs-devel/2009-11/msg01211.html
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
530
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
531 ** Mailing list recipient/sender filters.
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
532 The following mailman filters are useful to stop messages being
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
533 needlessly held for moderation:
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
534
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
535 *** debbugs-submit
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
536 (quiet|control|submit)@(debbugs\.gnu\.org|emacsbugs\.donarmstrong\.com)
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
537 [0-9]+(-done|-quiet|-subscribe)?@(debbugs\.gnu\.org|emacsbugs\.donarmstrong\.com)
106971
9fa45b0cc7d9 Add the aliases bug-emacs and bug-gnumacs.
Glenn Morris <rgm@gnu.org>
parents: 106969
diff changeset
538 (bug-gnu-emacs|emacs-pretest-bug|bug-(e|gnu)macs)@gnu\.org
9fa45b0cc7d9 Add the aliases bug-emacs and bug-gnumacs.
Glenn Morris <rgm@gnu.org>
parents: 106969
diff changeset
539
9fa45b0cc7d9 Add the aliases bug-emacs and bug-gnumacs.
Glenn Morris <rgm@gnu.org>
parents: 106969
diff changeset
540 bug-emacs and bug-gnumacs are lesser-used aliases from fencepost's
9fa45b0cc7d9 Add the aliases bug-emacs and bug-gnumacs.
Glenn Morris <rgm@gnu.org>
parents: 106969
diff changeset
541 /etc/aliases file.
106627
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
542
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
543 *** emacs-bug-tracker
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
544 sender: bug-gnu-emacs AT gnu.org
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
545 recipient: emacs-bug-tracker AT debbugs\.gnu\.org
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
546
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
547 The latter is because that is the address that debbugs actually sends to.
3aeebdcf4921 Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents: 106626
diff changeset
548 An /etc/aliases entry redirects it to the real emacs-bug-tracker address.
106967
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
549
107078
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
550 ** Recovering from moderation mistakes
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
551
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
552 All discarded messages are stored in /var/lib/mailman/spam.
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
553 If a non-spam message accidentally gets discarded, just do:
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
554
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
555 cat /var/lib/mailman/spam/not-really-spam.msg | /usr/lib/debbugs/receive
108748
85d6810f63ed * admin/notes/bugtracker: More about recovering from moderation mistakes.
Glenn Morris <rgm@gnu.org>
parents: 107943
diff changeset
556 chown Debian-debbugs:Debian-debbugs /var/lib/debbugs/spool/incoming/*
107078
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
557 ... check it works ...
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
558 mv /var/lib/mailman/spam/not-really-spam.msg /var/lib/mailman/not-spam/
2343eacdeb7d Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents: 107042
diff changeset
559
108748
85d6810f63ed * admin/notes/bugtracker: More about recovering from moderation mistakes.
Glenn Morris <rgm@gnu.org>
parents: 107943
diff changeset
560 Also check that the sender was not added to the auto-discard/reject list
85d6810f63ed * admin/notes/bugtracker: More about recovering from moderation mistakes.
Glenn Morris <rgm@gnu.org>
parents: 107943
diff changeset
561 in the debbugs-submit Mailman interface.
85d6810f63ed * admin/notes/bugtracker: More about recovering from moderation mistakes.
Glenn Morris <rgm@gnu.org>
parents: 107943
diff changeset
562
106967
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
563 ** Administrivia
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
564
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
565 The debbugs-submit list should have the administrivia option off,
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
566 else it can by mistake filter out requests to subscribe to bugs.
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
567 But, this feature doesn't work anyway (see bug#5439).
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
568
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
569 ** How to test changes
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
570
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
571 Add an entry to /etc/debbugs/Maintainers like:
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
572
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
573 mytest my.email.address
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
574
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
575 Then if you do all your testing with 'Package: mytest', the resulting
721d9f911bd2 Update X-Debbugs-CC details.
Glenn Morris <rgm@gnu.org>
parents: 106845
diff changeset
576 mails should only go to your email address.