[Python-checkins] python/dist/src/Doc/api utilities.tex,1.13,1.14

[loewis at users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/api
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv25751/Doc/api

Modified Files:
	utilities.tex 
Log Message:
Patch #923098: Share interned strings in marshal.


Index: utilities.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/utilities.tex,v
retrieving revision 1.13
retrieving revision 1.14
diff -C2 -d -r1.13 -r1.14
*** utilities.tex	3 Jun 2004 09:55:28 -0000	1.13
--- utilities.tex	27 Jun 2004 16:51:45 -0000	1.14
***************
*** 284,301 ****
  Numeric values are stored with the least significant byte first.
  
! \begin{cfuncdesc}{void}{PyMarshal_WriteLongToFile}{long value, FILE *file}
    Marshal a \ctype{long} integer, \var{value}, to \var{file}.  This
    will only write the least-significant 32 bits of \var{value};
    regardless of the size of the native \ctype{long} type.
  \end{cfuncdesc}
  
  \begin{cfuncdesc}{void}{PyMarshal_WriteObjectToFile}{PyObject *value,
!                                                      FILE *file}
    Marshal a Python object, \var{value}, to \var{file}.
  \end{cfuncdesc}
  
! \begin{cfuncdesc}{PyObject*}{PyMarshal_WriteObjectToString}{PyObject *value}
    Return a string object containing the marshalled representation of
    \var{value}.
  \end{cfuncdesc}
  
--- 284,312 ----
  Numeric values are stored with the least significant byte first.
  
! The module supports two versions of the data format: version 0 is the
! historical version, version 1 (new in Python 2.4) shares interned
! strings in the file, and upon unmarshalling. \var{Py_MARSHAL_VERSION}
! indicates the current file format (currently 1).
! 
! \begin{cfuncdesc}{void}{PyMarshal_WriteLongToFile}{long value, FILE *file, int version}
    Marshal a \ctype{long} integer, \var{value}, to \var{file}.  This
    will only write the least-significant 32 bits of \var{value};
    regardless of the size of the native \ctype{long} type.
+ 
+   \versionchanged[\var{version} indicates the file format]{2.4}
  \end{cfuncdesc}
  
  \begin{cfuncdesc}{void}{PyMarshal_WriteObjectToFile}{PyObject *value,
!                                                      FILE *file, int version}
    Marshal a Python object, \var{value}, to \var{file}.
+ 
+   \versionchanged[\var{version} indicates the file format]{2.4}
  \end{cfuncdesc}
  
! \begin{cfuncdesc}{PyObject*}{PyMarshal_WriteObjectToString}{PyObject *value, int version}
    Return a string object containing the marshalled representation of
    \var{value}.
+ 
+   \versionchanged[\var{version} indicates the file format]{2.4}
  \end{cfuncdesc}