From: Georg Brandl <georg@python.org>
Date: Mon, 26 Dec 2005 23:27:50 +0000 (+0000)
Subject: Bug #839075 (backport): document that highly recursive data cannot be pickled
X-Git-Tag: v2.4.3c1~174
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=6638b863be3d78a1e5e1fbf75790c998d337d5ff;p=thirdparty%2FPython%2Fcpython.git

Bug #839075 (backport): document that highly recursive data cannot be pickled
---

diff --git a/Doc/lib/libpickle.tex b/Doc/lib/libpickle.tex
index f5c23f068d64..74d289e13ca1 100644
--- a/Doc/lib/libpickle.tex
+++ b/Doc/lib/libpickle.tex
@@ -395,6 +395,10 @@ section~\ref{pickle-protocol} for details)
 Attempts to pickle unpicklable objects will raise the
 \exception{PicklingError} exception; when this happens, an unspecified
 number of bytes may have already been written to the underlying file.
+Trying to pickle a highly recursive data structure may exceed the
+maximum recursion depth, a \exception{RuntimeError} will be raised
+in this case. You can carefully raise this limit with 
+\function{sys.setrecursionlimit()}.
 
 Note that functions (built-in and user-defined) are pickled by ``fully
 qualified'' name reference, not by value.  This means that only the