[3.12] gh-112020: Document the meaning of empty bytes returned by socket.recv() ...

(cherry picked from commit e71468ba4f5fb2da0cefe9e923b01811cb53fb5f)

Co-authored-by: talcs <talh8787@gmail.com>

diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
index 4bfb0d8c2cfeacdf98b36f6693b3fafef79a0b12..dccf78ef8c0128f740b1e50d744ca770166bd144 100644 (file)
--- 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::