mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-10-03 13:45:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

[3.11] gh-96448: fix documentation for _thread.lock.acquire (GH-96449) (#97851)

Browse source 
gh-96448: fix documentation for _thread.lock.acquire (GH-96449)

* fix documentation for _thread.lock.acquire

* update formatting of _thread.lock.acquire() doc
(cherry picked from commit 7acb93f0d4)

Co-authored-by: Daniel Giger <danielg3432@gmail.com>

Co-authored-by: Daniel Giger <danielg3432@gmail.com>
This commit is contained in:
Miss Islington (bot) 2022-10-04 15:21:28 -07:00 • committed by Pablo Galindo
parent 95f7ed8b07
commit ed772a817e
No known key found for this signature in database
GPG key ID: FFE87404168BD847
1 changed files with 5 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

10
Doc/library/_thread.rst
View file

@ -157,21 +157,21 @@ This module defines the following constants and functions:
Lock objects have the following methods: 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 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 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). time can acquire a lock --- that's their reason for existence).
If the integer *waitflag* argument is present, the action depends on its If the *blocking* argument is present, the action depends on its
value: if it is zero, the lock is only acquired if it can be acquired value: if it is False, the lock is only acquired if it can be acquired
immediately without waiting, while if it is nonzero, the lock is acquired immediately without waiting, while if it is True, the lock is acquired
unconditionally as above. unconditionally as above.
If the floating-point *timeout* argument is present and positive, it If the floating-point *timeout* argument is present and positive, it
specifies the maximum wait time in seconds before returning. A negative specifies the maximum wait time in seconds before returning. A negative
*timeout* argument specifies an unbounded wait. You cannot specify *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, The return value is ``True`` if the lock is acquired successfully,
``False`` if not. ``False`` if not.