[Python-checkins] python/dist/src/Doc/lib libzlib.tex,1.27,1.28

[loewis@users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1:/tmp/cvs-serv12845

Modified Files:
	libzlib.tex 
Log Message:
Patch #640236: Better eplain unused data.


Index: libzlib.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libzlib.tex,v
retrieving revision 1.27
retrieving revision 1.28
diff -C2 -d -r1.27 -r1.28
*** libzlib.tex	16 Oct 2001 20:39:49 -0000	1.27
--- libzlib.tex	21 Jun 2003 14:15:25 -0000	1.28
***************
*** 124,137 ****
  
  \begin{memberdesc}{unused_data}
! A string which contains any unused data from the last string fed to
! this decompression object.  If the whole string turned out to contain
! compressed data, this is \code{""}, the empty string. 
  
  The only way to determine where a string of compressed data ends is by
  actually decompressing it.  This means that when compressed data is
  contained part of a larger file, you can only find the end of it by
! reading data and feeding it into a decompression object's
! \method{decompress} method until the \member{unused_data} attribute is
! no longer the empty string.  
  \end{memberdesc}
  
--- 124,138 ----
  
  \begin{memberdesc}{unused_data}
! A string which contains any bytes past the end of the compressed data.
! That is, this remains \code{""} until the last byte that contains
! compression data is available.  If the whole string turned out to
! contain compressed data, this is \code{""}, the empty string.
  
  The only way to determine where a string of compressed data ends is by
  actually decompressing it.  This means that when compressed data is
  contained part of a larger file, you can only find the end of it by
! reading data and feeding it followed by some non-empty string into a
! decompression object's \method{decompress} method until the
! \member{unused_data} attribute is no longer the empty string.
  \end{memberdesc}
  
***************
*** 139,144 ****
  A string that contains any data that was not consumed by the last
  \method{decompress} call because it exceeded the limit for the
! uncompressed data buffer.
  \end{memberdesc}
  
  \begin{methoddesc}[Decompress]{decompress}{string}{\optional{max_length}}
--- 140,149 ----
  A string that contains any data that was not consumed by the last
  \method{decompress} call because it exceeded the limit for the
! uncompressed data buffer.  This data has not yet been seen by the zlib
! machinery, so you must feed it (possibly with further data
! concatenated to it) back to a subsequent \method{decompress} method
! call in order to get correct output.
  \end{memberdesc}
+ 
  
  \begin{methoddesc}[Decompress]{decompress}{string}{\optional{max_length}}