[Python-checkins] CVS: python/dist/src/Doc/lib libmarshal.tex,1.21,1.22

[Barry Warsaw]

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}