Document that the 'strict' error handler is used to encode/decode filenames on

Windows

2 files changed, 15 insertions, 12 deletions

diff --git a/Doc/c-api/unicode.rst b/Doc/c-api/unicode.rst
index 8f9e994..dac01a4 100644
--- a/Doc/c-api/unicode.rst
+++ b/Doc/c-api/unicode.rst
@@ -412,26 +412,33 @@ used, passing :c:func:`PyUnicode_FSDecoder` as the conversion function:
 
 .. c:function:: PyObject* PyUnicode_DecodeFSDefaultAndSize(const char *s, Py_ssize_t size)
 
-   Decode a null-terminated string using :c:data:`Py_FileSystemDefaultEncoding`
-   and the ``"surrogateescape"`` error handler.
+   Decode a string using :c:data:`Py_FileSystemDefaultEncoding` and the
+   ``'surrogateescape'`` error handler, or ``'strict'`` on Windows.
 
    If :c:data:`Py_FileSystemDefaultEncoding` is not set, fall back to UTF-8.
 
-   Use :c:func:`PyUnicode_DecodeFSDefaultAndSize` if you know the string length.
+   .. versionchanged:: 3.2
+      Use ``'strict'`` error handler on Windows.
 
 
 .. c:function:: PyObject* PyUnicode_DecodeFSDefault(const char *s)
 
-   Decode a string using :c:data:`Py_FileSystemDefaultEncoding` and
-   the ``"surrogateescape"`` error handler.
+   Decode a null-terminated string using :c:data:`Py_FileSystemDefaultEncoding`
+   and the ``'surrogateescape'`` error handler, or ``'strict'`` on Windows.
 
    If :c:data:`Py_FileSystemDefaultEncoding` is not set, fall back to UTF-8.
 
+   Use :c:func:`PyUnicode_DecodeFSDefaultAndSize` if you know the string length.
+
+   .. versionchanged:: 3.2
+      Use ``'strict'`` error handler on Windows.
+
 
 .. c:function:: PyObject* PyUnicode_EncodeFSDefault(PyObject *unicode)
 
    Encode a Unicode object to :c:data:`Py_FileSystemDefaultEncoding` with the
-   ``'surrogateescape'`` error handler, and return :class:`bytes`.
+   ``'surrogateescape'`` error handler, or ``'strict'`` on Windows, and return
+   :class:`bytes`.
 
    If :c:data:`Py_FileSystemDefaultEncoding` is not set, fall back to UTF-8.
 
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index b22c2e9..92bd606 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -158,9 +158,7 @@ process and user.
 .. function:: fsencode(filename)
 
    Encode *filename* to the filesystem encoding with ``'surrogateescape'``
-   error handler, return :class:`bytes` unchanged. On Windows, use ``'strict'``
-   error handler if the filesystem encoding is ``'mbcs'`` (which is the default
-   encoding).
+   error handler, or ``'strict'`` on Windows; return :class:`bytes` unchanged.
 
    :func:`fsdecode` is the reverse function.
 
@@ -170,9 +168,7 @@ process and user.
 .. function:: fsdecode(filename)
 
    Decode *filename* from the filesystem encoding with ``'surrogateescape'``
-   error handler, return :class:`str` unchanged. On Windows, use ``'strict'``
-   error handler if the filesystem encoding is ``'mbcs'`` (which is the default
-   encoding).
+   error handler, or ``'strict'`` on Windows; return :class:`str` unchanged.
 
    :func:`fsencode` is the reverse function.