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

Sun Jun 27 12:51:47 EDT 2004

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