diff Doc/api/api.tex @ 17209:52da094b53ec legacy-trunk

Strengthen the constraints on calling PyObject_GC_Fini().
author Fred Drake <fdrake@acm.org>
date Fri, 23 Mar 2001 17:42:09 +0000
parents 349c8788604e
children 1b12e6340038
line wrap: on
line diff
--- a/Doc/api/api.tex	Fri Mar 23 17:40:16 2001 +0000
+++ b/Doc/api/api.tex	Fri Mar 23 17:42:09 2001 +0000
@@ -5029,6 +5029,11 @@
   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