[Python-checkins] python/dist/src/Doc/lib libmarshal.tex,1.23,1.24

[loewis at users.sourceforge.net]

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

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


Index: libmarshal.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libmarshal.tex,v
retrieving revision 1.23
retrieving revision 1.24
diff -C2 -d -r1.23 -r1.24
*** libmarshal.tex	14 May 2003 16:51:46 -0000	1.23
--- libmarshal.tex	27 Jun 2004 16:51:45 -0000	1.24
***************
*** 74,77 ****
--- 74,80 ----
    will also be written to the file.  The object will not be properly
    read back by \function{load()}.
+ 
+   \versionadded[The \var{version} argument indicates the data
+   format that \code{dumps} should use.]{2.4}
  \end{funcdesc}
  
***************
*** 87,95 ****
  \end{funcdesc}
  
! \begin{funcdesc}{dumps}{value}
    Return the string that would be written to a file by
    \code{dump(\var{value}, \var{file})}.  The value must be a supported
    type.  Raise a \exception{ValueError} exception if value has (or
    contains an object that has) an unsupported type.
  \end{funcdesc}
  
--- 90,101 ----
  \end{funcdesc}
  
! \begin{funcdesc}{dumps}{value\optional{, version}}
    Return the string that would be written to a file by
    \code{dump(\var{value}, \var{file})}.  The value must be a supported
    type.  Raise a \exception{ValueError} exception if value has (or
    contains an object that has) an unsupported type.
+ 
+   \versionadded[The \var{version} argument indicates the data
+   format that \code{dumps} should use.]{2.4}
  \end{funcdesc}
  
***************
*** 99,100 ****
--- 105,116 ----
    \exception{TypeError}.  Extra characters in the string are ignored.
  \end{funcdesc}
+ 
+ In addition, the following constants are defined:
+ 
+ \begin{datadesc}{version}
+   Indicates the format that the module uses. Version 0 is the
+   historical format, version 1 (added in Python 2.4) shares
+   interned strings. The current version is 1.
+ 
+   \versionadded{2.4}
+ \end{datadesc}
\ No newline at end of file