[Python-checkins] gh-90301: Doc: Add references to PEP 686 (GH-96816)

[miss-islington]

https://github.com/python/cpython/commit/cad4dca7bfd5f32d07d0af598ecc3ac295c59d19
commit: cad4dca7bfd5f32d07d0af598ecc3ac295c59d19
branch: 3.11
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2022-10-04T15:14:52-07:00
summary:

gh-90301: Doc: Add references to PEP 686 (GH-96816)


Doc: Add references to PEP 686.
(cherry picked from commit 87679a6e607eec1134d77222a3a92d0d11f768ad)

Co-authored-by: Inada Naoki <songofacandy at gmail.com>

files:
M Doc/library/io.rst
M Doc/library/os.rst

diff --git a/Doc/library/io.rst b/Doc/library/io.rst
index 97a70646a93c..7ec990c3212a 100644
--- a/Doc/library/io.rst
+++ b/Doc/library/io.rst
@@ -123,17 +123,19 @@ encoding is not UTF-8 for most Windows users. For example::
    with open("README.md") as f:
        long_description = f.read()
 
-Additionally, while there is no concrete plan as of yet, Python may change
-the default text file encoding to UTF-8 in the future.
-
 Accordingly, it is highly recommended that you specify the encoding
 explicitly when opening text files. If you want to use UTF-8, pass
 ``encoding="utf-8"``. To use the current locale encoding,
-``encoding="locale"`` is supported in Python 3.10.
+``encoding="locale"`` is supported since Python 3.10.
+
+.. seealso::
+
+   :ref:`utf8-mode`
+      Python UTF-8 Mode can be used to change the default encoding to
+      UTF-8 from locale-specific encoding.
 
-When you need to run existing code on Windows that attempts to open
-UTF-8 files using the default locale encoding, you can enable the UTF-8
-mode. See :ref:`UTF-8 mode on Windows <win-utf8-mode>`.
+   :pep:`686`
+      Python 3.15 will make :ref:`utf8-mode` default.
 
 .. _io-encoding-warning:
 
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 4784110fb103..fbfeeb2d7e1f 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -159,6 +159,11 @@ can be read from :data:`sys.flags.utf8_mode <sys.flags>`.
 See also the :ref:`UTF-8 mode on Windows <win-utf8-mode>`
 and the :term:`filesystem encoding and error handler`.
 
+.. seealso::
+
+   :pep:`686`
+      Python 3.15 will make :ref:`utf8-mode` default.
+
 
 .. _os-procinfo: