From: Cody Maloney <cmaloney@users.noreply.github.com>
Date: Wed, 8 Oct 2025 13:28:29 +0000 (-0700)
Subject: gh-139452: Clarify redirect_stdout, stderr behavior (gh-139490)
X-Git-Tag: v3.15.0a1~86
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8b9606a2c577b0a0f7f425959a27a8554a9b474f;p=thirdparty%2FPython%2Fcpython.git

gh-139452: Clarify redirect_stdout, stderr behavior (gh-139490)
---

diff --git a/Doc/library/contextlib.rst b/Doc/library/contextlib.rst
index 176be4ff3339..d0fa645093a3 100644
--- a/Doc/library/contextlib.rst
+++ b/Doc/library/contextlib.rst
@@ -327,10 +327,10 @@ Functions and classes provided:
 .. function:: redirect_stdout(new_target)
 
    Context manager for temporarily redirecting :data:`sys.stdout` to
-   another file or file-like object.
+   another :term:`file object`.
 
    This tool adds flexibility to existing functions or classes whose output
-   is hardwired to stdout.
+   is hardwired to :data:`sys.stdout`.
 
    For example, the output of :func:`help` normally is sent to *sys.stdout*.
    You can capture that output in a string by redirecting the output to an
@@ -366,8 +366,8 @@ Functions and classes provided:
 
 .. function:: redirect_stderr(new_target)
 
-   Similar to :func:`~contextlib.redirect_stdout` but redirecting
-   :data:`sys.stderr` to another file or file-like object.
+   Similar to :func:`~contextlib.redirect_stdout` but redirecting the global
+   :data:`sys.stderr` to another :term:`file object`.
 
    This context manager is :ref:`reentrant <reentrant-cms>`.