[Emacs-diffs] /srv/bzr/emacs/emacs-23 r100202: Expand and clarify the description of bugtracker setting for bzr.

[Eli Zaretskii]

------------------------------------------------------------
revno: 100202
committer: Eli Zaretskii <address@hidden>
branch nick: emacs-23
timestamp: Fri 2010-11-12 10:37:27 +0200
message:
  Expand and clarify the description of bugtracker setting for bzr.
modified:
  admin/notes/bugtracker

=== modified file 'admin/notes/bugtracker'
--- a/admin/notes/bugtracker    2010-11-10 04:50:31 +0000
+++ b/admin/notes/bugtracker    2010-11-12 08:37:27 +0000
@@ -450,9 +450,32 @@
 ** Bazaar stuff
 
 *** You can use `bzr commit --fixes debbugs:123' to mark that a commit fixes
-Emacs bug 123.  You will first need to add a line to your bazaar.conf:
-
-bugtracker_debbugs_url = http://debbugs.gnu.org/{id}
+Emacs bug 123.  You will first need to add a line to your ~/bazaar.conf
+or ~/locations.conf:
+
+bugtracker_debbugs_url = http://debbugs.gnu.org/{id}
+
+Here "{id}" is a literal string, a placeholder that will be replaced
+by the bug number you specify after `--fixes debbugs:' in the bzr
+command line (123 in the example above).
+
+In the bazaar.conf file, this setting should go into the [DEFAULTS]
+section.
+
+In the locations.conf file, it should go into the branch-specific
+configuration section for the branch where you want this to be in
+effect.  For example, if you want this to be in effect for the branch
+located at `/home/projects/emacs/trunk', you need to have this in your
+~/locations.conf file:
+
+[/home/projects/emacs/trunk]
+bugtracker_debbugs_url = http://debbugs.gnu.org/{id}
+
+If you want to use this in all Emacs branches whose common parent is
+`/home/projects/emacs', put the setting in the [/home/projects/emacs]
+section.  See "bzr help configuration" for more information about
+the *.conf files, their location and formats.  See "bzr help bugs" for
+more information about the bugtracker_debbugs_url setting.
 
 See also log-edit-rewrite-fixes in .dir-locals.el.