~bzr-pqm/bzr/bzr.dev

Annotating changes

==================

Seeing the origin of content

----------------------------

When two or more people are working on files, it can be highly

useful at times to see who created or last changed certain content.

To do this, using the annotate command like this::

  bzr annotate readme.txt

If you are a pessimist or an optimist, you might prefer to use

one of built-in aliases for ``annotate``: ``blame`` or ``praise``.

Either way, this displays each line of the file together with

information such as:

 * who changed it last

 * when it was last changed

 * the commit message.

GUI tools

---------

The various GUI plugins for Bazaar provide graphical tools for

viewing annotation information. For example, the bzr-gtk plugin

provides a GUI tool for this that can be launched using the

``gannotate`` command::

  bzr gannotate readme.txt

The GUI tools typically provide a much richer display of

interesting information (e.g. all the changes in each commit)

so you may prefer them over the text-based command.