From: Fred Drake <fdrake@acm.org>
Date: Fri, 23 Mar 2001 17:42:09 +0000 (+0000)
Subject: Strengthen the constraints on calling PyObject_GC_Fini().
X-Git-Tag: v2.1b2~8
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8f6df46d40cc8d13c1f4e7dc532163653afe8b8f;p=thirdparty%2FPython%2Fcpython.git

Strengthen the constraints on calling PyObject_GC_Fini().
---

diff --git a/Doc/api/api.tex b/Doc/api/api.tex
index 572634184447..8bf0892637c1 100644
--- 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