[Python-checkins] CVS: python/dist/src/Doc/lib libsocket.tex,1.51,1.51.4.1

[Fred L. Drake]

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

Modified Files:
      Tag: release21-maint
	libsocket.tex 
Log Message:
Add notes that fromfd() and s.makefile() are Unix-specific.
This fixes SF bug #495896.

Fix up various markup consistency & style guide conformance nits.


Index: libsocket.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libsocket.tex,v
retrieving revision 1.51
retrieving revision 1.51.4.1
diff -C2 -d -r1.51 -r1.51.4.1
*** libsocket.tex	2001/01/10 19:34:52	1.51
--- libsocket.tex	2001/12/21 17:44:43	1.51.4.1
***************
*** 115,119 ****
  \begin{funcdesc}{gethostbyname}{hostname}
  Translate a host name to IP address format.  The IP address is
! returned as a string, e.g.,  \code{'100.50.200.5'}.  If the host name
  is an IP address itself it is returned unchanged.  See
  \function{gethostbyname_ex()} for a more complete interface.
--- 115,119 ----
  \begin{funcdesc}{gethostbyname}{hostname}
  Translate a host name to IP address format.  The IP address is
! returned as a string, such as \code{'100.50.200.5'}.  If the host name
  is an IP address itself it is returned unchanged.  See
  \function{gethostbyname_ex()} for a more complete interface.
***************
*** 151,155 ****
  
  \begin{funcdesc}{getprotobyname}{protocolname}
! Translate an Internet protocol name (e.g.\ \code{'icmp'}) to a constant
  suitable for passing as the (optional) third argument to the
  \function{socket()} function.  This is usually only needed for sockets
--- 151,155 ----
  
  \begin{funcdesc}{getprotobyname}{protocolname}
! Translate an Internet protocol name (for example, \code{'icmp'}) to a constant
  suitable for passing as the (optional) third argument to the
  \function{socket()} function.  This is usually only needed for sockets
***************
*** 181,186 ****
  descriptor is invalid.  This function is rarely needed, but can be
  used to get or set socket options on a socket passed to a program as
! standard input or output (e.g.\ a server started by the \UNIX{} inet
  daemon).
  \end{funcdesc}
  
--- 181,187 ----
  descriptor is invalid.  This function is rarely needed, but can be
  used to get or set socket options on a socket passed to a program as
! standard input or output (such as a server started by the \UNIX{} inet
  daemon).
+ Availability: \UNIX.
  \end{funcdesc}
  
***************
*** 210,215 ****
  
  \begin{funcdesc}{inet_aton}{ip_string}
! Convert an IP address from dotted-quad string format
! (e.g.\ '123.45.67.89') to 32-bit packed binary format, as a string four
  characters in length.
  
--- 211,216 ----
  
  \begin{funcdesc}{inet_aton}{ip_string}
! Convert an IP address from dotted-quad string format (for example,
! '123.45.67.89') to 32-bit packed binary format, as a string four
  characters in length.
  
***************
*** 227,231 ****
  Convert a 32-bit packed IP address (a string four characters in
  length) to its standard dotted-quad string representation
! (e.g. '123.45.67.89').
  
  Useful when conversing with a program that uses the standard C library
--- 228,232 ----
  Convert a 32-bit packed IP address (a string four characters in
  length) to its standard dotted-quad string representation
! (for example, '123.45.67.89').
  
  Useful when conversing with a program that uses the standard C library
***************
*** 293,297 ****
  can still raise exceptions).  The error indicator is \code{0} if the
  operation succeeded, otherwise the value of the \cdata{errno}
! variable.  This is useful, e.g., for asynchronous connects.
  \strong{Note:}  This method has historically accepted a pair of
  parameters for \constant{AF_INET} addresses instead of only a tuple.
--- 294,298 ----
  can still raise exceptions).  The error indicator is \code{0} if the
  operation succeeded, otherwise the value of the \cdata{errno}
! variable.  This is useful to support, for example, asynchronous connects.
  \strong{Note:}  This method has historically accepted a pair of
  parameters for \constant{AF_INET} addresses instead of only a tuple.
***************
*** 345,349 ****
  \index{I/O control!buffering}The optional \var{mode}
  and \var{bufsize} arguments are interpreted the same way as by the
! built-in \function{open()} function.
  \end{methoddesc}
  
--- 346,352 ----
  \index{I/O control!buffering}The optional \var{mode}
  and \var{bufsize} arguments are interpreted the same way as by the
! built-in \function{open()} function; see ``Built-in Functions''
! (section \ref{built-in-funcs}) for more information.
! Availability: \UNIX.
  \end{methoddesc}