summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorHrvoje Nikšić <hniksic@gmail.com>2019-05-29 17:08:17 (GMT)
committerMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2019-05-29 17:08:17 (GMT)
commit34f4f5efea730504216ee19f237734e0bb0104ee (patch)
tree78e1a608979851c094df1a911947af118957821e
parent46ed90dd014010703c7a3b2a61c4927644fa8210 (diff)
downloadcpython-34f4f5efea730504216ee19f237734e0bb0104ee.zip
cpython-34f4f5efea730504216ee19f237734e0bb0104ee.tar.gz
cpython-34f4f5efea730504216ee19f237734e0bb0104ee.tar.bz2
bpo-36794: Document that Lock.acquire is fair. (GH-13082)
https://bugs.python.org/issue36794
-rw-r--r--Doc/library/asyncio-sync.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/Doc/library/asyncio-sync.rst b/Doc/library/asyncio-sync.rst
index e3f18cc..79f6b02 100644
--- a/Doc/library/asyncio-sync.rst
+++ b/Doc/library/asyncio-sync.rst
@@ -66,6 +66,13 @@ Lock
This method waits until the lock is *unlocked*, sets it to
*locked* and returns ``True``.
+ When more than one coroutine is blocked in :meth:`acquire`
+ waiting for the lock to be unlocked, only one coroutine
+ eventually proceeds.
+
+ Acquiring a lock is *fair*: the coroutine that proceeds will be
+ the first coroutine that started waiting on the lock.
+
.. method:: release()
Release the lock.