[Python-checkins] CVS: python/dist/src/Doc/lib libselect.tex,1.16,1.17

[Fred L. Drake]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory slayer.i.sourceforge.net:/tmp/cvs-serv10901/lib

Modified Files:
	libselect.tex 
Log Message:

select.select():  Add note that though this function accepts empty lists,
                  using *only* empty lists may not be acceptable on all
                  platforms, with the specific caveat that it does not
                  work on Windows.  Also clarified list of acceptable
                  objects that may be in the lists, to let the user know
                  that file objects are not usable here on Windows.


Index: libselect.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libselect.tex,v
retrieving revision 1.16
retrieving revision 1.17
diff -C2 -r1.16 -r1.17
*** libselect.tex	2000/08/25 01:21:28	1.16
--- libselect.tex	2000/12/11 15:50:07	1.17
***************
*** 34,45 ****
  This is a straightforward interface to the \UNIX{} \cfunction{select()}
  system call.  The first three arguments are lists of `waitable
! objects': either integers representing \UNIX{} file descriptors or
  objects with a parameterless method named \method{fileno()} returning
  such an integer.  The three lists of waitable objects are for input,
  output and `exceptional conditions', respectively.  Empty lists are
! allowed.  The optional \var{timeout} argument specifies a time-out as a
! floating point number in seconds.  When the \var{timeout} argument
! is omitted the function blocks until at least one file descriptor is
! ready.  A time-out value of zero specifies a poll and never blocks.
  
  The return value is a triple of lists of objects that are ready:
--- 34,47 ----
  This is a straightforward interface to the \UNIX{} \cfunction{select()}
  system call.  The first three arguments are lists of `waitable
! objects': either integers representing file descriptors or
  objects with a parameterless method named \method{fileno()} returning
  such an integer.  The three lists of waitable objects are for input,
  output and `exceptional conditions', respectively.  Empty lists are
! allowed, but acceptance of three empty lists is platform-dependent.
! (It is known to work on \UNIX{} but not on Windows.)  The optional
! \var{timeout} argument specifies a time-out as a floating point number
! in seconds.  When the \var{timeout} argument is omitted the function
! blocks until at least one file descriptor is ready.  A time-out value
! of zero specifies a poll and never blocks.
  
  The return value is a triple of lists of objects that are ready:
***************
*** 53,64 ****
  returned by \function{socket.socket()},%
  \withsubitem{(in module socket)}{\ttindex{socket()}}
! \withsubitem{(in module os)}{\ttindex{popen()}}
! and the module \module{stdwin}\refbimodindex{stdwin} which happens to
! define a function
! \function{fileno()}\withsubitem{(in module stdwin)}{\ttindex{fileno()}}
! for just this purpose.  You may
! also define a \dfn{wrapper} class yourself, as long as it has an
! appropriate \method{fileno()} method (that really returns a \UNIX{}
! file descriptor, not just a random integer).
  \end{funcdesc}
  
--- 55,66 ----
  returned by \function{socket.socket()},%
  \withsubitem{(in module socket)}{\ttindex{socket()}}
! \withsubitem{(in module os)}{\ttindex{popen()}}.
! You may also define a \dfn{wrapper} class yourself, as long as it has
! an appropriate \method{fileno()} method (that really returns a file
! descriptor, not just a random integer).
! \strong{Note:}\index{WinSock}  File objects on Windows are not
! acceptable, but sockets are.  On Windows, the underlying
! \cfunction{select()} function is provided by the WinSock library, and
! does not handle file desciptors that don't originate from WinSock.
  \end{funcdesc}