From c13df3a12b6741b7960437c7833b6fd59a465b5d Mon Sep 17 00:00:00 2001
From: Petr Viktorin <encukou@gmail.com>
Date: Fri, 16 Oct 2026 16:59:06 +0200
Subject: [PATCH] Mention `PyUnicode_EncodeFSDefault` in
 `PyConfig.filesystem_encoding` docs (GH-159297) (cherry picked from commit
 49fc7ed70ac480838c08e19e4ea7408a74d3fdb6)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
---
 Doc/c-api/init_config.rst | 4 ++++
 Doc/c-api/unicode.rst     | 2 ++
 2 files changed, 6 insertions(+)

diff --git a/Doc/c-api/init_config.rst b/Doc/c-api/init_config.rst
index 21f1ebc030186c4..435dec10c6ecc38 100644
--- a/Doc/c-api/init_config.rst
+++ b/Doc/c-api/init_config.rst
@@ -1427,6 +1427,10 @@ PyConfig
 
       See also the :c:member:`~PyConfig.filesystem_errors` member.
 
+      See also :c:func:`PyUnicode_EncodeFSDefault` and
+      :ref:`related functions <capi-filesystem-encoding>`
+      for encoding paths at runtime.
+
    .. c:member:: wchar_t* filesystem_errors
 
       :term:`Filesystem error handler <filesystem encoding and error handler>`:
diff --git a/Doc/c-api/unicode.rst b/Doc/c-api/unicode.rst
index 5cbe3080ff875cc..3e664d8a6c18364 100644
--- a/Doc/c-api/unicode.rst
+++ b/Doc/c-api/unicode.rst
@@ -911,6 +911,8 @@ system.
       used for ``strict``.
 
 
+.. _capi-filesystem-encoding:
+
 File System Encoding
 """"""""""""""""""""