[3.11] gh-112020: Document the meaning of empty bytes returned by socket.recv() (GH-112055) (GH-115723)

miss-islington · talcs · web-flow · commit 5a0d51b6291f · 2024-02-20T15:00:30.000Z
(cherry picked from commit e71468b) Co-authored-by: talcs <talh8787@gmail.com>
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
@@ -1506,8 +1506,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::
 
