aboutsummaryrefslogtreecommitdiffstats
path: root/admin/notes/bugtracker
diff options
context:
space:
mode:
Diffstat (limited to 'admin/notes/bugtracker')
-rw-r--r--admin/notes/bugtracker60
1 files changed, 11 insertions, 49 deletions
diff --git a/admin/notes/bugtracker b/admin/notes/bugtracker
index 7947b17973b..fb65bbe4330 100644
--- a/admin/notes/bugtracker
+++ b/admin/notes/bugtracker
@@ -334,7 +334,7 @@ http://debbugs.gnu.org/cgi/pkgreport.cgi?users=emacs;tag=calendar
334*** To merge bugs: 334*** To merge bugs:
335Eg when bad replies create a bunch of new bugs for the same report. 335Eg when bad replies create a bunch of new bugs for the same report.
336Bugs must all be in the same state (e.g. same package(s) and severity 336Bugs must all be in the same state (e.g. same package(s) and severity
337-- see `reassign' and `severity' below), but need not have the same 337-- see 'reassign' and 'severity' below), but need not have the same
338tags (tags are merged). E.g.: 338tags (tags are merged). E.g.:
339 339
340merge 123 124 125 ... 340merge 123 124 125 ...
@@ -343,8 +343,8 @@ Note that merging does not affect titles. In particular, a "retitle"
343of merged bugs only affects individual bugs, not all of them. 343of merged bugs only affects individual bugs, not all of them.
344 344
345*** Forcing a merge: 345*** Forcing a merge:
346Like `merge', but bugs need not be in the same state. The packages 346Like 'merge', but bugs need not be in the same state. The packages
347must still match though (see `reassign' below). The first one listed 347must still match though (see 'reassign' below). The first one listed
348is the master. E.g.: 348is the master. E.g.:
349 349
350forcemerge 123 124 125 ... 350forcemerge 123 124 125 ...
@@ -383,7 +383,7 @@ See http://debbugs.gnu.org/Developer#severities for the meanings.
383*** To set the owner of a bug: 383*** To set the owner of a bug:
384owner 123 A Hacker <none@example.com> 384owner 123 A Hacker <none@example.com>
385 385
386The shorthand `!' means your own address. 386The shorthand '!' means your own address.
387 387
388*** To remove the owner of a bug: 388*** To remove the owner of a bug:
389noowner 123 389noowner 123
@@ -408,7 +408,7 @@ reassign 1234 emacs
408Note that reassigning clears the list of found versions, even if the 408Note that reassigning clears the list of found versions, even if the
409new packages includes the original one. 409new packages includes the original one.
410 410
411** To remove spam from the tracker, move it to the `spam' pseudo-package: 411** To remove spam from the tracker, move it to the 'spam' pseudo-package:
412reassign 123 spam 412reassign 123 spam
413 413
414(Should not be necessary any more, now that the input is moderated.) 414(Should not be necessary any more, now that the input is moderated.)
@@ -463,68 +463,30 @@ time, rather than by increasing bug number
463 463
464"raw" = ? 464"raw" = ?
465 465
466** ChangeLog issues 466** Change log issues
467 467
468*** When you fix a bug, it can be helpful to put the bug number in the 468*** When you fix a bug, it can be helpful to put the bug number in the
469ChangeLog entry, for example: 469change log entry, for example:
470 470
471 * foo.el (foofunc): Fix the `foo' case. (Bug#123) 471 * lisp/menu-bar.el (menu-set-font): Doc fix. (Bug#21303)
472 472
473Then the relevant bug can be found for easy reference. If it's an 473Then the relevant bug can be found for easy reference. If it's an
474obvious fix (e.g. a typo), there's no need to clutter the log with the 474obvious fix (e.g., a typo), there's no need to clutter the log with the
475bug number. 475bug number.
476 476
477Similarly, when you close a bug, it can be helpful to include the 477Similarly, when you close a bug, it can be helpful to include the
478relevant ChangeLog entry in the message to the bug tracker, so people 478relevant change log entry in the message to the bug tracker, so people
479can see exactly what the fix was. 479can see exactly what the fix was.
480 480
481*** bug-reference-mode 481*** bug-reference-mode
482 482
483Activate `bug-reference-mode' in ChangeLogs to get clickable links to 483Activate 'bug-reference-mode' in ChangeLogs to get clickable links to
484the bug web-pages. 484the bug web-pages.
485 485
486*** Debian stuff 486*** Debian stuff
487 487
488http://lists.gnu.org/archive/html/emacs-devel/2009-11/msg00440.html 488http://lists.gnu.org/archive/html/emacs-devel/2009-11/msg00440.html
489 489
490** Bazaar stuff
491
492*** You can use `bzr commit --fixes debbugs:123' to mark that a commit fixes
493Emacs bug 123. You will first need to add a line to one of your
494configuration files, ~/.bazaar/bazaar.conf or ~/.bazaar/locations.conf:
495
496bugtracker_debbugs_url = http://debbugs.gnu.org/{id}
497
498Here "{id}" is a literal string, a placeholder that will be replaced
499by the bug number you specify after `--fixes debbugs:' in the bzr
500command line (123 in the example above).
501
502In the bazaar.conf file, this setting should go into the [DEFAULT]
503section.
504
505In the locations.conf file, it should go into the branch-specific
506configuration section for the branch where you want this to be in
507effect. For example, if you want this to be in effect for the branch
508located at `/home/projects/emacs/trunk', you need to have this in your
509~/.bazaar/locations.conf file:
510
511[/home/projects/emacs/trunk]
512bugtracker_debbugs_url = http://debbugs.gnu.org/{id}
513
514If you want to use this in all Emacs branches whose common parent is
515`/home/projects/emacs', put the setting in the [/home/projects/emacs]
516section. See "bzr help configuration" for more information about
517the *.conf files, their location and formats. See "bzr help bugs" for
518more information about the bugtracker_debbugs_url setting.
519
520See also log-edit-rewrite-fixes in .dir-locals.el.
521
522Note that all this does is add some metadata to the commit, it doesn't
523actually mark the bug as closed in the tracker. You can see this
524information with `bzr log', and it will show up as a link in a recent
525loggerhead installation, or with some of the graphical frontends to
526`bzr log'.
527
528** Gnus-specific voodoo 490** Gnus-specific voodoo
529 491
530*** Put point on a bug-number and try: M-x gnus-read-ephemeral-emacs-bug-group 492*** Put point on a bug-number and try: M-x gnus-read-ephemeral-emacs-bug-group