--- threading.txt	2012-05-16 05:28:58.000000000 +1000
+++ threading.txt.new	2012-05-16 10:17:02.000000000 +1000
@@ -386,16 +386,13 @@
 
    Acquire a lock, blocking or non-blocking.
 
-   When invoked without arguments, block until the lock is unlocked,
+   When invoked with the *blocking* argument set to true 
+   (the default), block until the lock is unlocked, 
    then set it to locked, and return true.
 
-   When invoked with the *blocking* argument set to true, do the same
-   thing as when called without arguments, and return true.
-
    When invoked with the *blocking* argument set to false, do not
    block.  If a call without an argument would block, return false
-   immediately; otherwise, do the same thing as when called without
-   arguments, and return true.
+   immediately; otherwise, set the lock to locked, and return true.
 
 Lock.release()