From 07afab46e82a41b740ed702e81a8aee0225fa380 Mon Sep 17 00:00:00 2001
From: Malcolm Smith <smith@chaquo.com>
Date: Thu, 24 Apr 2025 18:18:42 +0100
Subject: [PATCH] Document how TextIOWrapper interacts with UTF-8 mode

---
 Doc/library/io.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Doc/library/io.rst b/Doc/library/io.rst
index fcd7afea3544dd..3aa2f35f05eba0 100644
--- a/Doc/library/io.rst
+++ b/Doc/library/io.rst
@@ -965,7 +965,8 @@ Text I/O
    :class:`TextIOBase`.
 
    *encoding* gives the name of the encoding that the stream will be decoded or
-   encoded with.  It defaults to :func:`locale.getencoding`.
+   encoded with.  In :ref:`UTF-8 Mode <utf8-mode>`, this defaults to UTF-8.
+   Otherwise, it defaults to :func:`locale.getencoding`.
    ``encoding="locale"`` can be used to specify the current locale's encoding
    explicitly. See :ref:`io-text-encoding` for more information.