mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-03 16:39:00 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

[3.14] Docs: Fix and improve the PyUnstable_Object_EnableDeferredRefcount documentation (GH-135323) (GH-136610)

Browse source 
Docs: Fix and improve the `PyUnstable_Object_EnableDeferredRefcount` documentation (GH-135323)
(cherry picked from commit 0d4fd10fba)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
This commit is contained in:
Miss Islington (bot) 2025-07-13 08:52:58 +02:00 • committed by GitHub
parent f50cd5bec7
commit a1ed132a19
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 7 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

12
Doc/c-api/object.rst
View file

@ -596,12 +596,13 @@ Object Protocol
if supported by the runtime. In the :term:`free-threaded <free threading>` build,
this allows the interpreter to avoid reference count adjustments to *obj*,
which may improve multi-threaded performance. The tradeoff is
that *obj* will only be deallocated by the tracing garbage collector.
that *obj* will only be deallocated by the tracing garbage collector, and
not when the interpreter no longer has any references to it.
This function returns ``1`` if deferred reference counting is enabled on *obj*
(including when it was enabled before the call),
This function returns ``1`` if deferred reference counting is enabled on *obj*,
and ``0`` if deferred reference counting is not supported or if the hint was
ignored by the runtime. This function is thread-safe, and cannot fail.
ignored by the interpreter, such as when deferred reference counting is already
enabled on *obj*. This function is thread-safe, and cannot fail.
This function does nothing on builds with the :term:`GIL` enabled, which do
not support deferred reference counting. This also does nothing if *obj* is not
@ -609,7 +610,8 @@ Object Protocol
:c:func:`PyObject_GC_IsTracked`).
This function is intended to be used soon after *obj* is created,
by the code that creates it.
by the code that creates it, such as in the object's :c:member:`~PyTypeObject.tp_new`
slot.
.. versionadded:: 3.14