pythongh-112020: Document the meaning of empty bytes returned by socket.recv() (pythonGH-112055)

talcs · diegorusso · commit 39bb8a52fce1 · 2024-04-17T11:30:24.000+01:00
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
@@ -1605,8 +1605,9 @@ to sockets.
 
    Receive data from the socket.  The return value is a bytes object representing the
    data received.  The maximum amount of data to be received at once is specified
-   by *bufsize*.  See the Unix manual page :manpage:`recv(2)` for the meaning of
-   the optional argument *flags*; it defaults to zero.
+   by *bufsize*. A returned empty bytes object indicates that the client has disconnected.
+   See the Unix manual page :manpage:`recv(2)` for the meaning of the optional argument
+   *flags*; it defaults to zero.
 
    .. note::
 
