Update Include/internal/pycore_pymem.h

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
python · corona10 · Jun 17, 2025 · May 20, 2025 · May 20, 2025 · May 21, 2025
commit 388f0ca7e5078458dd6c2b724619c429ff94b7dd
@@ -101,9 +101,8 @@ static inline void _PyObject_XDecRefDelayed(PyObject *obj)
 #endif
 
 #ifdef Py_GIL_DISABLED
-// This is the delayed-free equivalent of Py_XSETREF(), providing the same
-// atomic reference assignment semantics but with deferred cleanup suitable
-// for concurrent access patterns in free-threaded Python.
+// Same as `Py_XSETREF` but in free-threading, it stores the object atomically
+// and queues the old object to be decrefed at a safe point using QSBR
 PyAPI_FUNC(void) _PyObject_XSetRefDelayed(PyObject **p_obj, PyObject *obj);
 #else
 static inline void _PyObject_XSetRefDelayed(PyObject **p_obj, PyObject *obj)