summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMartin v. Löwis <martin@v.loewis.de>2002-01-26 20:11:50 (GMT)
committerMartin v. Löwis <martin@v.loewis.de>2002-01-26 20:11:50 (GMT)
commitef180dc3d0254264c71436358f4b2ecf73cfeb6e (patch)
treee3b072c8ac2602cb14b171ecd343b78ec9a74823
parentfb0da9d7709057695087f8ca280904c9ef84b11f (diff)
downloadcpython-ef180dc3d0254264c71436358f4b2ecf73cfeb6e.zip
cpython-ef180dc3d0254264c71436358f4b2ecf73cfeb6e.tar.gz
cpython-ef180dc3d0254264c71436358f4b2ecf73cfeb6e.tar.bz2
Document that get_referrers can return unreachable but uncollected objects.
Fixes #505453.
-rw-r--r--Doc/lib/libgc.tex7
-rw-r--r--Misc/ACKS1
2 files changed, 8 insertions, 0 deletions
diff --git a/Doc/lib/libgc.tex b/Doc/lib/libgc.tex
index b332fe2..67ac64f 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 074042d..d8747af 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