Strengthen the constraints on calling PyObject_GC_Fini().

diff --git a/Doc/api/api.tex b/Doc/api/api.tex
index 57263418444779c406ca1f719871eeea0ddd9bde..8bf0892637c182264df3feb5a66fd95496edf267 100644 (file)
--- a/Doc/api/api.tex
+++ b/Doc/api/api.tex
@@ -5029,6 +5029,11 @@ pair of rules:
   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