Mention thread safety in PyDict_Next()

vstinner · vstinner · commit 31a438556112 · 2026-03-10T13:16:29.000+01:00
diff --git a/Doc/c-api/dict.rst b/Doc/c-api/dict.rst
@@ -369,7 +369,7 @@ Dictionary objects
       }
 
    The function is not thread-safe in the :term:`free-threaded <free threading>`
-   build without external synchronization.  You can use
+   build without external synchronization for a mutable :class:`dict`. You can use
    :c:macro:`Py_BEGIN_CRITICAL_SECTION` to lock the dictionary while iterating
    over it::
 
@@ -379,6 +379,8 @@ Dictionary objects
       }
       Py_END_CRITICAL_SECTION();
 
+   The function is thread-safe on a :class:`frozendict`.
+
    .. note::
 
       On the free-threaded build, this function can be used safely inside a

Original file line number	Diff line number	Diff line change
`@@ -369,7 +369,7 @@ Dictionary objects`
`369`	`369`	`}`
`370`	`370`
`371`	`371`	The function is not thread-safe in the :term:`free-threaded <free threading>`
`372`		`- build without external synchronization. You can use`
	`372`	+ build without external synchronization for a mutable :class:`dict`. You can use
`373`	`373`	:c:macro:`Py_BEGIN_CRITICAL_SECTION` to lock the dictionary while iterating
`374`	`374`	`over it::`
`375`	`375`
`@@ -379,6 +379,8 @@ Dictionary objects`
`379`	`379`	`}`
`380`	`380`	`Py_END_CRITICAL_SECTION();`
`381`	`381`
	`382`	+ The function is thread-safe on a :class:`frozendict`.
	`383`	`+`
`382`	`384`	`.. note::`
`383`	`385`
`384`	`386`	`On the free-threaded build, this function can be used safely inside a`