diff --git a/Doc/library/io.rst b/Doc/library/io.rst index f793d7a7ef9a84..cca9b8bf869f2a 100644 --- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -950,7 +950,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 `, 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.