Rev 2562: Docs on -Dlock in http://sourcefrog.net/bzr/dlock

[Martin Pool]

At http://sourcefrog.net/bzr/dlock

------------------------------------------------------------
revno: 2562
revision-id: mbp at sourcefrog.net-20070627093945-36tc2vu397tk1k6a
parent: mbp at sourcefrog.net-20070627092240-c75i6lwuwnc5gf2l
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: dlock
timestamp: Wed 2007-06-27 19:39:45 +1000
message:
  Docs on -Dlock
modified:
  NEWS                           NEWS-20050323055033-4e00b5db738777ff
  doc/developers/profiling.txt   profiling.txt-20070531045713-j15mxufywgzwdeu8-1
=== modified file 'NEWS'
--- a/NEWS	2007-06-27 01:43:03 +0000
+++ b/NEWS	2007-06-27 09:39:45 +0000
@@ -50,10 +50,16 @@
       library users and plugins. See the ``bzrlib.api`` module for details.
       (Robert Collins)
 
+    * Remove unnecessary lock probes when acquiring a lockdir.
+      (Martin Pool)
+
   INTERNALS:
 
     * New SMTPConnection class to unify email handling.  (Adeodato Simó)
 
+    * New ``-Dlock`` option to log (to ~/.bzr.log) information on when 
+      lockdirs are taken or released.  (Martin Pool)
+
   TESTING:
 
     * Removed the ``--keep-output`` option from selftest and clean up test

=== modified file 'doc/developers/profiling.txt'
--- a/doc/developers/profiling.txt	2007-06-25 06:22:27 +0000
+++ b/doc/developers/profiling.txt	2007-06-27 09:39:45 +0000
@@ -33,3 +33,16 @@
 can get with::
 
   svn co http://codespeak.net/svn/user/arigo/hack/misc/lsprof
+
+
+Profiling locks
+---------------
+
+Bazaar can log when locks are taken or released, which can help in
+identifying unnecessary lock traffic.  This is activated by the ``-Dlock``
+global option.
+
+This writes messages into ~/.bzr.log.
+At present this only logs actions relating to the on-disk lockdir.  It 
+doesn't describe actions on in-memory lock counters, or OS locks (which
+are used for dirstate.)