[3.13] gh-114827: clarify `threading.Event.wait` timeout behavior (GH-114834) (#140099)

Co-authored-by: Doug Hoskisson <beauxq@users.noreply.github.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>

diff --git a/Lib/threading.py b/Lib/threading.py
index acf5090716c9be679bb0ce9ba1c60533e116f633..15bf786a6a9060008c80fad0b5a9765cd5ed765e 100644 (file)
--- a/Lib/threading.py
+++ b/Lib/threading.py
@@ -650,7 +650,8 @@ class Event:
         (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.
+        ``True`` except if a timeout is given and the operation times out, when
+        it will return ``False``.
 
         """
         with self._cond: