[Python-checkins] CVS: python/dist/src/Doc/lib libmarshal.tex,1.21,1.22
Barry Warsaw
bwarsaw@users.sourceforge.net
Thu, 15 Nov 2001 15:55:14 -0800
Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv14911
Modified Files:
libmarshal.tex
Log Message:
A few minor updates to make it clear(er) that pickle should be used
instead of marshal for object serialization.
Fred, please proofread!
Index: libmarshal.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libmarshal.tex,v
retrieving revision 1.21
retrieving revision 1.22
diff -C2 -d -r1.21 -r1.22
*** libmarshal.tex 2001/10/20 04:24:09 1.21
--- libmarshal.tex 2001/11/15 23:55:12 1.22
***************
*** 1,4 ****
\section{\module{marshal} ---
! Alternate Python object serialization}
\declaremodule{builtin}{marshal}
--- 1,4 ----
\section{\module{marshal} ---
! Internal Python object serialization}
\declaremodule{builtin}{marshal}
***************
*** 24,28 ****
\refmodule{pickle} and \refmodule{shelve}. The \module{marshal} module exists
mainly to support reading and writing the ``pseudo-compiled'' code for
! Python modules of \file{.pyc} files.
\refstmodindex{pickle}
\refstmodindex{shelve}
--- 24,34 ----
\refmodule{pickle} and \refmodule{shelve}. The \module{marshal} module exists
mainly to support reading and writing the ``pseudo-compiled'' code for
! Python modules of \file{.pyc} files. Therefore, the Python
! maintainers reserve the right to modify the marshal format in backward
! incompatible ways should the need arise. If you're serializing and
! de-serializing Python objects, use the \module{pickle} module. There
! may also be unknown security problems with
! \module{marshal}\footnote{As opposed to the known security issues in
! the \module{pickle} module!}.
\refstmodindex{pickle}
\refstmodindex{shelve}