[Python-checkins] CVS: python/dist/src/Doc/lib libascii.tex,1.6,1.7 libcookie.tex,1.3,1.4 libsocket.tex,1.50,1.51 libstat.tex,1.19,1.20

[Eric S. Raymond]

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

Modified Files:
	libascii.tex libcookie.tex libsocket.tex libstat.tex 
Log Message:
SourceForge patch #103140, checked in at fdrake's invitation. Minor fixes and
additions to library docs.#


Index: libascii.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libascii.tex,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -r1.6 -r1.7
*** libascii.tex	2000/12/26 16:09:37	1.6
--- libascii.tex	2001/01/10 19:34:52	1.7
***************
*** 54,58 ****
  \end{tableii}
  
! Note that many of these have little practical use in modern usage.
  
  The module supplies the following functions, patterned on those in the
--- 54,60 ----
  \end{tableii}
  
! Note that many of these have little practical significance in modern
! usage.  The mnemonics derive from teleprinter conventions that predate
! digital computers.
  
  The module supplies the following functions, patterned on those in the

Index: libcookie.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libcookie.tex,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -r1.3 -r1.4
*** libcookie.tex	2000/08/20 23:33:50	1.3
--- libcookie.tex	2001/01/10 19:34:52	1.4
***************
*** 9,13 ****
  
  The \module{Cookie} module defines classes for abstracting the concept of 
! cookies, an HTTP state management mechanism. It supports both simplistic
  string-only cookies, and provides an abstraction for having any serializable
  data-type as cookie value.
--- 9,13 ----
  
  The \module{Cookie} module defines classes for abstracting the concept of 
! cookies, an HTTP state management mechanism. It supports both simple
  string-only cookies, and provides an abstraction for having any serializable
  data-type as cookie value.

Index: libsocket.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libsocket.tex,v
retrieving revision 1.50
retrieving revision 1.51
diff -C2 -r1.50 -r1.51
*** libsocket.tex	2000/10/10 20:36:29	1.50
--- libsocket.tex	2001/01/10 19:34:52	1.51
***************
*** 268,273 ****
  above.)  \strong{Note:}  This method has historically accepted a pair
  of parameters for \constant{AF_INET} addresses instead of only a
! tuple.  This was never intentional and will no longer be available in
! Python 1.7.
  \end{methoddesc}
  
--- 268,273 ----
  above.)  \strong{Note:}  This method has historically accepted a pair
  of parameters for \constant{AF_INET} addresses instead of only a
! tuple.  This was never intentional and is no longer be available in
! Python 2.0.
  \end{methoddesc}
  
***************
*** 283,288 ****
  above.)  \strong{Note:}  This method has historically accepted a pair
  of parameters for \constant{AF_INET} addresses instead of only a
! tuple.  This was never intentional and will no longer be available in
! Python 1.7.
  \end{methoddesc}
  
--- 283,288 ----
  above.)  \strong{Note:}  This method has historically accepted a pair
  of parameters for \constant{AF_INET} addresses instead of only a
! tuple.  This was never intentional and is no longer available in
! Python 2.0 and later.
  \end{methoddesc}
  
***************
*** 296,301 ****
  \strong{Note:}  This method has historically accepted a pair of
  parameters for \constant{AF_INET} addresses instead of only a tuple.
! This was never intentional and will no longer be available in Python
! 1.7.
  \end{methoddesc}
  
--- 296,301 ----
  \strong{Note:}  This method has historically accepted a pair of
  parameters for \constant{AF_INET} addresses instead of only a tuple.
! This was never intentional and is no longer be available in Python
! 2.0 and later.
  \end{methoddesc}
  

Index: libstat.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libstat.tex,v
retrieving revision 1.19
retrieving revision 1.20
diff -C2 -r1.19 -r1.20
*** libstat.tex	1999/08/03 21:52:29	1.19
--- libstat.tex	2001/01/10 19:34:52	1.20
***************
*** 98,102 ****
  
  \begin{datadesc}{ST_SIZE}
! File size in bytes.
  \end{datadesc}
  
--- 98,103 ----
  
  \begin{datadesc}{ST_SIZE}
! Size in bytes of a plain file; amount of data waiting on some special
! files.
  \end{datadesc}
  
***************
*** 112,115 ****
--- 113,126 ----
  Time of last status change (see manual pages for details).
  \end{datadesc}
+ 
+ The interpretation of ``file size'' changes according to the file
+ type.  For plain files this is the size of the file in bytes.  For
+ FIFOs and sockets under most Unixes (including Linux in particular),
+ the ``size'' is the number of bytes waiting to be read at the time of
+ the stat(2)/fstat(2)/lstat(2) call; this can sometimes be useful,
+ especially for polling one of these special files after a non-blocking
+ open.  The meaning of the size field for other character and block
+ devices varies more, depending on the local implementation of the
+ underlying system call.
  
  Example: