gh-114827: clarify threading.Event.wait timeout behavior (#114834)

beauxq · kumaraditya303 · web-flow · commit 13e9c2d18de2 · 2025-10-14T11:34:53.000+03:00
Co-authored-by: Kumar Aditya &lt;kumaraditya@python.org&gt;
diff --git a/Lib/threading.py b/Lib/threading.py
@@ -653,7 +653,8 @@ def wait(self, timeout=None):
         (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:
