/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: John Arbash Meinel
  • Date: 2010-01-12 22:51:31 UTC
  • mto: This revision was merged to the branch mainline in revision 4955.
  • Revision ID: john@arbash-meinel.com-20100112225131-he8h411p6aeeb947
Delay grabbing an output stream until we actually go to show a diff.

This makes the test suite happy, but it also seems to be reasonable.
If we aren't going to write anything, we don't need to hold an
output stream open.

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