bpo-41147: [doc] contextlib.redirect_stdout() provides the new stream…

… as context var (pythonGH-21199) (cherry picked from commit 46db39d) Co-authored-by: Peter Law <[email protected]>
miss-islington · May 26, 2021 · 11ec9d3 · 11ec9d3
1 parent e7078ee
commit 11ec9d3
Showing 1 changed file with 4 additions and 3 deletions.
diff --git a/Doc/library/contextlib.rst b/Doc/library/contextlib.rst
@@ -236,10 +236,11 @@ Functions and classes provided:
 
    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
-   :class:`io.StringIO` object::
+   :class:`io.StringIO` object. The replacement stream is returned from the
+   ``__enter__`` method and so is available as the target of the
+   :keyword:`with` statement::
 
-        f = io.StringIO()
-        with redirect_stdout(f):
+        with redirect_stdout(io.StringIO()) as f:
             help(pow)
         s = f.getvalue()