changeset 96482:33f362ef6010

*** empty log message ***

--- a/admin/notes/bugtracker	Wed Jul 02 02:53:48 2008 +0000
+++ b/admin/notes/bugtracker	Wed Jul 02 03:06:02 2008 +0000
@@ -2,12 +2,12 @@
 
 The Emacs Bug Tracker can be found at http://emacsbugs.donarmstrong.com/
 
-For a list of all bugs, see           http://emacsbugs.donarmstrong.com/emacs
+For a list of all bugs, see http://emacsbugs.donarmstrong.com/emacs
 
 
-** When reporting a bug, to send a Cc to another address (e.g.
[e-mail]), do not just use a Cc: header.
-Instead, use "X-Debbugs-CC:". This ensures the Cc address will get a
+** When reporting a bug, to send a Cc to another address
+(e.g. [e-mail]), do not just use a Cc: header.
+Instead, use "X-Debbugs-CC:".  This ensures the Cc address will get a
 mail with the bug report number in.
 
 ** To not get acknowledgement mail from the tracker,
@@ -43,77 +43,69 @@
 
 ** To close bug #123 (for example), send mail
 
-  To: [e-mail]
+To: [e-mail]
 
 with a brief explanation in the body as to why the bug was closed.
 
+** Setting bug parameters.
+There are two ways to set the parameters of bugs in the database
+(tags, severity level, etc).  When you report a new bug, you can
+provide a "pseudo-header" at the start of the report, eg:
 
-** To reopen a closed bug #123:
+Package: emacs
+Version: 23.0.60
+Severity: minor
 
-  To: [e-mail]
+Otherwise, send mail to the control server, [e-mail].
+At the start of the message body, supply the desired commands, one per
+line:
 
-  reopen 123
-  thanks
+command bug-number [arguments]
+...
+quit|stop|thank|thanks|thankyou|thank you
 
-** quit|stop|thank|thanks|thankyou|thank you
-On a line by itself, this tells the control server to ignore the rest of
-the message.
+The control server ignores anything after the last line above.  So you
+can place control commands at the beginning of a reply to a bug
+report, and Cc: the control server (note the commands have no effect
+if you just send them to the bug-report number).
 
-** Bugs can be tagged in various ways (eg wontfix, patch, etc).
+Some useful control commands:
+
+*** To reopen a closed bug:
+reopen 123
+
+*** Bugs can be tagged in various ways (eg wontfix, patch, etc).
 For a list of available tags, see:
 http://emacsbugs.donarmstrong.com/Developer#tags
-
-** To tag bug #123 (for example), send a mail of the form:
-
-  To: [e-mail]
-
-  tags 123 wontfix
-  thanks
-
-Or just add the
+The tag can be prefixed with +, - or =, meaning to add (the default),
+remove, or reset the tags.  E.g.:
 
-  tags 123 wontfix
-  thanks
+tags 123 +wontfix
 
-at the beginning of a reply.  The tag can be prefixed with +, - or =,
-meaning to add (the default), remove, or reset the tags.
-
-** To remove spam from the tracker, move it to the `spam' pseudo-package:
-
-  To: [e-mail]
+*** To merge bugs:
+Eg when bad replies create a bunch of new bugs for the same report.
+Bugs must all be in the same state, but need not have the same tags.  E.g.:
 
-  reassign 123 spam
-  thanks
-
-** To merge bugs:
-Eg when bad replies create a bunch of new bugs for the same report.
-Bugs must all be in the same state, but need not have the same tags.
-
-  To: [e-mail]
-  merge 123 124 125 ...
+merge 123 124 125 ...
 
-** Forcing a merge:
+*** Forcing a merge:
 Like `merge', but bugs need not be in the same state.  The first one
-listed is the master.
+listed is the master.  E.g.:
 
-  To: [e-mail]
-  forcemerge 123 124 125 ...
+forcemerge 123 124 125 ...
 
-** To set severity:
-
-  To: [e-mail]
-  severity 123 critical|grave|serious|important|normal|minor|wishlist
+*** To set severity:
+severity 123 critical|grave|serious|important|normal|minor|wishlist
 
 See http://emacsbugs.donarmstrong.com/Developer#severities for the meanings.
 
-** To set the onwer of a bug:
-
-  To: [e-mail]
-  owner 123 A Hacker <[e-mail]>
+*** To set the onwer of a bug:
+owner 123 A Hacker <[e-mail]>
 
 The shorthand `!' means your own address.
 
-** To mark a bug as fixed in a particular version:
+*** To mark a bug as fixed in a particular version:
+fixed 123 23.0.60
 
-  To: [e-mail]
-  fixed 123 23.0.60
+** To remove spam from the tracker, move it to the `spam' pseudo-package:
+reassign 123 spam