From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 14 Oct 2025 14:13:33 +0000 (+0200)
Subject: [3.14] gh-114827: clarify `threading.Event.wait` timeout behavior (GH-114834) (#140100)
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=525f7c23b9409e8b40e1426ff7743954685ab1a5;p=thirdparty%2FPython%2Fcpython.git

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

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 79b753d983aa..c03b0b5370c9 100644
--- a/Lib/threading.py
+++ b/Lib/threading.py
@@ -660,7 +660,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: