Strengthen the constraints on calling PyObject_GC_Fini().

freddrake · freddrake · commit 8f6df46d40cc · 2001-03-23T17:42:09.000Z
diff --git a/Doc/api/api.tex b/Doc/api/api.tex
@@ -5029,6 +5029,11 @@ \section{Supporting Cyclic Garbarge Collection
   objects.  The deallocator (\member{tp_dealloc} handler) should call
   this for the object before any of the fields used by the
   \member{tp_traverse} handler become invalid.
+
+  \strong{Note:}  Any container which may be referenced from another
+  object reachable by the collector must itself be tracked by the
+  collector, so it is generally not safe to call this function
+  anywhere but in the object's deallocator.
 \end{cfuncdesc}
 
 The \member{tp_traverse} handler accepts a function parameter of this
