From: Martin v. Löwis <martin@v.loewis.de>
Date: Sat, 26 Jan 2002 20:11:50 +0000 (+0000)
Subject: Document that get_referrers can return unreachable but uncollected objects.
X-Git-Tag: v2.3c1~6778
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ef180dc3d0254264c71436358f4b2ecf73cfeb6e;p=python

Document that get_referrers can return unreachable but uncollected objects.
Fixes #505453.
---

diff --git a/Doc/lib/libgc.tex b/Doc/lib/libgc.tex
index b332fe22dc..67ac64f7e4 100644
--- a/Doc/lib/libgc.tex
+++ b/Doc/lib/libgc.tex
@@ -83,6 +83,13 @@ Return the list of objects that directly refer to any of objs. This
 function will only locate those containers which support garbage
 collection; extension types which do refer to other objects but do not
 support garbage collection will not be found.
+
+Note that objects which have already been dereferenced, but which live
+in cycles and have not yet been collected by the garbage collector can
+be listed among the resulting referrers.  To get only currently live
+objects, call \function{collect()} before calling
+\function{get_referrers()}.
+
 \versionadded{2.2}
 \end{funcdesc}
 
diff --git a/Misc/ACKS b/Misc/ACKS
index 074042db78..d8747affa7 100644
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -472,6 +472,7 @@ Edward Welbourne
 Rickard Westman
 Truida Wiedijk
 Gerry Wiener
+Bryce "Zooko" Wilcox-O'Hearn
 Sue Williams
 Frank Willison
 Greg V. Wilson