← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/HACKING

  • Committer: Ian Clatworthy
  • Date: 2007-05-31 04:59:25 UTC
  • mto: This revision was merged to the branch mainline in revision 2527.
  • Revision ID: ian.clatworthy@internode.on.net-20070531045925-jdx7px85ktqxxzox
Incorporate feedback from Robert Collins

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/HACKING
974
974
by setting the environment variable ``BZR_SIGQUIT_PDB=0``.
975
975
 
976
976
 
977
 
Profiling
978
 
=========
979
 
 
980
 
Bazaar has some built-in support for collecting and saving profiling
981
 
information. In the simpliest case, the --lsprof option can be used as
982
 
shown below::
983
 
 
984
 
  bzr --lsprof ...
985
 
 
986
 
This will dump the profiling information to stdout before exiting.
987
 
Alternatively, the --lsprof-file option can be used to specify a filename
988
 
to save the profiling data into to. By default, profiling data saved to a
989
 
file is a pickled Python object making it possible to reload the data and
990
 
do with it what you will. For convenience though:
991
 
 
992
 
* if the filename ends in "txt", it will be dumped in a text format.
993
 
 
994
 
* if the filename ends in "grind", it will be converted to a format
995
 
  loadable by the KCacheGrind visualisation tool.
996
 
 
997
 
Here is an example of how to use the --lsprof-file option in combination
998
 
with KCacheGrind to visualise what the "status" command is doing::
999
 
 
1000
 
  bzr --lsprof-file status001.callgrind status
1001
 
  kcachegrind status001.callgrind &
1002
 
 
1003
 
.. Note:: bzr also has a --profile option that uses the hotshot profiler
1004
 
   instead of the lsprof profiler. The hotshot profiler can be useful
1005
 
   though the lsprof one is generally recommended. See
1006
 
   http://docs.python.org/lib/node795.html.
1007
 
 
1008
 
 
1009
977
Jargon
1010
978
======
1011
979