From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 23 Jan 2024 01:07:34 +0000 (+0100)
Subject: [3.12] gh-66944: Note that the `contextlib.closing` example is for illustrative purpo... 
X-Git-Tag: v3.12.2~112
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=536b66f8fa6f8374bd8083ff2ce6a5796791b45f;p=thirdparty%2FPython%2Fcpython.git

[3.12] gh-66944: Note that the `contextlib.closing` example is for illustrative purposes (GH-112198) (#114458)
---

diff --git a/Doc/library/contextlib.rst b/Doc/library/contextlib.rst
index aab319cbe740..b73373bc2363 100644
--- a/Doc/library/contextlib.rst
+++ b/Doc/library/contextlib.rst
@@ -182,6 +182,14 @@ Functions and classes provided:
    without needing to explicitly close ``page``.  Even if an error occurs,
    ``page.close()`` will be called when the :keyword:`with` block is exited.
 
+   .. note::
+
+      Most types managing resources support the :term:`context manager` protocol,
+      which closes *thing* on leaving the :keyword:`with` statment.
+      As such, :func:`!closing` is most useful for third party types that don't
+      support context managers.
+      This example is purely for illustration purposes,
+      as :func:`~urllib.request.urlopen` would normally be used in a context manager.
 
 .. function:: aclosing(thing)