/breezy/unstable

To get this branch, use:
bzr branch https://code.breezy-vcs.org/breezy/unstable

« back to all changes in this revision

Viewing changes to doc/en/user-guide/bug_trackers.txt

  • Committer: Jelmer Vernooij
  • Date: 2017-05-24 01:39:33 UTC
  • mfrom: (3815.3776.6)
  • Revision ID: jelmer@jelmer.uk-20170524013933-ir4y4tqtrsiz2ka2
New upstream snapshot.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
Bug trackers
2
2
============
3
3
 
4
 
Bazaar has a facility that allows you to associate a commit with a bug
 
4
Breezy has a facility that allows you to associate a commit with a bug
5
5
in the project's bug tracker. Other tools (or hooks) can then use this
6
6
information to generate hyperlinks between the commit and the bug, or to
7
7
automatically mark the bug closed in the branches that contain the commit.
12
12
When you make a commit, you can associate it with a bug by using the
13
13
``--fixes`` option of ``commit``. For example::
14
14
 
15
 
    $ bzr commit --fixes lp:12345 -m "Properly close the connection"
 
15
    $ brz commit --fixes lp:12345 -m "Properly close the connection"
16
16
 
17
 
This records metadata in Bazaar linking the commit with bug 12345 in
 
17
This records metadata in Breezy linking the commit with bug 12345 in
18
18
Launchpad. If you use a different bug tracker, it can be given its own
19
19
tracker code (instead of ``lp``) and used instead. For details on how
20
20
to configure this for Bugzilla, Trac, Roundup and other bug/issue trackers,
21
 
refer to `Bug Tracker Settings`_ in the Bazaar User Reference.
 
21
refer to `Bug Tracker Settings`_ in the Breezy User Reference.
22
22
 
23
23
.. _Bug Tracker Settings: ../user-reference/index.html#bug-tracker-settings
24
24
 
27
27
 
28
28
Recording metadata about bugs fixed at commit time is only
29
29
one of the features needed for complete bug tracker integration.
30
 
As Bazaar is a distributed VCS, users may be offline while committing
 
30
As Breezy is a distributed VCS, users may be offline while committing
31
31
so accessing the bug tracker itself at that time may not be possible.
32
32
Instead, it is recommended that a hook be installed to update
33
33
the bug tracker when changes are pushed to a central location
48
48
marked as fixed by one commit but that revision does not fully solve the
49
49
bug, or there is a later regression, you cannot go back and remove the link.
50
50
 
51
 
Of course, ``bzr uncommit`` can always be used to undo the last commit in
 
51
Of course, ``brz uncommit`` can always be used to undo the last commit in
52
52
order to make it again with the correct options. This is commonly done
53
53
to correct a bad commit message and it equally applies to correcting
54
54
metadata recorded (via ``--fixes`` for example) on the last commit.