~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-03-28 06:58:22 UTC
  • mfrom: (2379.2.3 hpss-chroot)
  • Revision ID: pqm@pqm.ubuntu.com-20070328065822-999550a858a3ced3
(robertc) Fix chroot urls to not expose the url of the transport they are protecting, allowing regular url operations to work on them. (Robert Collins, Andrew Bennetts)

Show diffs side-by-side

added added

removed removed

Lines of Context:
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 you may prefer them over the text-based command.
35