← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2007-11-30 05:43:20 UTC
  • mfrom: (3054.1.1 ianc-integration)
  • Revision ID: pqm@pqm.ubuntu.com-20071130054320-b4oer0rcbiy2ouzg
Bazaar User Guide for 1.0rc (Ian Clatworthy)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/annotating_changes.txt
 
1
Annotating changes
 
2
==================
 
3
 
 
4
Seeing the origin of content
 
5
----------------------------
 
6
 
 
7
When two or more people are working on files, it can be highly
 
8
useful at times to see who created or last changed certain content.
 
9
To do this, using the annotate command like this::
 
10
 
 
11
  bzr annotate readme.txt
 
12
 
 
13
If you are a pessimist or an optimist, you might prefer to use
 
14
one of built-in aliases for ``annotate``: ``blame`` or ``praise``.
 
15
Either way, this displays each line of the file together with
 
16
information such as:
 
17
 
 
18
 * who changed it last
 
19
 * when it was last changed
 
20
 * the commit message.
 
21
 
 
22
GUI tools
 
23
---------
 
24
 
 
25
The various GUI plugins for Bazaar provide graphical tools for
 
26
viewing annotation information. For example, the bzr-gtk plugin
 
27
provides a GUI tool for this that can be launched using the
 
28
``gannotate`` command::
 
29
 
 
30
  bzr gannotate readme.txt
 
31
 
 
32
The GUI tools typically provide a much richer display of
 
33
interesting information (e.g. all the changes in each commit)
 
34
so they are often preferred over the text-based command by users.
 
35