Rev 4861: (igc) Add bug fixing to the tutorial (Patrick Regan) in file:///home/pqm/archives/thelove/bzr/%2Btrunk/

[Canonical.com Patch Queue Manager]

At file:///home/pqm/archives/thelove/bzr/%2Btrunk/

------------------------------------------------------------
revno: 4861 [merge]
revision-id: pqm at pqm.ubuntu.com-20091204071016-eo2bjtfv36jlzl5m
parent: pqm at pqm.ubuntu.com-20091204055916-0wl19q28c6n0po1e
parent: ian.clatworthy at canonical.com-20091204062136-vht9v8ebb7y4c48n
committer: Canonical.com Patch Queue Manager <pqm at pqm.ubuntu.com>
branch nick: +trunk
timestamp: Fri 2009-12-04 07:10:16 +0000
message:
  (igc) Add bug fixing to the tutorial (Patrick Regan)
modified:
  doc/en/tutorials/tutorial.txt  tutorial.txt-20050804190939-9dcbba2ef053bc84
=== modified file 'doc/en/tutorials/tutorial.txt'
--- a/doc/en/tutorials/tutorial.txt	2009-12-03 23:21:16 +0000
+++ b/doc/en/tutorials/tutorial.txt	2009-12-04 06:21:36 +0000
@@ -330,6 +330,30 @@
 commit message when you have finished. If you would like parts to be
 included in the message you can copy and paste them above the separator.
 
+Marking bugs as fixed
+---------------------
+
+Many changes to a project are as a result of fixing bugs. Bazaar can keep
+metadata about bugs you fixed when you commit them. To do this you use the
+``--fixes`` option. This option takes an argument that looks like this::
+
+    % bzr commit --fixes <tracker>:<id>
+
+Where ``<tracker>`` is an identifier for a bug tracker and ``<id>`` is an
+identifier for a bug that is tracked in that bug tracker. ``<id>`` is usually
+a number. Bazaar already knows about a few popular bug trackers. They are 
+bugs.launchpad.net, bugs.debian.org, and bugzilla.gnome.org. These trackers
+have their own identifiers: lp, deb, and gnome respectively. For example,
+if you made a change to fix the bug #1234 on bugs.launchpad.net, you would
+use the following command to commit your fix::
+
+    % bzr commit -m "fixed my first bug" --fixes lp:1234
+
+For more information on this topic or for information on how to configure
+other bug trackers please read `Bug Tracker Settings`_.
+
+.. _Bug Tracker Settings: ../user-reference/index.html#bug-tracker-settings
+
 Selective commit
 ----------------