diff options
author | Daniel Giger <danielg3432@gmail.com> | 2022-10-04 22:18:04 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-10-04 22:18:04 (GMT) |
commit | 7acb93f0d44c6fb971fdb09b86f68896e3b1e2f8 (patch) | |
tree | 9dc9cb62dadd915bbc46b4e474d43864bbfba920 | |
parent | 87679a6e607eec1134d77222a3a92d0d11f768ad (diff) | |
download | cpython-7acb93f0d44c6fb971fdb09b86f68896e3b1e2f8.zip cpython-7acb93f0d44c6fb971fdb09b86f68896e3b1e2f8.tar.gz cpython-7acb93f0d44c6fb971fdb09b86f68896e3b1e2f8.tar.bz2 |
gh-96448: fix documentation for _thread.lock.acquire (#96449)
* fix documentation for _thread.lock.acquire
* update formatting of _thread.lock.acquire() doc
-rw-r--r-- | Doc/library/_thread.rst | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/Doc/library/_thread.rst b/Doc/library/_thread.rst index d61ce90..9df9e79 100644 --- a/Doc/library/_thread.rst +++ b/Doc/library/_thread.rst @@ -157,21 +157,21 @@ This module defines the following constants and functions: Lock objects have the following methods: -.. method:: lock.acquire(waitflag=1, timeout=-1) +.. method:: lock.acquire(blocking=True, timeout=-1) Without any optional argument, this method acquires the lock unconditionally, if necessary waiting until it is released by another thread (only one thread at a time can acquire a lock --- that's their reason for existence). - If the integer *waitflag* argument is present, the action depends on its - value: if it is zero, the lock is only acquired if it can be acquired - immediately without waiting, while if it is nonzero, the lock is acquired + If the *blocking* argument is present, the action depends on its + value: if it is False, the lock is only acquired if it can be acquired + immediately without waiting, while if it is True, the lock is acquired unconditionally as above. If the floating-point *timeout* argument is present and positive, it specifies the maximum wait time in seconds before returning. A negative *timeout* argument specifies an unbounded wait. You cannot specify - a *timeout* if *waitflag* is zero. + a *timeout* if *blocking* is False. The return value is ``True`` if the lock is acquired successfully, ``False`` if not. |