Mercurial > emacs
annotate admin/notes/bugtracker @ 106968:8c9b1893adfe
Fix some details of previous change.
author | Glenn Morris <rgm@gnu.org> |
---|---|
date | Sat, 23 Jan 2010 15:18:58 -0800 |
parents | 721d9f911bd2 |
children | 5824bdf04287 |
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 |
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
|
5 For a list of all bugs, see http://debbugs.gnu.org/db/pa/lemacs.html |
106612 | 6 This is a static page, updated once a day. There is also a dynamic |
7 list, generated on request, but since there are many bug reports this | |
8 is slow and not recommended. | |
95445 | 9 |
97973 | 10 ** How do I report a bug in Emacs now? |
11 The same way as you always did. Send mail to bug-gnu-emacs@gnu.org, | |
12 or use M-x report-emacs-bug. | |
13 | |
14 The only differences are: | |
15 | |
16 i) Your report will be assigned a number and generate an automatic reply. | |
17 | |
18 ii) Optionally, you can set some database parameters when you first | |
19 report a bug (see "Setting bug parameters" below). | |
20 | |
98568 | 21 iii) If you want to CC: someone, use X-Debbugs-CC: (this is important; |
22 see below). | |
97973 | 23 |
24 Once your report is filed and assigned a number, it is sent out to the | |
25 bug mailing list. In some cases, it may be appropriate to just file a | |
26 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
|
27 quiet@debbugs.gnu.org. |
97973 | 28 |
29 ** 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
|
30 Reply to 123@debbugs.gnu.org, replacing 123 with the number |
98513 | 31 of the bug you are interested in. NB this only sends mail to the |
32 bug-list, it does NOT (?) send a CC to the original bug submitter. | |
33 So you need to explicitly CC him/her (and anyone else you like). | |
34 | |
35 (Many people think the submitter SHOULD be automatically subscribed | |
36 to subsequent discussion, but this does not seem to be implemented. | |
37 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=37078) | |
106967 | 38 See also http://debbugs.gnu.org/5439 |
98513 | 39 |
106968
8c9b1893adfe
Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents:
106967
diff
changeset
|
40 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
|
41 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
|
42 address is to create a new report. |
95445 | 43 |
101597
fb07b238e55a
Update message-dont-reply-to-names section.
Glenn Morris <rgm@gnu.org>
parents:
101512
diff
changeset
|
44 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
|
45 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
|
46 |
fb07b238e55a
Update message-dont-reply-to-names section.
Glenn Morris <rgm@gnu.org>
parents:
101512
diff
changeset
|
47 "\\(emacs-pretest-bug\\|bug-gnu-emacs\\)@gnu\\.org\\|\ |
106626
9306e1ad9272
Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents:
106612
diff
changeset
|
48 \\(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
|
49 |
106626
9306e1ad9272
Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents:
106612
diff
changeset
|
50 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
|
51 "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
|
52 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
|
53 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
|
54 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
|
55 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
|
56 reporting.) |
100191 | 57 |
96482 | 58 ** When reporting a bug, to send a Cc to another address |
98568 | 59 (e.g. bug-cc-mode@gnu.org), do NOT just use a Cc: header. |
96482 | 60 Instead, use "X-Debbugs-CC:". This ensures the Cc address will get a |
98568 | 61 mail with the bug report number in. If you do not do this, each reply |
62 in the subsequent discussion will end up creating a new bug. This is | |
63 annoying. | |
95486 | 64 |
106967 | 65 If a new report contains X-Debbugs-CC in the input, this is |
66 converted to a real Cc header in the output. (See Bug#1720). | |
67 It is also merged into the Resent-CC header (see below). | |
102276 | 68 |
69 ** How does Debbugs send out mails? | |
70 | |
106968
8c9b1893adfe
Fix some details of previous change.
Glenn Morris <rgm@gnu.org>
parents:
106967
diff
changeset
|
71 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
|
72 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
|
73 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
|
74 "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
|
75 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
|
76 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
|
77 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
|
78 it was changed. Any X-Debbugs-CC is merged into the Cc. |
102276 | 79 |
80 Mails arriving at the bug list have the following Resent-* headers: | |
81 | |
82 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
|
83 Resent-To: owner@debbugs.gnu.org |
102276 | 84 Resent-CC: maintainer email address, plus any X-Debbugs-CC: entries |
85 | |
106626
9306e1ad9272
Update some addresses for debbugs.gnu.org.
Glenn Morris <rgm@gnu.org>
parents:
106612
diff
changeset
|
86 The "maintainer email address" is "bug-gnu-emacs@gnu.org" in most cases. |
102276 | 87 |
95505 | 88 ** To not get acknowledgement mail from the tracker, |
98513 | 89 add an "X-Debbugs-No-Ack:" header (with any value). If you use Gnus, |
90 you can add an element to gnus-posting-styles to do this automatically, eg: | |
91 | |
92 ("gnu-emacs\\(-pretest\\)?-bug" | |
93 ("X-Debbugs-No-Ack" "yes")) | |
94 | |
95 (adjust the regexp according to the name you use for the bug lists) | |
95486 | 96 |
96467 | 97 ** To record a bug in the tracker without sending mail to the bug list. |
98 This can be useful to make a note of something discussed on | |
96468 | 99 emacs-devel that needs fixing. In other words, this can be the |
100 equivalent of adding something to FOR-RELEASE. | |
96467 | 101 |
106610
033513eeca72
emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents:
106337
diff
changeset
|
102 To: quiet@debbugs.gnu.org |
96467 | 103 [headers end] |
104 Package: emacs | |
105 Version: 23.0.60 | |
106 Severity: minor | |
107 | |
108 Remember to fix FOO, as discussed on emacs-devel at http://... . | |
109 | |
96401 | 110 ** Not interested in tracker control messages (tags being set, etc)? |
111 Discard mails matching: | |
112 | |
113 ^X-Emacs-PR-Message: transcript | |
114 | |
96402 | 115 When you close a bug, you get a message matching: |
116 | |
117 ^X-Emacs-PR-Message: closed | |
118 | |
96401 | 119 ** How to avoid multiple copies of mails. |
106967 | 120 If you reply to reports in the normal way, this should work fine. |
121 Basically, reply only to the numbered bug address (and any individual | |
122 people's addresses). Do not send mail direct to bug-gnu-emacs or | |
123 emacs-pretest-bug unless you are reporting a new bug. | |
96401 | 124 |
95505 | 125 ** To close bug #123 (for example), send mail |
95486 | 126 |
106610
033513eeca72
emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents:
106337
diff
changeset
|
127 To: 123-done@debbugs.gnu.org |
95445 | 128 |
129 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
|
130 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
|
131 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
|
132 duplicate mail. |
95445 | 133 |
96482 | 134 ** Setting bug parameters. |
135 There are two ways to set the parameters of bugs in the database | |
136 (tags, severity level, etc). When you report a new bug, you can | |
137 provide a "pseudo-header" at the start of the report, eg: | |
95445 | 138 |
96482 | 139 Package: emacs |
140 Version: 23.0.60 | |
141 Severity: minor | |
95505 | 142 |
97973 | 143 Optionally, add a sub-package, eg Package: emacs,calendar. |
97782 | 144 This can include tags. Some things (e.g. submitter) don't seem to |
145 work here. | |
146 | |
106610
033513eeca72
emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents:
106337
diff
changeset
|
147 Otherwise, send mail to the control server, control@debbugs.gnu.org. |
96482 | 148 At the start of the message body, supply the desired commands, one per |
149 line: | |
95505 | 150 |
96482 | 151 command bug-number [arguments] |
152 ... | |
153 quit|stop|thank|thanks|thankyou|thank you | |
95473 | 154 |
96482 | 155 The control server ignores anything after the last line above. So you |
156 can place control commands at the beginning of a reply to a bug | |
96506 | 157 report, and Bcc: the control server (note the commands have no effect |
158 if you just send them to the bug-report number). Bcc: is better than Cc: | |
159 in case people use Reply-to-All in response. | |
95473 | 160 |
96482 | 161 Some useful control commands: |
162 | |
163 *** To reopen a closed bug: | |
164 reopen 123 | |
165 | |
166 *** Bugs can be tagged in various ways (eg wontfix, patch, etc). | |
96506 | 167 The available tags are: |
168 patch wontfix moreinfo unreproducible fixed notabug | |
106845 | 169 See http://debbugs.gnu.org/Developer#tags |
96506 | 170 The list of tags can be prefixed with +, - or =, meaning to add (the |
171 default), remove, or reset the tags. E.g.: | |
95445 | 172 |
96506 | 173 tags 123 + wontfix |
95505 | 174 |
106845 | 175 ** URL shortcuts |
176 | |
177 http://debbugs.gnu.org/... | |
178 | |
179 123 # given bug number | |
180 123;mbox=yes # mbox version of given bug | |
181 package # bugs in given package (don't use "emacs" - too many bugs!) | |
182 from:submitter@email.address | |
183 severity:severity # all bugs of given severity | |
184 tag:tag # all bugs with given tag | |
185 | |
106337 | 186 ** Usertags |
187 | |
188 See <http://wiki.debian.org/bugs.debian.org/usertags> | |
189 | |
190 "Usertags" are very similar to tags: a set of labels that can be added | |
191 to a bug. There are two differences between normal tags and user | |
192 tags: | |
193 | |
194 1) Anyone can define any valid usertag they like. In contrast, only a | |
195 limited, predefined set of normal tags are available (see above). | |
196 | |
197 2) A usertag is associated with a specific email address. | |
198 | |
199 You set usertags in the same way as tags, by talking to the control | |
200 server. One difference is that you can also specify the associated | |
201 email address. If you don't explicitly specify an address, then it | |
202 will use the one from which you send the control message. The address | |
203 must have the form of an email address (with an "@" sign and least 4 | |
204 characters after the "@"). | |
205 | |
206 *** Setting usertags | |
207 | |
208 a) In a control message: | |
209 | |
210 user bug-gnu-emacs@gnu.org | |
211 usertags 1234 any-tag-you-like | |
212 | |
213 This will add a usertag "any-tag-you-like" to bug 1234. The tag will | |
214 be associated with the address "bug-gnu-emacs@gnu.org". If you omit | |
215 the first line, the tag will be associated with your email address. | |
216 | |
217 The syntax of the usertags command is the same as that of tags (eg wrt | |
218 the optional [=+-] argument). | |
219 | |
220 b) In an initial submission, in the pseudo-header: | |
221 | |
222 User: bug-gnu-emacs@gnu.org | |
223 Usertags: a-new-tag | |
224 | |
225 Again, the "User" is optional. | |
226 | |
227 *** Searching by usertags | |
228 | |
229 The search interface is not as advanced as for normal tags. You need | |
230 to construct the relevant url yourself rather than just typing in a | |
231 search box. The only piece you really need to add is the "users" | |
232 portion, the rest has the same syntax as normal. | |
233 | |
234 **** To find all bugs usertagged by a given email address: | |
235 | |
236 http://debbugs.gnu.org/cgi/pkgreport.cgi?users=bug-gnu-emacs@gnu.org | |
237 | |
238 (Supposedly, the "users" field can be a comma-separated list of more | |
239 than one email address, but it does not seem to work for me.) | |
240 | |
241 **** To find bugs tagged with a specific usertag: | |
242 | |
243 This works just like a normal tags search, but with the addition of a | |
244 "users" field. Eg: | |
245 | |
246 http://debbugs.gnu.org/cgi/pkgreport.cgi?users=bug-gnu-emacs@gnu.org;tag=calendar | |
247 | |
96482 | 248 *** To merge bugs: |
249 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
|
250 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
|
251 -- 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
|
252 tags (tags are merged). E.g.: |
95505 | 253 |
96482 | 254 merge 123 124 125 ... |
96389 | 255 |
97989 | 256 Note that merging does not affect titles. In particular, a "retitle" |
257 of merged bugs only affects individual bugs, not all of them. | |
258 | |
96482 | 259 *** Forcing a merge: |
97989 | 260 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
|
261 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
|
262 is the master. E.g.: |
96469 | 263 |
96482 | 264 forcemerge 123 124 125 ... |
96469 | 265 |
100191 | 266 Note: you cannot merge with an archived bug - you must unarchive it first. |
267 | |
97713 | 268 *** To unmerge bugs: |
269 To disconnect a bug from all bugs it is merged with: | |
270 | |
271 unmerge 123 | |
272 | |
273 This command accepts only one bug number. | |
274 | |
98523 | 275 *** To clone bugs: |
276 Useful when one report refers to more than one bug. | |
277 | |
278 clone 123 -1 [-2 ...] | |
279 retitle -1 second bug | |
280 retitle -2 third bug | |
281 | |
282 The negative numbers provide a way to refer to the cloned bugs (which | |
283 will be assigned proper numbers). | |
284 | |
101763 | 285 NB you cannot clone a merged bug. You'd think that trying to do so |
286 would just give you an unmerged copy of the specified bug number, but no: | |
287 | |
288 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=474742 | |
289 | |
290 You must unmerge, clone, then re-merge. | |
291 | |
96482 | 292 *** To set severity: |
293 severity 123 critical|grave|serious|important|normal|minor|wishlist | |
96389 | 294 |
106610
033513eeca72
emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents:
106337
diff
changeset
|
295 See http://debbugs.gnu.org/Developer#severities for the meanings. |
96447 | 296 |
97931 | 297 *** To set the owner of a bug: |
96482 | 298 owner 123 A Hacker <none@example.com> |
96447 | 299 |
300 The shorthand `!' means your own address. | |
301 | |
97931 | 302 *** To remove the owner of a bug: |
303 noowner 123 | |
304 | |
96482 | 305 *** To mark a bug as fixed in a particular version: |
306 fixed 123 23.0.60 | |
96447 | 307 |
96506 | 308 *** To remove a "fixed" mark: |
309 notfixed 123 23.0.60 | |
310 | |
104535
31a925451502
How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents:
102558
diff
changeset
|
311 *** To assign or reassign a bug to a package or list of packages: |
31a925451502
How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents:
102558
diff
changeset
|
312 reassign 1234 emacs,cc-mode |
31a925451502
How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents:
102558
diff
changeset
|
313 |
96482 | 314 ** To remove spam from the tracker, move it to the `spam' pseudo-package: |
315 reassign 123 spam | |
97753 | 316 |
317 ** To change the title of a bug: | |
318 retitle 123 Some New Title | |
319 | |
320 ** To change the submitter address: | |
321 submitter 123 none@example.com | |
97782 | 322 |
323 Note that it does not seem to work to specify "Submitter:" in the | |
324 pseudo-header when first reporting a bug. | |
100967 | 325 |
326 ** How does archiving work? | |
327 You can still send mail to a bug after it is closed. After 28 days with | |
328 no activity, the bug is archived, at which point no more changes can | |
329 be made. If you try to send mail to the bug after that (or merge with | |
330 it), it will be rejected. To make any changes, you must unarchive it first: | |
331 | |
332 unarchive 123 | |
333 | |
334 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
|
335 |
9dea7f9ad305
Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents:
101299
diff
changeset
|
336 ** 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
|
337 |
9dea7f9ad305
Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents:
101299
diff
changeset
|
338 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
|
339 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
|
340 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
|
341 |
106845 | 342 Or use the static index: |
343 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
|
344 |
102558
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
345 ** ChangeLog issues |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
346 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
347 *** 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
|
348 ChangeLog entry, for example: |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
349 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
350 * foo.el (foofunc): Fix the `foo' case. (Bug#123) |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
351 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
352 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
|
353 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
|
354 bug number. |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
355 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
356 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
|
357 relevant ChangeLog entry in the message to the bug tracker, so people |
106967 | 358 can see exactly what the fix was. |
102558
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
359 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
360 *** bug-reference-mode |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
361 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
362 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
|
363 the bug web-pages. |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
364 |
106113 | 365 *** Debian stuff |
366 | |
367 http://lists.gnu.org/archive/html/emacs-devel/2009-11/msg00440.html | |
368 | |
106967 | 369 ** Bazaar stuff |
370 | |
371 *** You can use the commit --fixes emacs:123 to mark that a commit fixes | |
372 Emacs bug 123. You will first need to add a line to your bazaar.conf | |
373 (untested): | |
374 | |
375 bugtracker_emacs_url = http://debbugs.gnu.org/{id} | |
376 | |
377 Note that all this does is add some metadata to the commit, it doesn't | |
378 actually mark the bug as closed in the tracker. | |
379 | |
101949
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
380 ** Gnus-specific voodoo |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
381 |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
382 *** 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
|
383 |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
384 *** If the above is not available: |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
385 (add-hook 'gnus-article-mode-hook |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
386 (lambda () |
106610
033513eeca72
emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents:
106337
diff
changeset
|
387 (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
|
388 (bug-reference-mode 1))) |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
389 |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
390 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
|
391 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
392 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
393 * Technical Notes |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
394 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
395 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
|
396 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
|
397 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
398 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
|
399 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
|
400 think, [gnu.org #359140]: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
401 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
|
402 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
|
403 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
404 ** 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
|
405 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
|
406 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
407 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
|
408 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
|
409 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
410 ii) An exim router: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
411 emacsbugs_router: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
412 driver = redirect |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
413 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
|
414 local_parts = bug-gnu-emacs |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
415 domains = gnu.org |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
416 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
|
417 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
418 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
|
419 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
|
420 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
|
421 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
422 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
|
423 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
|
424 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
425 ** 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
|
426 !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
|
427 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
|
428 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
|
429 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
430 ** 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
|
431 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
|
432 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
|
433 (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
|
434 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
|
435 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
436 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
|
437 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
|
438 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
|
439 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
|
440 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
|
441 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
|
442 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
|
443 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
444 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
|
445 mail was actually bound for: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
446 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
|
447 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
448 ** Mailing list recipient/sender filters. |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
449 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
|
450 needlessly held for moderation: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
451 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
452 *** debbugs-submit |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
453 (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
|
454 [0-9]+(-done|-quiet|-subscribe)?@(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
|
455 (bug-gnu-emacs|emacs-pretest-bug)@gnu\.org |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
456 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
457 *** emacs-bug-tracker |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
458 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
|
459 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
|
460 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
461 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
|
462 An /etc/aliases entry redirects it to the real emacs-bug-tracker address. |
106967 | 463 |
464 ** Administrivia | |
465 | |
466 The debbugs-submit list should have the administrivia option off, | |
467 else it can by mistake filter out requests to subscribe to bugs. | |
468 But, this feature doesn't work anyway (see bug#5439). | |
469 | |
470 ** How to test changes | |
471 | |
472 Add an entry to /etc/debbugs/Maintainers like: | |
473 | |
474 mytest my.email.address | |
475 | |
476 Then if you do all your testing with 'Package: mytest', the resulting | |
477 mails should only go to your email address. |