gh-131544: Update docs for PyType_AddWatcher (gh-132015)

corona10 · web-flow · commit 25275bda790e · 2025-04-02T15:04:07.000Z
diff --git 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
 
 
