Clarify event.wait's blocking behavior.

diff --git a/docs/locks.rst b/docs/locks.rst
index 3dbed192b077ae08db30775da9cc1002171a7d97..c9fd275c3a80e0d338f140de002005144240946c 100644 (file)
--- a/docs/locks.rst
+++ b/docs/locks.rst
@@ -76,8 +76,8 @@ multithreaded app.)*
    .. autoclass:: Event
     :members:
 
-    A coroutine can wait for an event to be set. Once it is set, the coroutine
-    does not block on `wait` until the the event is unset again:
+    A coroutine can wait for an event to be set. Once it is set, calls to
+    ``yield event.wait()`` will not block unless the event has been cleared:
 
     .. testcode::