changeset: 76500:f24d8dc1a986 branch: 2.7 user: Sandro Tosi date: Mon Apr 23 19:44:51 2012 +0200 files: Doc/howto/sockets.rst description: Issue #14641: minor fixes to sockets Howto; patch by Dionysios Kalofonos diff -r 501651b93cb0 -r f24d8dc1a986 Doc/howto/sockets.rst --- a/Doc/howto/sockets.rst Mon Apr 23 13:27:11 2012 -0400 +++ b/Doc/howto/sockets.rst Mon Apr 23 19:44:51 2012 +0200 @@ -156,7 +156,7 @@ there, you may wait forever for the reply, because the request may still be in your output buffer. -Now we come the major stumbling block of sockets - ``send`` and ``recv`` operate +Now we come to the major stumbling block of sockets - ``send`` and ``recv`` operate on the network buffers. They do not necessarily handle all the bytes you hand them (or expect from them), because their major focus is handling the network buffers. In general, they return when the associated network buffers have been @@ -167,7 +167,7 @@ When a ``recv`` returns 0 bytes, it means the other side has closed (or is in the process of closing) the connection. You will not receive any more data on this connection. Ever. You may be able to send data successfully; I'll talk -about that some on the next page. +more about this later. A protocol like HTTP uses a socket for only one transfer. The client sends a request, then reads a reply. That's it. The socket is discarded. This means that