/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/developers/profiling.txt

  • Committer: Robert Collins
  • Date: 2010-05-06 23:41:35 UTC
  • mto: This revision was merged to the branch mainline in revision 5223.
  • Revision ID: robertc@robertcollins.net-20100506234135-yivbzczw1sejxnxc
Lock methods on ``Tree``, ``Branch`` and ``Repository`` are now
expected to return an object which can be used to unlock them. This reduces
duplicate code when using cleanups. The previous 'tokens's returned by
``Branch.lock_write`` and ``Repository.lock_write`` are now attributes
on the result of the lock_write. ``repository.RepositoryWriteLockResult``
and ``branch.BranchWriteLockResult`` document this. (Robert Collins)

``log._get_info_for_log_files`` now takes an add_cleanup callable.
(Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/profiling.txt
8
8
information. In the simpliest case, the ``--lsprof`` option can be used as
9
9
shown below::
10
10
 
11
 
  brz --lsprof ...
 
11
  bzr --lsprof ...
12
12
 
13
13
This will dump the profiling information to stdout before exiting.
14
14
Alternatively, the ``--lsprof-file`` option can be used to specify a filename
28
28
in combination with KCacheGrind to visualize what the ``status`` command
29
29
is doing::
30
30
 
31
 
  brz --lsprof-file callgrind.out.st001 status
 
31
  bzr --lsprof-file callgrind.out.st001 status
32
32
  kcachegrind callgrind.out.st001 &
33
33
 
34
 
.. Note:: brz also has a ``--profile`` option that uses the hotshot profiler
 
34
.. Note:: bzr also has a ``--profile`` option that uses the hotshot profiler
35
35
   instead of the lsprof profiler. The hotshot profiler can be useful
36
36
   though the lsprof one is generally recommended. See
37
37
   http://docs.python.org/lib/node795.html.
49
49
identifying unnecessary lock traffic.  This is activated by the ``-Dlock``
50
50
global option.
51
51
 
52
 
This writes messages into ``$XDG_CACHE_HOME/breeezy/brz.log``.
 
52
This writes messages into ``~/.bzr.log``.
53
53
At present this only logs actions relating to the on-disk lockdir.  It
54
54
doesn't describe actions on in-memory lock counters, or OS locks (which
55
55
are used for dirstate.)