Mercurial > emacs
annotate admin/notes/bugtracker @ 110410:f2e111723c3a
Merge changes made in Gnus trunk.
Reimplement nnimap, and do tweaks to the rest of the code to support that.
* gnus-int.el (gnus-finish-retrieve-group-infos)
(gnus-retrieve-group-data-early): New functions.
* gnus-range.el (gnus-range-nconcat): New function.
* gnus-start.el (gnus-get-unread-articles): Support early retrieval of
data.
(gnus-read-active-for-groups): Support finishing the early retrieval of
data.
* gnus-sum.el (gnus-summary-move-article): Pass the move-to group name
if the move is internal, so that nnimap can do fast internal moves.
* gnus.el (gnus-article-special-mark-lists): Add uid/active tuples, for
nnimap usage.
* nnimap.el: Rewritten.
* nnmail.el (nnmail-inhibit-default-split-group): New internal variable
to allow the mail splitting to not return a default group. This is
useful for nnimap, which will leave unmatched mail in the inbox.
* utf7.el (utf7-encode): Autoload.
Implement shell connection.
* nnimap.el (nnimap-open-shell-stream): New function.
(nnimap-open-connection): Use it.
Get the number of lines by using BODYSTRUCTURE.
(nnimap-transform-headers): Get the number of lines in each message.
(nnimap-retrieve-headers): Query for BODYSTRUCTURE so that we get the
number of lines.
Not all servers return UIDNEXT. Work past this problem.
Remove junk from end of file.
Fix typo in "bogus" section.
Make capabilties be case-insensitive.
Require cl when compiling.
Don't bug out if the LIST command doesn't have any parameters.
2010-09-17 Knut Anders Hatlen <kahatlen@gmail.com> (tiny change)
* nnimap.el (nnimap-get-groups): Don't bug out if the LIST command
doesn't have any parameters.
(mm-text-html-renderer): Document gnus-article-html.
2010-09-17 Julien Danjou <julien@danjou.info> (tiny fix)
* mm-decode.el (mm-text-html-renderer): Document gnus-article-html.
* dgnushack.el: Define netrc-credentials.
If the user doesn't have a /etc/services, supply some sensible port defaults.
Have `unseen-or-unread' select an unread unseen article first.
(nntp-open-server): Return whether the open was successful or not.
Throughout all files, replace (save-excursion (set-buffer ...)) with (with-current-buffer ... ).
Save result so that it doesn't say "failed" all the time.
Add ~/.authinfo to the default, since that's probably most useful for users.
Don't use the "finish" method when we're reading from the agent.
Add some more nnimap-relevant agent stuff to nnagent.el.
* nnimap.el (nnimap-with-process-buffer): Removed.
Revert one line that was changed by mistake in the last checkin.
(nnimap-open-connection): Don't error out when we can't make a connection
nnimap-related changes to avoid bugging out if we can't contact a server.
* gnus-start.el (gnus-get-unread-articles): Don't try to scan groups
from methods that are denied.
* nnimap.el (nnimap-possibly-change-group): Return nil if we can't log
in.
(nnimap-finish-retrieve-group-infos): Make sure we're not waiting for
nothing.
* gnus-sum.el (gnus-select-newsgroup): Indent.
author | Katsumi Yamaoka <yamaoka@jpl.org> |
---|---|
date | Sat, 18 Sep 2010 10:02:19 +0000 |
parents | f82a793ed06b |
children | 0d62b248cade |
rev | line source |
---|---|
95505 | 1 NOTES ON THE EMACS BUG TRACKER -*- outline -*- |
95445 | 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 | 4 |
106995 | 5 * Quick-start guide |
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 | 8 |
9 ** How do I report a bug? | |
10 Use M-x report-emacs-bug, or send mail to bug-gnu-emacs@gnu.org. | |
11 If you want to Cc someone, use an "X-Debbugs-CC" header instead. | |
12 | |
13 ** How do I comment on a bug? | |
14 Reply to a mail on the bug-gnu-emacs list in the normal way. | |
15 Or send a mail to 123@debbugs.gnu.org. | |
16 | |
17 If the bug is old and closed, you may have to unarchive it first. | |
18 Send a mail to control@debbugs.gnu.org with | |
19 unarchive 123 | |
20 on the first line of the body. | |
21 | |
22 ** How do I close a bug? | |
23 Send a mail to 123-done@debbugs.gnu.org. In the body, explain | |
24 why the bug is being closed. | |
25 | |
26 ** How do I set bug meta-data? | |
27 By mailing commands to control@debbugs.gnu.org. Place commands at the | |
28 start of the message body, one per line. | |
29 | |
30 severity 123 serious|important|normal|minor|wishlist | |
31 tags 123 moreinfo|unreproducible|wontfix|patch | |
32 | |
33 * More detailed information | |
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 | 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 | 43 |
97973 | 44 ** How do I report a bug in Emacs now? |
45 The same way as you always did. Send mail to bug-gnu-emacs@gnu.org, | |
46 or use M-x report-emacs-bug. | |
47 | |
48 The only differences are: | |
49 | |
50 i) Your report will be assigned a number and generate an automatic reply. | |
51 | |
52 ii) Optionally, you can set some database parameters when you first | |
53 report a bug (see "Setting bug parameters" below). | |
54 | |
98568 | 55 iii) If you want to CC: someone, use X-Debbugs-CC: (this is important; |
56 see below). | |
97973 | 57 |
58 Once your report is filed and assigned a number, it is sent out to the | |
59 bug mailing list. In some cases, it may be appropriate to just file a | |
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 | 62 |
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 | 65 of the bug you are interested in. NB this only sends mail to the |
66 bug-list, it does NOT (?) send a CC to the original bug submitter. | |
67 So you need to explicitly CC him/her (and anyone else you like). | |
68 | |
69 (Many people think the submitter SHOULD be automatically subscribed | |
70 to subsequent discussion, but this does not seem to be implemented. | |
71 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=37078) | |
106967 | 72 See also http://debbugs.gnu.org/5439 |
98513 | 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 | 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 | 91 |
96482 | 92 ** When reporting a bug, to send a Cc to another address |
98568 | 93 (e.g. bug-cc-mode@gnu.org), do NOT just use a Cc: header. |
96482 | 94 Instead, use "X-Debbugs-CC:". This ensures the Cc address will get a |
98568 | 95 mail with the bug report number in. If you do not do this, each reply |
106969 | 96 in the subsequent discussion will end up creating a new bug. |
97 This is annoying. | |
95486 | 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 | 102 If a new report contains X-Debbugs-CC in the input, this is |
103 converted to a real Cc header in the output. (See Bug#1720). | |
104 It is also merged into the Resent-CC header (see below). | |
102276 | 105 |
106 ** How does Debbugs send out mails? | |
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 | 116 |
117 Mails arriving at the bug list have the following Resent-* headers: | |
118 | |
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 | 121 Resent-CC: maintainer email address, plus any X-Debbugs-CC: entries |
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 | 124 |
95505 | 125 ** To not get acknowledgement mail from the tracker, |
98513 | 126 add an "X-Debbugs-No-Ack:" header (with any value). If you use Gnus, |
127 you can add an element to gnus-posting-styles to do this automatically, eg: | |
128 | |
129 ("gnu-emacs\\(-pretest\\)?-bug" | |
130 ("X-Debbugs-No-Ack" "yes")) | |
131 | |
132 (adjust the regexp according to the name you use for the bug lists) | |
95486 | 133 |
96467 | 134 ** To record a bug in the tracker without sending mail to the bug list. |
135 This can be useful to make a note of something discussed on | |
96468 | 136 emacs-devel that needs fixing. In other words, this can be the |
137 equivalent of adding something to FOR-RELEASE. | |
96467 | 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 | 140 [headers end] |
141 Package: emacs | |
142 Version: 23.0.60 | |
143 Severity: minor | |
144 | |
145 Remember to fix FOO, as discussed on emacs-devel at http://... . | |
146 | |
96401 | 147 ** Not interested in tracker control messages (tags being set, etc)? |
148 Discard mails matching: | |
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 | 151 |
108915
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
152 ** Not receiving messages in response to your control commands? |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
153 The messages debbugs sends out in response to control-server commands |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
154 always have headers To: your@email, and Cc: tracker@debbugs.gnu.org |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
155 (the latter is an alias for the emacs-bug-tracker mailing list). |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
156 These are also the addresses to which a copy of the response is sent. |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
157 (In general, there need not be any relation between the To: and Cc: |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
158 headers visible in a message and where debbugs actually sends it.) |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
159 If you used an X-Debbugs-No-Ack header, however, a copy is _not_ sent |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
160 to you, but the To: header is unchanged. If you are subscribed to the |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
161 emacs-bug-tracker mailing list and have duplicate suppression turned |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
162 on, the presence of your address in the To: header will cause Mailman |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
163 to not send you a list copy, because it thinks you have received a |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
164 direct copy. If you used X-Debbugs-No-Ack, this is not the case, and |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
165 you won't get any copy at all. If this bothers you, don't use both |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
166 X-Debbugs-No-Ack and Mailman duplicate suppression for the |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
167 emacs-bug-tracker mailing list, just pick one or the other. |
f82a793ed06b
* admin/notes/bugtracker: Note on some emacs-bug-tracker minutiae.
Glenn Morris <rgm@gnu.org>
parents:
108748
diff
changeset
|
168 |
96401 | 169 ** How to avoid multiple copies of mails. |
106967 | 170 If you reply to reports in the normal way, this should work fine. |
171 Basically, reply only to the numbered bug address (and any individual | |
172 people's addresses). Do not send mail direct to bug-gnu-emacs or | |
173 emacs-pretest-bug unless you are reporting a new bug. | |
96401 | 174 |
95505 | 175 ** To close bug #123 (for example), send mail |
95486 | 176 |
106610
033513eeca72
emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents:
106337
diff
changeset
|
177 To: 123-done@debbugs.gnu.org |
95445 | 178 |
179 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
|
180 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
|
181 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
|
182 duplicate mail. |
95445 | 183 |
106995 | 184 ** Details of closing a bug. |
185 (For information only) | |
186 Sending a mail to 123-done does the following: | |
187 | |
188 1) Mark the bug as closed in the database. | |
189 | |
190 2) Send a mail to the original submitter telling them that their bug | |
191 has been closed. This mail has a header: | |
192 | |
107493
883859fd8369
* bugtracker: Debbugs's X-Emacs mail headers are now X-GNU headers.
Glenn Morris <rgm@gnu.org>
parents:
107078
diff
changeset
|
193 X-GNU-PR-Message: they-closed 123 |
106995 | 194 |
195 3) Send a mail to you and to the emacs-bug-tracker list confirming | |
196 that the bug has been closed. This mail has a header: | |
197 | |
107493
883859fd8369
* bugtracker: Debbugs's X-Emacs mail headers are now X-GNU headers.
Glenn Morris <rgm@gnu.org>
parents:
107078
diff
changeset
|
198 X-GNU-PR-Message: closed 123 |
106995 | 199 |
200 4) Send a copy of your mail to the bug-gnu-emacs list in exactly the | |
201 same way as if you had sent mail to "123" (sans -done). This mail has | |
202 headers: | |
203 | |
107493
883859fd8369
* bugtracker: Debbugs's X-Emacs mail headers are now X-GNU headers.
Glenn Morris <rgm@gnu.org>
parents:
107078
diff
changeset
|
204 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
|
205 Mail-Followup-To: 123@debbugs.gnu.org, person-who-closed |
106995 | 206 |
207 (This is Emacs-specific. Normally the bug list gets the same mail as in 3). | |
208 | |
96482 | 209 ** Setting bug parameters. |
210 There are two ways to set the parameters of bugs in the database | |
211 (tags, severity level, etc). When you report a new bug, you can | |
212 provide a "pseudo-header" at the start of the report, eg: | |
95445 | 213 |
96482 | 214 Package: emacs |
215 Version: 23.0.60 | |
216 Severity: minor | |
95505 | 217 |
107943
0ddcd935235c
* admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents:
107493
diff
changeset
|
218 This can also include tags. Some things (e.g. submitter) don't seem to |
97782 | 219 work here. |
220 | |
106610
033513eeca72
emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents:
106337
diff
changeset
|
221 Otherwise, send mail to the control server, control@debbugs.gnu.org. |
96482 | 222 At the start of the message body, supply the desired commands, one per |
223 line: | |
95505 | 224 |
96482 | 225 command bug-number [arguments] |
226 ... | |
227 quit|stop|thank|thanks|thankyou|thank you | |
95473 | 228 |
96482 | 229 The control server ignores anything after the last line above. So you |
230 can place control commands at the beginning of a reply to a bug | |
96506 | 231 report, and Bcc: the control server (note the commands have no effect |
232 if you just send them to the bug-report number). Bcc: is better than Cc: | |
233 in case people use Reply-to-All in response. | |
95473 | 234 |
96482 | 235 Some useful control commands: |
236 | |
237 *** To reopen a closed bug: | |
238 reopen 123 | |
239 | |
240 *** Bugs can be tagged in various ways (eg wontfix, patch, etc). | |
96506 | 241 The available tags are: |
242 patch wontfix moreinfo unreproducible fixed notabug | |
106845 | 243 See http://debbugs.gnu.org/Developer#tags |
96506 | 244 The list of tags can be prefixed with +, - or =, meaning to add (the |
245 default), remove, or reset the tags. E.g.: | |
95445 | 246 |
96506 | 247 tags 123 + wontfix |
95505 | 248 |
106845 | 249 ** URL shortcuts |
250 | |
251 http://debbugs.gnu.org/... | |
252 | |
253 123 # given bug number | |
254 123;mbox=yes # mbox version of given bug | |
107943
0ddcd935235c
* admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents:
107493
diff
changeset
|
255 package # bugs in given package |
106845 | 256 from:submitter@email.address |
257 severity:severity # all bugs of given severity | |
258 tag:tag # all bugs with given tag | |
259 | |
106337 | 260 ** Usertags |
261 | |
262 See <http://wiki.debian.org/bugs.debian.org/usertags> | |
263 | |
264 "Usertags" are very similar to tags: a set of labels that can be added | |
106969 | 265 to a bug. There are two differences between normal tags and user tags: |
106337 | 266 |
267 1) Anyone can define any valid usertag they like. In contrast, only a | |
268 limited, predefined set of normal tags are available (see above). | |
269 | |
270 2) A usertag is associated with a specific email address. | |
271 | |
272 You set usertags in the same way as tags, by talking to the control | |
273 server. One difference is that you can also specify the associated | |
274 email address. If you don't explicitly specify an address, then it | |
275 will use the one from which you send the control message. The address | |
276 must have the form of an email address (with an "@" sign and least 4 | |
277 characters after the "@"). | |
278 | |
279 *** Setting usertags | |
280 | |
281 a) In a control message: | |
282 | |
283 user bug-gnu-emacs@gnu.org | |
284 usertags 1234 any-tag-you-like | |
285 | |
286 This will add a usertag "any-tag-you-like" to bug 1234. The tag will | |
287 be associated with the address "bug-gnu-emacs@gnu.org". If you omit | |
288 the first line, the tag will be associated with your email address. | |
289 | |
290 The syntax of the usertags command is the same as that of tags (eg wrt | |
291 the optional [=+-] argument). | |
292 | |
293 b) In an initial submission, in the pseudo-header: | |
294 | |
295 User: bug-gnu-emacs@gnu.org | |
296 Usertags: a-new-tag | |
297 | |
298 Again, the "User" is optional. | |
299 | |
300 *** Searching by usertags | |
301 | |
302 The search interface is not as advanced as for normal tags. You need | |
303 to construct the relevant url yourself rather than just typing in a | |
304 search box. The only piece you really need to add is the "users" | |
305 portion, the rest has the same syntax as normal. | |
306 | |
107943
0ddcd935235c
* admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents:
107493
diff
changeset
|
307 **** To browse bugs by usertag: |
0ddcd935235c
* admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents:
107493
diff
changeset
|
308 http://debbugs.gnu.org/cgi/pkgindex.cgi?indexon=users |
0ddcd935235c
* admin/notes/bugtracker: Minor updates.
Glenn Morris <rgm@gnu.org>
parents:
107493
diff
changeset
|
309 |
106337 | 310 **** To find all bugs usertagged by a given email address: |
311 | |
312 http://debbugs.gnu.org/cgi/pkgreport.cgi?users=bug-gnu-emacs@gnu.org | |
313 | |
314 (Supposedly, the "users" field can be a comma-separated list of more | |
315 than one email address, but it does not seem to work for me.) | |
316 | |
317 **** To find bugs tagged with a specific usertag: | |
318 | |
319 This works just like a normal tags search, but with the addition of a | |
320 "users" field. Eg: | |
321 | |
322 http://debbugs.gnu.org/cgi/pkgreport.cgi?users=bug-gnu-emacs@gnu.org;tag=calendar | |
323 | |
96482 | 324 *** To merge bugs: |
325 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
|
326 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
|
327 -- 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
|
328 tags (tags are merged). E.g.: |
95505 | 329 |
96482 | 330 merge 123 124 125 ... |
96389 | 331 |
97989 | 332 Note that merging does not affect titles. In particular, a "retitle" |
333 of merged bugs only affects individual bugs, not all of them. | |
334 | |
96482 | 335 *** Forcing a merge: |
97989 | 336 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
|
337 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
|
338 is the master. E.g.: |
96469 | 339 |
96482 | 340 forcemerge 123 124 125 ... |
96469 | 341 |
100191 | 342 Note: you cannot merge with an archived bug - you must unarchive it first. |
343 | |
97713 | 344 *** To unmerge bugs: |
345 To disconnect a bug from all bugs it is merged with: | |
346 | |
347 unmerge 123 | |
348 | |
349 This command accepts only one bug number. | |
350 | |
98523 | 351 *** To clone bugs: |
352 Useful when one report refers to more than one bug. | |
353 | |
354 clone 123 -1 [-2 ...] | |
355 retitle -1 second bug | |
356 retitle -2 third bug | |
357 | |
358 The negative numbers provide a way to refer to the cloned bugs (which | |
359 will be assigned proper numbers). | |
360 | |
101763 | 361 NB you cannot clone a merged bug. You'd think that trying to do so |
362 would just give you an unmerged copy of the specified bug number, but no: | |
363 | |
364 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=474742 | |
365 | |
366 You must unmerge, clone, then re-merge. | |
367 | |
96482 | 368 *** To set severity: |
369 severity 123 critical|grave|serious|important|normal|minor|wishlist | |
96389 | 370 |
106610
033513eeca72
emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents:
106337
diff
changeset
|
371 See http://debbugs.gnu.org/Developer#severities for the meanings. |
96447 | 372 |
97931 | 373 *** To set the owner of a bug: |
96482 | 374 owner 123 A Hacker <none@example.com> |
96447 | 375 |
376 The shorthand `!' means your own address. | |
377 | |
97931 | 378 *** To remove the owner of a bug: |
379 noowner 123 | |
380 | |
96482 | 381 *** To mark a bug as fixed in a particular version: |
382 fixed 123 23.0.60 | |
96447 | 383 |
96506 | 384 *** To remove a "fixed" mark: |
385 notfixed 123 23.0.60 | |
386 | |
104535
31a925451502
How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents:
102558
diff
changeset
|
387 *** 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
|
388 reassign 1234 emacs |
104535
31a925451502
How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents:
102558
diff
changeset
|
389 |
96482 | 390 ** To remove spam from the tracker, move it to the `spam' pseudo-package: |
391 reassign 123 spam | |
97753 | 392 |
393 ** To change the title of a bug: | |
394 retitle 123 Some New Title | |
395 | |
396 ** To change the submitter address: | |
397 submitter 123 none@example.com | |
97782 | 398 |
399 Note that it does not seem to work to specify "Submitter:" in the | |
400 pseudo-header when first reporting a bug. | |
100967 | 401 |
402 ** How does archiving work? | |
403 You can still send mail to a bug after it is closed. After 28 days with | |
404 no activity, the bug is archived, at which point no more changes can | |
405 be made. If you try to send mail to the bug after that (or merge with | |
406 it), it will be rejected. To make any changes, you must unarchive it first: | |
407 | |
408 unarchive 123 | |
409 | |
410 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
|
411 |
9dea7f9ad305
Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents:
101299
diff
changeset
|
412 ** 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
|
413 |
9dea7f9ad305
Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents:
101299
diff
changeset
|
414 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
|
415 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
|
416 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
|
417 |
106845 | 418 Or use the static index: |
419 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
|
420 |
107042 | 421 ** What are those "mbox folder" links on the bug report pages? |
422 | |
423 "mbox folder" = messages as they arrived at the tracker | |
424 | |
425 "status mbox" = as above, but with a fake message at the start | |
426 summarizing the bug status | |
427 | |
428 "maintainer mbox" = messages as sent out from the tracker to the | |
429 maintainers (ie, bug-gnu-emacs). These have some changed headers | |
430 (Resent-*, Subject, etc). | |
431 | |
107078
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
432 ** What do the pkgreport.cgi sort options mean? |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
433 |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
434 "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
|
435 |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
436 "oldview" = as above, but without the tag part |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
437 |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
438 "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
|
439 time, rather than by increasing bug number |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
440 |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
441 "raw" = ? |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
442 |
102558
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
443 ** ChangeLog issues |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
444 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
445 *** 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
|
446 ChangeLog entry, for example: |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
447 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
448 * foo.el (foofunc): Fix the `foo' case. (Bug#123) |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
449 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
450 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
|
451 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
|
452 bug number. |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
453 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
454 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
|
455 relevant ChangeLog entry in the message to the bug tracker, so people |
106967 | 456 can see exactly what the fix was. |
102558
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
457 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
458 *** bug-reference-mode |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
459 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
460 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
|
461 the bug web-pages. |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
462 |
106113 | 463 *** Debian stuff |
464 | |
465 http://lists.gnu.org/archive/html/emacs-devel/2009-11/msg00440.html | |
466 | |
106967 | 467 ** Bazaar stuff |
468 | |
106969 | 469 *** 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
|
470 Emacs bug 123. You will first need to add a line to your bazaar.conf: |
106967 | 471 |
472 bugtracker_emacs_url = http://debbugs.gnu.org/{id} | |
473 | |
474 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
|
475 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
|
476 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
|
477 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
|
478 some of the graphical frontends to bzr log. |
106967 | 479 |
101949
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
480 ** Gnus-specific voodoo |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
481 |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
482 *** 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
|
483 |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
484 *** If the above is not available: |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
485 (add-hook 'gnus-article-mode-hook |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
486 (lambda () |
106610
033513eeca72
emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents:
106337
diff
changeset
|
487 (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
|
488 (bug-reference-mode 1))) |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
489 |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
490 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
|
491 |
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 * Technical Notes |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
494 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
495 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
|
496 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
|
497 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
498 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
|
499 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
|
500 think, [gnu.org #359140]: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
501 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
|
502 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
|
503 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
504 ** 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
|
505 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
|
506 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
507 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
|
508 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
|
509 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
510 ii) An exim router: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
511 emacsbugs_router: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
512 driver = redirect |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
513 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
|
514 local_parts = bug-gnu-emacs |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
515 domains = gnu.org |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
516 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
|
517 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
518 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
|
519 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
|
520 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
|
521 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
522 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
|
523 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
|
524 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
525 ** 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
|
526 !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
|
527 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
|
528 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
|
529 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
530 ** 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
|
531 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
|
532 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
|
533 (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
|
534 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
|
535 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
536 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
|
537 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
|
538 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
|
539 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
|
540 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
|
541 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
|
542 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
|
543 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
544 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
|
545 mail was actually bound for: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
546 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
|
547 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
548 ** Mailing list recipient/sender filters. |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
549 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
|
550 needlessly held for moderation: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
551 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
552 *** debbugs-submit |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
553 (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
|
554 [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
|
555 (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
|
556 |
9fa45b0cc7d9
Add the aliases bug-emacs and bug-gnumacs.
Glenn Morris <rgm@gnu.org>
parents:
106969
diff
changeset
|
557 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
|
558 /etc/aliases file. |
106627
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
559 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
560 *** emacs-bug-tracker |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
561 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
|
562 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
|
563 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
564 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
|
565 An /etc/aliases entry redirects it to the real emacs-bug-tracker address. |
106967 | 566 |
107078
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
567 ** Recovering from moderation mistakes |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
568 |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
569 All discarded messages are stored in /var/lib/mailman/spam. |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
570 If a non-spam message accidentally gets discarded, just do: |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
571 |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
572 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
|
573 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
|
574 ... check it works ... |
2343eacdeb7d
Explain pkreport sort options.
Glenn Morris <rgm@gnu.org>
parents:
107042
diff
changeset
|
575 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
|
576 |
108748
85d6810f63ed
* admin/notes/bugtracker: More about recovering from moderation mistakes.
Glenn Morris <rgm@gnu.org>
parents:
107943
diff
changeset
|
577 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
|
578 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
|
579 |
106967 | 580 ** Administrivia |
581 | |
582 The debbugs-submit list should have the administrivia option off, | |
583 else it can by mistake filter out requests to subscribe to bugs. | |
584 But, this feature doesn't work anyway (see bug#5439). | |
585 | |
586 ** How to test changes | |
587 | |
588 Add an entry to /etc/debbugs/Maintainers like: | |
589 | |
590 mytest my.email.address | |
591 | |
592 Then if you do all your testing with 'Package: mytest', the resulting | |
593 mails should only go to your email address. |