[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