diff Doc/lib/libsocket.tex @ 12230:7bf8b10ce2ab legacy-trunk

Added notes about the eventual disappearance of two-parameter bind(), connect(), and connect_ex(). I didn't make these deprecation notices since it was never a documented feature.
author Fred Drake <fdrake@acm.org>
date Tue, 04 Apr 2000 17:48:30 +0000
parents e82e82b3b9ad
children 8bcd14313c11
line wrap: on
line diff
--- a/Doc/lib/libsocket.tex	Tue Apr 04 15:09:07 2000 +0000
+++ b/Doc/lib/libsocket.tex	Tue Apr 04 17:48:30 2000 +0000
@@ -247,7 +247,11 @@
 
 \begin{methoddesc}[socket]{bind}{address}
 Bind the socket to \var{address}.  The socket must not already be bound.
-(The format of \var{address} depends on the address family --- see above.)
+(The format of \var{address} depends on the address family --- see
+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}
 
 \begin{methoddesc}[socket]{close}{}
@@ -259,7 +263,10 @@
 \begin{methoddesc}[socket]{connect}{address}
 Connect to a remote socket at \var{address}.
 (The format of \var{address} depends on the address family --- see
-above.)
+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}
 
 \begin{methoddesc}[socket]{connect_ex}{address}
@@ -269,6 +276,10 @@
 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.
+This was never intentional and will no longer be available in Python
+1.7.
 \end{methoddesc}
 
 \begin{methoddesc}[socket]{fileno}{}