summaryrefslogtreecommitdiffstats
path: root/Doc/libpickle.tex
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1995-03-28 13:35:14 (GMT)
committerGuido van Rossum <guido@python.org>1995-03-28 13:35:14 (GMT)
commitecde781dd10cccf97688811743dcda7b2a8d25ae (patch)
tree9c883726ce1f433c4ced05f9098e78d18919b7a3 /Doc/libpickle.tex
parent557ed94ebbad49ec0f1ffa1b1b911a4ba1162c51 (diff)
downloadcpython-ecde781dd10cccf97688811743dcda7b2a8d25ae.zip
cpython-ecde781dd10cccf97688811743dcda7b2a8d25ae.tar.gz
cpython-ecde781dd10cccf97688811743dcda7b2a8d25ae.tar.bz2
restructured library manual accordiung to functional group
Diffstat (limited to 'Doc/libpickle.tex')
-rw-r--r--Doc/libpickle.tex7
1 files changed, 5 insertions, 2 deletions
diff --git a/Doc/libpickle.tex b/Doc/libpickle.tex
index 8dc29e4..92020a2 100644
--- a/Doc/libpickle.tex
+++ b/Doc/libpickle.tex
@@ -11,7 +11,9 @@
The \code{pickle} module implements a basic but powerful algorithm for
``pickling'' (a.k.a.\ serializing, marshalling or flattening) nearly
-arbitrary Python objects. This is a more primitive notion than
+arbitrary Python objects. This is the act of converting objects to a
+stream of bytes (and back: ``unpickling'').
+This is a more primitive notion than
persistency --- although \code{pickle} reads and writes file objects,
it does not handle the issue of naming persistent objects, nor the
(even more complicated) area of concurrent access to persistent
@@ -54,7 +56,8 @@ advantage of using printable \ASCII{} (and of some other characteristics
of \code{pickle}'s representation) is that for debugging or recovery
purposes it is possible for a human to read the pickled file with a
standard text editor. (I could have gone a step further and used a
-notation like S-expressions, but the parser would have been
+notation like S-expressions, but the parser
+(currently written in Python) would have been
considerably more complicated and slower, and the files would probably
have become much larger.)