Issue #13502: threading: Fix a race condition in Event.wait() that made it

return False when the event was set and cleared right after.

1 files changed, 4 insertions, 2 deletions

diff --git a/Doc/library/threading.rst b/Doc/library/threading.rst
index c226dd4..9b3affd 100644
--- a/Doc/library/threading.rst
+++ b/Doc/library/threading.rst
@@ -782,8 +782,10 @@ An event object manages an internal flag that can be set to true with the
       floating point number specifying a timeout for the operation in seconds
       (or fractions thereof).
 
-      This method returns the internal flag on exit, so it will always return
-      ``True`` except if a timeout is given and the operation times out.
+      This method returns true if and only if the internal flag has been set to
+      true, either before the wait call or after the wait starts, so it will
+      always return ``True`` except if a timeout is given and the operation
+      times out.
 
       .. versionchanged:: 3.1
          Previously, the method always returned ``None``.