~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Martin Pool
  • Date: 2009-03-03 01:45:32 UTC
  • mto: (4070.4.5 gnu-changelog)
  • mto: This revision was merged to the branch mainline in revision 4081.
  • Revision ID: mbp@sourcefrog.net-20090303014532-d223fxy97cb1og8f
Recommend setting timestamp in BranchBuilder

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