diff --git a/Doc/library/asyncio-sync.rst b/Doc/library/asyncio-sync.rst index f9e98e05cab7ac..8f9960d45836c3 100644 --- a/Doc/library/asyncio-sync.rst +++ b/Doc/library/asyncio-sync.rst @@ -11,7 +11,7 @@ Synchronization Primitives ----------------------------------------------- asyncio synchronization primitives are designed to be similar to -those of the :mod:`threading` module with two important caveats: +those of the :mod:`threading` module with several important caveats: * asyncio primitives are not thread-safe, therefore they should not be used for OS thread synchronization (use :mod:`threading` for @@ -21,6 +21,10 @@ those of the :mod:`threading` module with two important caveats: argument; use the :func:`asyncio.wait_for` function to perform operations with timeouts. +* asyncio primitives are bound to a specific event loop and must be + constructed inside the loop to function correctly. A common mistake is + constructing them before the loop starts, such as with global variables. + asyncio has the following basic synchronization primitives: * :class:`Lock`