From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Wed, 2 Apr 2025 16:24:43 +0000 (+0200)
Subject: [3.13] gh-131544: Update docs for PyType_AddWatcher (gh-132015) (gh-132019)
X-Git-Tag: v3.13.3~46
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=75d453b0ab852b1cc295ea602b3df413ef0ce569;p=thirdparty%2FPython%2Fcpython.git

[3.13] gh-131544: Update docs for PyType_AddWatcher (gh-132015) (gh-132019)

gh-131544: Update docs for PyType_AddWatcher (gh-132015)
(cherry picked from commit 25275bda790e8a689092e83855d6d0574f26061b)

Co-authored-by: Donghee Na <donghee.na@python.org>
---

diff --git a/Doc/c-api/type.rst b/Doc/c-api/type.rst
index 4ba3f7ac2faf..be87b689fa1c 100644
--- a/Doc/c-api/type.rst
+++ b/Doc/c-api/type.rst
@@ -82,6 +82,9 @@ Type Objects
    error (e.g. no more watcher IDs available), return ``-1`` and set an
    exception.
 
+   In free-threaded builds, :c:func:`PyType_AddWatcher` is not thread-safe,
+   so it must be called at start up (before spawning the first thread).
+
    .. versionadded:: 3.12