/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: Vincent Ladeuil
  • Date: 2009-12-15 20:32:34 UTC
  • mto: (4905.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 4906.
  • Revision ID: v.ladeuil+lp@free.fr-20091215203234-d8br6xqfq6pec40z
Move the _warn_if_deprecated call from repo.__init__ to
repo.lock_{read,write} so that branch.lock_{read,write} can call it. This
makes it possible to access locations.conf and branch.conf.

* bzrlib/tests/blackbox/test_exceptions.py:
(TestDeprecationWarning): Test that the suppress_warning
configuration variable is taken into account.

* bzrlib/repository.py:
(Repository.__init__): Delete very old and obsolete
comments. Don't warn about deprecations yet.
(Repository.lock_write, Repository.lock_read): The repo is about
to be locked, check deprecation.
(Repository._warn_if_deprecated): Use the branch config if
available or the global one othewrwise and check for the
suppress_warning variable.

* bzrlib/remote.py:
(RemoteRepository._warn_if_deprecated): Nothing to do here. 

* bzrlib/repofmt/pack_repo.py:
(KnitPackRepository._warn_if_deprecated): Delegate to base class
if needed.

* bzrlib/branch.py:
(BzrBranch.lock_write, BzrBranch.lock_read): Check repo
deprecation.

* bzrlib/help_topics/en/configuration.txt:
Fix the variable name and its description.

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