← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/bugtracker.py

  • Committer: Andrew Bennetts
  • Date: 2010-01-13 23:16:20 UTC
  • mfrom: (4957 +trunk)
  • mto: This revision was merged to the branch mainline in revision 4960.
  • Revision ID: andrew.bennetts@canonical.com-20100113231620-n6in2yjib2v6z03g
Merge lp:bzr.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/bugtracker.py
39
39
 
40
40
_bugs_help = \
41
41
"""When making a commit, metadata about bugs fixed by that change can be
42
 
recorded by using the --fixes option. For each bug marked as fixed, an
 
42
recorded by using the ``--fixes`` option. For each bug marked as fixed, an
43
43
entry is included in the 'bugs' revision property stating '<url> <status>'.
44
44
(The only ``status`` value currently supported is ``fixed.``)
45
45
 
46
 
The --fixes option allows you to specify a bug tracker and a bug identifier
47
 
rather than a full URL. This looks like
 
46
The ``--fixes`` option allows you to specify a bug tracker and a bug identifier
 
47
rather than a full URL. This looks like::
48
48
 
49
49
    bzr commit --fixes <tracker>:<id>
50
50
 
56
56
use this feature, you just need to know the tracker identifier to use.
57
57
These are the bugtrackers that are built in:
58
58
 
59
 
    ============================= ============= ================
60
 
    URL                           Abbreviation  Example
61
 
    ============================= ============= ================
62
 
    https://bugs.launchpad.net/   lp            lp:12345
63
 
    http://bugs.debian.org/       deb           deb:12345
64
 
    http://bugzilla.gnome.org/    gnome         gnome:12345
65
 
    ============================= ============= ================
 
59
  ============================ ============ ============
 
60
  URL                          Abbreviation Example
 
61
  ============================ ============ ============
 
62
  https://bugs.launchpad.net/  lp           lp:12345
 
63
  http://bugs.debian.org/      deb          deb:12345
 
64
  http://bugzilla.gnome.org/   gnome        gnome:12345
 
65
  ============================ ============ ============
66
66
 
67
67
For the bug trackers not listed above configuration is required.
68
68
Support for generating the URLs for any project using Bugzilla or Trac
85
85
 
86
86
Use ``bzr commit --fixes lp:2`` to record that this commit fixes bug 2.
87
87
 
88
 
bugzilla_<tracker_abbreviation>_url
89
 
-----------------------------------
 
88
bugzilla_<tracker>_url
 
89
----------------------
90
90
 
91
91
If present, the location of the Bugzilla bug tracker referred to by
92
 
<tracker_abbreviation>. This option can then be used together with ``bzr commit
 
92
<tracker>. This option can then be used together with ``bzr commit
93
93
--fixes`` to mark bugs in that tracker as being fixed by that commit. For
94
94
example::
95
95
 
98
98
would allow ``bzr commit --fixes squid:1234`` to mark Squid's bug 1234 as
99
99
fixed.
100
100
 
101
 
trac_<tracker_abbrevation>_url
102
 
------------------------------
 
101
trac_<tracker>_url
 
102
------------------
103
103
 
104
104
If present, the location of the Trac instance referred to by
105
 
<tracker_abbreviation>. This option can then be used together with ``bzr commit
 
105
<tracker>. This option can then be used together with ``bzr commit
106
106
--fixes`` to mark bugs in that tracker as being fixed by that commit. For
107
107
example::
108
108
 
111
111
would allow ``bzr commit --fixes twisted:1234`` to mark Twisted's bug 1234 as
112
112
fixed.
113
113
 
114
 
bugtracker_<tracker_abbrevation>_url
115
 
------------------------------------
 
114
bugtracker_<tracker>_url
 
115
------------------------
116
116
 
117
117
If present, the location of a generic bug tracker instance referred to by
118
 
<tracker_abbreviation>. The location must contain an ``{id}`` placeholder,
 
118
<tracker>. The location must contain an ``{id}`` placeholder,
119
119
which will be replaced by a specific bug ID. This option can then be used
120
120
together with ``bzr commit --fixes`` to mark bugs in that tracker as being
121
121
fixed by that commit. For example::