[Python-checkins] CVS: python/dist/src/Doc/lib libstdtypes.tex,1.52,1.53

Eric S. Raymond esr@users.sourceforge.net
Sun, 18 Mar 2001 03:28:00 -0800


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

Modified Files:
	libstdtypes.tex 
Log Message:
Teach Tools/freeze/makeconfig.py and Tools/freeze/parsesetup.py to use
the re package rather than the obsolete regex.


Index: libstdtypes.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libstdtypes.tex,v
retrieving revision 1.52
retrieving revision 1.53
diff -C2 -r1.52 -r1.53
*** libstdtypes.tex	2001/02/27 03:32:35	1.52
--- libstdtypes.tex	2001/03/18 11:27:57	1.53
***************
*** 1216,1219 ****
--- 1216,1237 ----
  \end{methoddesc}
  
+ \begin{methoddesc}[file]{waiting}{}
+   Return the number of bytes waiting to be read from this file object.
+   For regular files, this returns the size of the file in bytes minus
+   the current seek address, as would be returned by \method{tell()}; a
+   zero return can be used to detect EOF.  For streams such as FIFOs,
+   sockets, Unix ttys, and other Unix character devices, this method
+   returns the number of bytes currently buffered up and waiting to be
+   read.  Attempts to call this method on Unix block devices or
+   on directories will raise an error.
+ 	\footnote{The \method{waiting()} method uses
+   	\cfunction{fstat(2)} and \cfunction{lseek(2)} on plain files;
+   	these should be reliable on all of Unix, Windows, and MacOS.
+   	It uses the FIONREAD ioctl(2) call to query FIFOs, sockets,
+   	Unix ttys, and other POSIX character devices; FIFO and socket
+   	behavior should be consistent across all three platforms, but
+   	the results from querying other character devices may vary.}
+ \end{methoddesc}
+ 
  \begin{methoddesc}[file]{write}{str}
    Write a string to the file.  There is no return value.  Note: Due to