diff Doc/lib/libsocket.tex @ 31181:e5d97ab710a2 legacy-trunk

After hearing from someone who gave up on timeout sockets due to a mistake in his code, I'm adding a note explaining that you should call settimeout() before connect().
author Guido van Rossum <guido@python.org>
date Sat, 13 Dec 2003 22:12:53 +0000
parents bf038986cb8f
children 8f8bba0a75b4
line wrap: on
line diff
--- a/Doc/lib/libsocket.tex	Sat Dec 13 20:32:08 2003 +0000
+++ b/Doc/lib/libsocket.tex	Sat Dec 13 22:12:53 2003 +0000
@@ -625,6 +625,10 @@
 timeout or non-blocking mode file operations that cannot be completed
 immediately will fail.
 
+Note that the \method{connect()} operation is subject to the timeout
+setting, and in general it is recommended to call
+\method{settimeout()} before calling \method{connect()}.
+
 \begin{methoddesc}[socket]{setsockopt}{level, optname, value}
 Set the value of the given socket option (see the \UNIX{} manual page
 \manpage{setsockopt}{2}).  The needed symbolic constants are defined in