Documented gc.get_referrers() as dangerous.

SF bug 793822

diff --git a/Doc/lib/libgc.tex b/Doc/lib/libgc.tex
index 24775849f75a12a1ac7e1fa6574c2bd26302711e..f256434a403472b355f7ef818eeb45fbf8803ca6 100644 (file)
--- a/Doc/lib/libgc.tex
+++ b/Doc/lib/libgc.tex
@@ -96,6 +96,11 @@ be listed among the resulting referrers.  To get only currently live
 objects, call \function{collect()} before calling
 \function{get_referrers()}.
 
+Care must be taken when using objects returned by
+\function{get_referrers()} because some of them could still be under
+construction and hence in a temporarily invalid state. Avoid using
+\function{get_referrers()} for any purpose other than debugging.
+
 \versionadded{2.2}
 \end{funcdesc}