[docs] [issue14823] Simplify threading.Lock.acquire() description

[R. David Murray]

R. David Murray <rdmurray at bitdance.com> added the comment:

Thanks for the suggestion and the patch.

The 'true' isn't inherited from java.  The actual value can be either an integer or True/False.  (If it were a function written in Python it would be any value that evaluates as true, but because it is written in C it is actually restricted to an integer...this is a bit of a wart, actually).

In the Python3 docs it is indeed documented as 'blocking=True'.  The Python2 docs use an older signature style that we didn't bother to fix up.

----------
nosy: +r.david.murray
stage:  -> commit review
type:  -> behavior
versions: +Python 3.2, Python 3.3 -Python 2.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue14823>
_______________________________________