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

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

diff --git a/Doc/lib/libpickle.tex b/Doc/lib/libpickle.tex
index cf526a069f0e..99dd330e6324 100644
--- a/Doc/lib/libpickle.tex
+++ b/Doc/lib/libpickle.tex
@@ -372,6 +372,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