X-Git-Url: https://wannabe.guru.org/gitweb/?a=blobdiff_plain;f=lockfile.py;h=1e0516bf75a340b4a15629141cdfbfb83fc3485c;hb=acf8daa4fc565c394d442b5646f9b8462930b0cd;hp=34279ba8392c0e538ede3bfbc09b7af882657c16;hpb=b843703134a166013518c707fa5a77373f1bf0bf;p=python_utils.git

diff --git a/lockfile.py b/lockfile.py
index 34279ba..1e0516b 100644
--- a/lockfile.py
+++ b/lockfile.py
@@ -28,7 +28,14 @@ class LockFileContents:
 
 class LockFile(object):
     """A file locking mechanism that has context-manager support so you
-    can use it in a with statement.
+    can use it in a with statement.  e.g.
+
+    with LockFile('./foo.lock'):
+        # do a bunch of stuff... if the process dies we have a signal
+        # handler to do cleanup.  Other code (in this process or another)
+        # that tries to take the same lockfile will block.  There is also
+        # some logic for detecting stale locks.
+
     """
 
     def __init__(