diff options
Diffstat (limited to 'admin/notes/bugtracker')
| -rw-r--r-- | admin/notes/bugtracker | 60 |
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: |
| 335 | Eg when bad replies create a bunch of new bugs for the same report. | 335 | Eg when bad replies create a bunch of new bugs for the same report. |
| 336 | Bugs must all be in the same state (e.g. same package(s) and severity | 336 | Bugs 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 |
| 338 | tags (tags are merged). E.g.: | 338 | tags (tags are merged). E.g.: |
| 339 | 339 | ||
| 340 | merge 123 124 125 ... | 340 | merge 123 124 125 ... |
| @@ -343,8 +343,8 @@ Note that merging does not affect titles. In particular, a "retitle" | |||
| 343 | of merged bugs only affects individual bugs, not all of them. | 343 | of merged bugs only affects individual bugs, not all of them. |
| 344 | 344 | ||
| 345 | *** Forcing a merge: | 345 | *** Forcing a merge: |
| 346 | Like `merge', but bugs need not be in the same state. The packages | 346 | Like 'merge', but bugs need not be in the same state. The packages |
| 347 | must still match though (see `reassign' below). The first one listed | 347 | must still match though (see 'reassign' below). The first one listed |
| 348 | is the master. E.g.: | 348 | is the master. E.g.: |
| 349 | 349 | ||
| 350 | forcemerge 123 124 125 ... | 350 | forcemerge 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: |
| 384 | owner 123 A Hacker <none@example.com> | 384 | owner 123 A Hacker <none@example.com> |
| 385 | 385 | ||
| 386 | The shorthand `!' means your own address. | 386 | The shorthand '!' means your own address. |
| 387 | 387 | ||
| 388 | *** To remove the owner of a bug: | 388 | *** To remove the owner of a bug: |
| 389 | noowner 123 | 389 | noowner 123 |
| @@ -408,7 +408,7 @@ reassign 1234 emacs | |||
| 408 | Note that reassigning clears the list of found versions, even if the | 408 | Note that reassigning clears the list of found versions, even if the |
| 409 | new packages includes the original one. | 409 | new 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: |
| 412 | reassign 123 spam | 412 | reassign 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 |
| 469 | ChangeLog entry, for example: | 469 | change 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 | ||
| 473 | Then the relevant bug can be found for easy reference. If it's an | 473 | Then the relevant bug can be found for easy reference. If it's an |
| 474 | obvious fix (e.g. a typo), there's no need to clutter the log with the | 474 | obvious fix (e.g., a typo), there's no need to clutter the log with the |
| 475 | bug number. | 475 | bug number. |
| 476 | 476 | ||
| 477 | Similarly, when you close a bug, it can be helpful to include the | 477 | Similarly, when you close a bug, it can be helpful to include the |
| 478 | relevant ChangeLog entry in the message to the bug tracker, so people | 478 | relevant change log entry in the message to the bug tracker, so people |
| 479 | can see exactly what the fix was. | 479 | can see exactly what the fix was. |
| 480 | 480 | ||
| 481 | *** bug-reference-mode | 481 | *** bug-reference-mode |
| 482 | 482 | ||
| 483 | Activate `bug-reference-mode' in ChangeLogs to get clickable links to | 483 | Activate 'bug-reference-mode' in ChangeLogs to get clickable links to |
| 484 | the bug web-pages. | 484 | the bug web-pages. |
| 485 | 485 | ||
| 486 | *** Debian stuff | 486 | *** Debian stuff |
| 487 | 487 | ||
| 488 | http://lists.gnu.org/archive/html/emacs-devel/2009-11/msg00440.html | 488 | http://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 | ||
| 493 | Emacs bug 123. You will first need to add a line to one of your | ||
| 494 | configuration files, ~/.bazaar/bazaar.conf or ~/.bazaar/locations.conf: | ||
| 495 | |||
| 496 | bugtracker_debbugs_url = http://debbugs.gnu.org/{id} | ||
| 497 | |||
| 498 | Here "{id}" is a literal string, a placeholder that will be replaced | ||
| 499 | by the bug number you specify after `--fixes debbugs:' in the bzr | ||
| 500 | command line (123 in the example above). | ||
| 501 | |||
| 502 | In the bazaar.conf file, this setting should go into the [DEFAULT] | ||
| 503 | section. | ||
| 504 | |||
| 505 | In the locations.conf file, it should go into the branch-specific | ||
| 506 | configuration section for the branch where you want this to be in | ||
| 507 | effect. For example, if you want this to be in effect for the branch | ||
| 508 | located at `/home/projects/emacs/trunk', you need to have this in your | ||
| 509 | ~/.bazaar/locations.conf file: | ||
| 510 | |||
| 511 | [/home/projects/emacs/trunk] | ||
| 512 | bugtracker_debbugs_url = http://debbugs.gnu.org/{id} | ||
| 513 | |||
| 514 | If 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] | ||
| 516 | section. See "bzr help configuration" for more information about | ||
| 517 | the *.conf files, their location and formats. See "bzr help bugs" for | ||
| 518 | more information about the bugtracker_debbugs_url setting. | ||
| 519 | |||
| 520 | See also log-edit-rewrite-fixes in .dir-locals.el. | ||
| 521 | |||
| 522 | Note that all this does is add some metadata to the commit, it doesn't | ||
| 523 | actually mark the bug as closed in the tracker. You can see this | ||
| 524 | information with `bzr log', and it will show up as a link in a recent | ||
| 525 | loggerhead 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 |