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 b332fe22dcacd4879dbe1b9d81e291024e20f724..67ac64f7e48eb541b6206143494b985d3534b9b4 100644 (file)
--- 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 074042db78338a8f3dadc722f36330888f538ad0..d8747affa72e1ad768ad3209368ad767fc11c8bf 100644 (file)
--- 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