Issue #13502: threading: Fix a race condition in Event.wait() that made it
return False when the event was set and cleared right after.
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 @@
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``.