/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: Martin Pool
  • Date: 2007-10-03 08:06:44 UTC
  • mto: This revision was merged to the branch mainline in revision 2901.
  • Revision ID: mbp@sourcefrog.net-20071003080644-oivy0gkg98sex0ed
Avoid internal error tracebacks on failure to lock on readonly transport (#129701).

Add new LockFailed, which doesn't imply that we failed to get it because of
contention.  Raise this if we fail to create the pending or lock directories
because of Transport errors.

UnlockableTransport is not an internal error.

ReadOnlyLockError has a message which didn't match its name or usage; it's now
deprecated and callers are updated to use LockFailed which is more appropriate.

Add zero_ninetytwo deprecation symbol.

Unify assertMatchesRe with TestCase.assertContainsRe.

When the constructor is deprecated, just say that the class is deprecated, not
the __init__ method - this works better with applyDeprecated in tests.

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