Dec 8, 2025 · Dec 4, 2025
diff --git a/Doc/c-api/gcsupport.rst b/Doc/c-api/gcsupport.rst
   object argument.  If *visit* returns a non-zero value that value should be
   returned immediately.

   The traversal function must not have any side effects.  Implementations
   may not modify the reference counts of any Python objects nor create or
   destroy any Python objects.

 To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, a :c:func:`Py_VISIT` macro is
 provided.  In order to use this macro, the :c:member:`~PyTypeObject.tp_traverse` implementation
 must name its arguments exactly *visit* and *arg*:
diff --git a/Doc/c-api/typeobj.rst b/Doc/c-api/typeobj.rst
       but the instance has no strong reference to the elements inside it, as they
       are allowed to be removed even if the instance is still alive).

   .. warning::
      The traversal function must not have any side effects.  It must not
      modify the reference counts of any Python objects nor create or destroy
      any Python objects.

   Note that :c:func:`Py_VISIT` requires the *visit* and *arg* parameters to
   :c:func:`!local_traverse` to have these specific names; don't name them just
   anything.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -232,6 +232,10 @@ The :c:member:`~PyTypeObject.tp_traverse` handler must have the following type:
		object argument. If visit returns a non-zero value that value should be
		returned immediately.

		The traversal function must not have any side effects. Implementations
		may not modify the reference counts of any Python objects nor create or
		destroy any Python objects.

		To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, a :c:func:`Py_VISIT` macro is
		provided. In order to use this macro, the :c:member:`~PyTypeObject.tp_traverse` implementation
		must name its arguments exactly visit and arg:
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -1569,6 +1569,11 @@ and :c:data:`PyType_Type` effectively act as defaults.)
		but the instance has no strong reference to the elements inside it, as they
		are allowed to be removed even if the instance is still alive).

		.. warning::
		The traversal function must not have any side effects. It must not
		modify the reference counts of any Python objects nor create or destroy
		any Python objects.

		Note that :c:func:`Py_VISIT` requires the visit and arg parameters to
		:c:func:`!local_traverse` to have these specific names; don't name them just
		anything.
Expand Down