annotate admin/notes/bugtracker @ 96467:2f224124246c

*** empty log message ***
author Glenn Morris <rgm@gnu.org>
date Tue, 01 Jul 2008 04:10:01 +0000
parents 12698b05a698
children 5c93e68f7620
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
1 NOTES ON THE EMACS BUG TRACKER -*- outline -*-
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
3 The Emacs Bug Tracker can be found at http://emacsbugs.donarmstrong.com/
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
5 For a list of all bugs, see http://emacsbugs.donarmstrong.com/emacs
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
8 ** When reporting a bug, to send a Cc to another address (e.g.
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
9 bug-cc-mode@gnu.org), do not just use a Cc: header.
95486
23898c5b8565 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95474
diff changeset
10 Instead, use "X-Debbugs-CC:". This ensures the Cc address will get a
23898c5b8565 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95474
diff changeset
11 mail with the bug report number in.
23898c5b8565 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95474
diff changeset
12
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
13 ** To not get acknowledgement mail from the tracker,
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
14 add an "X-Debbugs-No-Ack:" header (with any value).
95486
23898c5b8565 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95474
diff changeset
15
96467
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
16 ** To record a bug in the tracker without sending mail to the bug list.
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
17 This can be useful to make a note of something discussed on
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
18 emacs-devel that needs fixing.
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
19
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
20 To: quiet@emacsbugs.donarmstrong.com
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
21 [headers end]
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
22 Package: emacs
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
23 Version: 23.0.60
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
24 Severity: minor
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
25
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
26 Remember to fix FOO, as discussed on emacs-devel at http://... .
2f224124246c *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96447
diff changeset
27
96401
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
28 ** Not interested in tracker control messages (tags being set, etc)?
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
29 Discard mails matching:
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
30
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
31 ^X-Emacs-PR-Message: transcript
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
32
96402
7f88a1df4a80 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96401
diff changeset
33 When you close a bug, you get a message matching:
7f88a1df4a80 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96401
diff changeset
34
7f88a1df4a80 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96401
diff changeset
35 ^X-Emacs-PR-Message: closed
7f88a1df4a80 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96401
diff changeset
36
96401
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
37 ** How to avoid multiple copies of mails.
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
38 When you reply to a bug, respect the Reply-To address, ie send mail
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
39 only to the submitter address and the numbered bug address. Do not
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
40 send mail direct to bug-gnu-emacs or emacs-pretest-bug unless you are
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
41 reporting a new bug.
e29fc647bad3 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96389
diff changeset
42
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
43 ** To close bug #123 (for example), send mail
95486
23898c5b8565 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95474
diff changeset
44
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
45 To: 123-done@emacsbugs.donarmstrong.com
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
46
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
47 with a brief explanation in the body as to why the bug was closed.
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
48
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
49
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
50 ** To reopen a closed bug #123:
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
51
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
52 To: control@emacsbugs.donarmstrong.com
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
53
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
54 reopen 123
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
55 thanks
95473
762c4fbf32b0 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95446
diff changeset
56
96389
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
57 ** quit|stop|thank|thanks|thankyou|thank you
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
58 On a line by itself, this tells the control server to ignore the rest of
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
59 the message.
95473
762c4fbf32b0 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95446
diff changeset
60
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
61 ** Bugs can be tagged in various ways (eg wontfix, patch, etc).
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
62 For a list of available tags, see:
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
63 http://emacsbugs.donarmstrong.com/Developer#tags
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
64
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
65 ** To tag bug #123 (for example), send a mail of the form:
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
66
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
67 To: control@emacsbugs.donarmstrong.com
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
68
96389
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
69 tags 123 wontfix
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
70 thanks
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
71
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
72 Or just add the
95445
f93f13f7bef5 New file.
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
73
96389
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
74 tags 123 wontfix
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
75 thanks
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
76
96389
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
77 at the beginning of a reply. The tag can be prefixed with +, - or =,
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
78 meaning to add (the default), remove, or reset the tags.
95505
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
79
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
80 ** To remove spam from the tracker, move it to the `spam' pseudo-package:
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
81
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
82 To: control@emacsbugs.donarmstrong.com
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
83
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
84 reassign 123 spam
e80f4eb078ee Massage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95486
diff changeset
85 thanks
96389
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
86
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
87 ** To merge bugs:
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
88 Eg when bad replies create a bunch of new bugs for the same report.
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
89 Bugs must all be in the same state.
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
90
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
91 To: control@emacsbugs.donarmstrong.com
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
92 merge 123 124 125 ...
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
93
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
94 ** To set severity:
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
95
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
96 To: control@emacsbugs.donarmstrong.com
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
97 severity 123 critical|grave|serious|important|normal|minor|wishlist
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
98
c859b77bcd7f *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 95505
diff changeset
99 See http://emacsbugs.donarmstrong.com/Developer#severities for the meanings.
96447
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
100
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
101 ** To set the onwer of a bug:
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
102
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
103 To: control@emacsbugs.donarmstrong.com
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
104 owner 123 A Hacker <none@example.com>
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
105
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
106 The shorthand `!' means your own address.
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
107
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
108 ** To mark a bug as fixed in a particular version:
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
109
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
110 To: control@emacsbugs.donarmstrong.com
12698b05a698 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 96402
diff changeset
111 fixed 123 23.0.60