summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libpickle.tex
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2005-12-26 23:27:49 (GMT)
committerGeorg Brandl <georg@python.org>2005-12-26 23:27:49 (GMT)
commitd90d1c1b8d9a16b1b59f235201ae862d639145d7 (patch)
treeefacf63615d56a84acb863c8c360ac0c7976d0aa /Doc/lib/libpickle.tex
parentc47f1c194acb964ba5fde14b4f45e4c2304c8567 (diff)
downloadcpython-d90d1c1b8d9a16b1b59f235201ae862d639145d7.zip
cpython-d90d1c1b8d9a16b1b59f235201ae862d639145d7.tar.gz
cpython-d90d1c1b8d9a16b1b59f235201ae862d639145d7.tar.bz2
Bug #839075: document that highly recursive data cannot be pickled
Diffstat (limited to 'Doc/lib/libpickle.tex')
-rw-r--r--Doc/lib/libpickle.tex4
1 files changed, 4 insertions, 0 deletions
diff --git a/Doc/lib/libpickle.tex b/Doc/lib/libpickle.tex
index cf526a0..99dd330 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