~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Vincent Ladeuil
  • Date: 2008-01-29 15:16:31 UTC
  • mto: (3206.1.1 trunk)
  • mto: This revision was merged to the branch mainline in revision 3207.
  • Revision ID: v.ladeuil+lp@free.fr-20080129151631-vqjd13tb405mobx6
Fix two more leaking tmp dirs, by reworking TransformPreview lock handling.

* bzrlib/tests/test_transform.py:
(TestTransformMerge): Revert previous patch and cleanly call
preview.finalize now that we can.

* bzrlib/tests/test_merge.py:
(TestMerge.test_make_preview_transform): Catch TransformPreview
leak.

* bzrlib/builtins.py:
(cmd_merge._do_preview): Finalize the TransformPreview or the
limbodir will stay in /tmp.

* bzrlib/transform.py:
(TreeTransformBase.__init__): Create the _deletiondir since it's
reffered to by finalize.
(TreeTransformBase.finalize): Delete the dir only if _deletiondir
is set.
(TreeTransform.__init__): Use a temp var for deletiondir and set
the attribute after the base class __init__ has been called.
(TransformPreview.__init__): Read locks the tree since finalize
wants to unlock it (as suggested by Aaron).

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 they are often preferred over the text-based command by users.
 
35