From 203610db02301ca2d1c1b940d47bd3d62207a4ea Mon Sep 17 00:00:00 2001
From: Doug Hoskisson <beauxq@users.noreply.github.com>
Date: Tue, 14 Oct 2025 01:34:53 -0700
Subject: [PATCH] gh-114827: clarify `threading.Event.wait` timeout behavior
 (GH-114834) (cherry picked from commit
 13e9c2d18de26a590f9b11b1add637200bf66dd1)

Co-authored-by: Doug Hoskisson <beauxq@users.noreply.github.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
---
 Lib/threading.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Lib/threading.py b/Lib/threading.py
index 79b753d983aaaf..c03b0b5370c933 100644
--- a/Lib/threading.py
+++ b/Lib/threading.py
@@ -660,7 +660,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: