Mercurial > emacs
annotate admin/notes/bugtracker @ 106971:9fa45b0cc7d9
Add the aliases bug-emacs and bug-gnumacs.
author | Glenn Morris <rgm@gnu.org> |
---|---|
date | Sun, 24 Jan 2010 12:28:50 -0800 |
parents | 5824bdf04287 |
children | 001a0729d255 |
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 |
106971
9fa45b0cc7d9
Add the aliases bug-emacs and bug-gnumacs.
Glenn Morris <rgm@gnu.org>
parents:
106969
diff
changeset
|
47 "\\(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
|
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 |
106969 | 62 in the subsequent discussion will end up creating a new bug. |
63 This is 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 | |
106969 | 191 to a bug. There are two differences between normal tags and user tags: |
106337 | 192 |
193 1) Anyone can define any valid usertag they like. In contrast, only a | |
194 limited, predefined set of normal tags are available (see above). | |
195 | |
196 2) A usertag is associated with a specific email address. | |
197 | |
198 You set usertags in the same way as tags, by talking to the control | |
199 server. One difference is that you can also specify the associated | |
200 email address. If you don't explicitly specify an address, then it | |
201 will use the one from which you send the control message. The address | |
202 must have the form of an email address (with an "@" sign and least 4 | |
203 characters after the "@"). | |
204 | |
205 *** Setting usertags | |
206 | |
207 a) In a control message: | |
208 | |
209 user bug-gnu-emacs@gnu.org | |
210 usertags 1234 any-tag-you-like | |
211 | |
212 This will add a usertag "any-tag-you-like" to bug 1234. The tag will | |
213 be associated with the address "bug-gnu-emacs@gnu.org". If you omit | |
214 the first line, the tag will be associated with your email address. | |
215 | |
216 The syntax of the usertags command is the same as that of tags (eg wrt | |
217 the optional [=+-] argument). | |
218 | |
219 b) In an initial submission, in the pseudo-header: | |
220 | |
221 User: bug-gnu-emacs@gnu.org | |
222 Usertags: a-new-tag | |
223 | |
224 Again, the "User" is optional. | |
225 | |
226 *** Searching by usertags | |
227 | |
228 The search interface is not as advanced as for normal tags. You need | |
229 to construct the relevant url yourself rather than just typing in a | |
230 search box. The only piece you really need to add is the "users" | |
231 portion, the rest has the same syntax as normal. | |
232 | |
233 **** To find all bugs usertagged by a given email address: | |
234 | |
235 http://debbugs.gnu.org/cgi/pkgreport.cgi?users=bug-gnu-emacs@gnu.org | |
236 | |
237 (Supposedly, the "users" field can be a comma-separated list of more | |
238 than one email address, but it does not seem to work for me.) | |
239 | |
240 **** To find bugs tagged with a specific usertag: | |
241 | |
242 This works just like a normal tags search, but with the addition of a | |
243 "users" field. Eg: | |
244 | |
245 http://debbugs.gnu.org/cgi/pkgreport.cgi?users=bug-gnu-emacs@gnu.org;tag=calendar | |
246 | |
96482 | 247 *** To merge bugs: |
248 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
|
249 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
|
250 -- 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
|
251 tags (tags are merged). E.g.: |
95505 | 252 |
96482 | 253 merge 123 124 125 ... |
96389 | 254 |
97989 | 255 Note that merging does not affect titles. In particular, a "retitle" |
256 of merged bugs only affects individual bugs, not all of them. | |
257 | |
96482 | 258 *** Forcing a merge: |
97989 | 259 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
|
260 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
|
261 is the master. E.g.: |
96469 | 262 |
96482 | 263 forcemerge 123 124 125 ... |
96469 | 264 |
100191 | 265 Note: you cannot merge with an archived bug - you must unarchive it first. |
266 | |
97713 | 267 *** To unmerge bugs: |
268 To disconnect a bug from all bugs it is merged with: | |
269 | |
270 unmerge 123 | |
271 | |
272 This command accepts only one bug number. | |
273 | |
98523 | 274 *** To clone bugs: |
275 Useful when one report refers to more than one bug. | |
276 | |
277 clone 123 -1 [-2 ...] | |
278 retitle -1 second bug | |
279 retitle -2 third bug | |
280 | |
281 The negative numbers provide a way to refer to the cloned bugs (which | |
282 will be assigned proper numbers). | |
283 | |
101763 | 284 NB you cannot clone a merged bug. You'd think that trying to do so |
285 would just give you an unmerged copy of the specified bug number, but no: | |
286 | |
287 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=474742 | |
288 | |
289 You must unmerge, clone, then re-merge. | |
290 | |
96482 | 291 *** To set severity: |
292 severity 123 critical|grave|serious|important|normal|minor|wishlist | |
96389 | 293 |
106610
033513eeca72
emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents:
106337
diff
changeset
|
294 See http://debbugs.gnu.org/Developer#severities for the meanings. |
96447 | 295 |
97931 | 296 *** To set the owner of a bug: |
96482 | 297 owner 123 A Hacker <none@example.com> |
96447 | 298 |
299 The shorthand `!' means your own address. | |
300 | |
97931 | 301 *** To remove the owner of a bug: |
302 noowner 123 | |
303 | |
96482 | 304 *** To mark a bug as fixed in a particular version: |
305 fixed 123 23.0.60 | |
96447 | 306 |
96506 | 307 *** To remove a "fixed" mark: |
308 notfixed 123 23.0.60 | |
309 | |
104535
31a925451502
How to reassign a bug to a list of packages.
Eli Zaretskii <eliz@gnu.org>
parents:
102558
diff
changeset
|
310 *** 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
|
311 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
|
312 |
96482 | 313 ** To remove spam from the tracker, move it to the `spam' pseudo-package: |
314 reassign 123 spam | |
97753 | 315 |
316 ** To change the title of a bug: | |
317 retitle 123 Some New Title | |
318 | |
319 ** To change the submitter address: | |
320 submitter 123 none@example.com | |
97782 | 321 |
322 Note that it does not seem to work to specify "Submitter:" in the | |
323 pseudo-header when first reporting a bug. | |
100967 | 324 |
325 ** How does archiving work? | |
326 You can still send mail to a bug after it is closed. After 28 days with | |
327 no activity, the bug is archived, at which point no more changes can | |
328 be made. If you try to send mail to the bug after that (or merge with | |
329 it), it will be rejected. To make any changes, you must unarchive it first: | |
330 | |
331 unarchive 123 | |
332 | |
333 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
|
334 |
9dea7f9ad305
Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents:
101299
diff
changeset
|
335 ** 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
|
336 |
9dea7f9ad305
Mention limiting number of bugs displayed on web-page.
Glenn Morris <rgm@gnu.org>
parents:
101299
diff
changeset
|
337 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
|
338 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
|
339 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
|
340 |
106845 | 341 Or use the static index: |
342 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
|
343 |
102558
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
344 ** ChangeLog issues |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
345 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
346 *** 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
|
347 ChangeLog entry, for example: |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
348 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
349 * foo.el (foofunc): Fix the `foo' case. (Bug#123) |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
350 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
351 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
|
352 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
|
353 bug number. |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
354 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
355 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
|
356 relevant ChangeLog entry in the message to the bug tracker, so people |
106967 | 357 can see exactly what the fix was. |
102558
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
358 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
359 *** bug-reference-mode |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
360 |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
361 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
|
362 the bug web-pages. |
47e37f294247
Mention some ChangeLog issues.
Glenn Morris <rgm@gnu.org>
parents:
102276
diff
changeset
|
363 |
106113 | 364 *** Debian stuff |
365 | |
366 http://lists.gnu.org/archive/html/emacs-devel/2009-11/msg00440.html | |
367 | |
106967 | 368 ** Bazaar stuff |
369 | |
106969 | 370 *** You can use `bzr commit --fixes emacs:123' to mark that a commit fixes |
106967 | 371 Emacs bug 123. You will first need to add a line to your bazaar.conf |
372 (untested): | |
373 | |
374 bugtracker_emacs_url = http://debbugs.gnu.org/{id} | |
375 | |
376 Note that all this does is add some metadata to the commit, it doesn't | |
377 actually mark the bug as closed in the tracker. | |
378 | |
101949
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
379 ** Gnus-specific voodoo |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
380 |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
381 *** 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
|
382 |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
383 *** If the above is not available: |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
384 (add-hook 'gnus-article-mode-hook |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
385 (lambda () |
106610
033513eeca72
emacsbugs.donarmstrong.com -> debbugs.gnu.org throughout.
Glenn Morris <rgm@gnu.org>
parents:
106337
diff
changeset
|
386 (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
|
387 (bug-reference-mode 1))) |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
388 |
3d4ab04238a6
Add some gnus stuff from emacs-devel.
Glenn Morris <rgm@gnu.org>
parents:
101763
diff
changeset
|
389 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
|
390 |
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 * Technical Notes |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
393 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
394 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
|
395 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
|
396 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
397 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
|
398 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
|
399 think, [gnu.org #359140]: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
400 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
|
401 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
|
402 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
403 ** 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
|
404 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
|
405 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
406 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
|
407 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
|
408 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
409 ii) An exim router: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
410 emacsbugs_router: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
411 driver = redirect |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
412 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
|
413 local_parts = bug-gnu-emacs |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
414 domains = gnu.org |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
415 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
|
416 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
417 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
|
418 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
|
419 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
|
420 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
421 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
|
422 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
|
423 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
424 ** 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
|
425 !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
|
426 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
|
427 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
|
428 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
429 ** 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
|
430 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
|
431 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
|
432 (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
|
433 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
|
434 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
435 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
|
436 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
|
437 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
|
438 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
|
439 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
|
440 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
|
441 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
|
442 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
443 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
|
444 mail was actually bound for: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
445 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
|
446 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
447 ** Mailing list recipient/sender filters. |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
448 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
|
449 needlessly held for moderation: |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
450 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
451 *** debbugs-submit |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
452 (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
|
453 [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
|
454 (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
|
455 |
9fa45b0cc7d9
Add the aliases bug-emacs and bug-gnumacs.
Glenn Morris <rgm@gnu.org>
parents:
106969
diff
changeset
|
456 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
|
457 /etc/aliases file. |
106627
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
458 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
459 *** emacs-bug-tracker |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
460 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
|
461 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
|
462 |
3aeebdcf4921
Add some notes on the debbugs.gnu.org setup.
Glenn Morris <rgm@gnu.org>
parents:
106626
diff
changeset
|
463 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
|
464 An /etc/aliases entry redirects it to the real emacs-bug-tracker address. |
106967 | 465 |
466 ** Administrivia | |
467 | |
468 The debbugs-submit list should have the administrivia option off, | |
469 else it can by mistake filter out requests to subscribe to bugs. | |
470 But, this feature doesn't work anyway (see bug#5439). | |
471 | |
472 ** How to test changes | |
473 | |
474 Add an entry to /etc/debbugs/Maintainers like: | |
475 | |
476 mytest my.email.address | |
477 | |
478 Then if you do all your testing with 'Package: mytest', the resulting | |
479 mails should only go to your email address. |