From 13e9c2d18de26a590f9b11b1add637200bf66dd1 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
 (#114834)

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 fac88d8b20..4ebceae702 100644
--- a/Lib/threading.py
+++ b/Lib/threading.py
@@ -653,7 +653,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: