Skip to content

Commit e31265b

Browse files
committed
Docs: remove outdated marshal recursion and object sharing claim
1 parent a51bf70 commit e31265b

File tree

1 file changed

+1
-11
lines changed

1 file changed

+1
-11
lines changed

Doc/library/pickle.rst

Lines changed: 1 addition & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -56,18 +56,8 @@ files.
5656

5757
The :mod:`pickle` module differs from :mod:`marshal` in several significant ways:
5858

59-
* The :mod:`pickle` module keeps track of the objects it has already serialized,
59+
* * The :mod:`pickle` module keeps track of the objects it has already serialized,
6060
so that later references to the same object won't be serialized again.
61-
:mod:`marshal` doesn't do this.
62-
63-
This has implications both for recursive objects and object sharing. Recursive
64-
objects are objects that contain references to themselves. These are not
65-
handled by marshal, and in fact, attempting to marshal recursive objects will
66-
crash your Python interpreter. Object sharing happens when there are multiple
67-
references to the same object in different places in the object hierarchy being
68-
serialized. :mod:`pickle` stores such objects only once, and ensures that all
69-
other references point to the master copy. Shared objects remain shared, which
70-
can be very important for mutable objects.
7161

7262
* :mod:`marshal` cannot be used to serialize user-defined classes and their
7363
instances. :mod:`pickle` can save and restore class instances transparently,

0 commit comments

Comments
 (0)