#8320: document return value of recv_into().
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
index 98dcceb..6733156 100644
--- a/Doc/library/socket.rst
+++ b/Doc/library/socket.rst
@@ -669,10 +669,10 @@
.. method:: socket.recv_into(buffer[, nbytes[, flags]])
Receive up to *nbytes* bytes from the socket, storing the data into a buffer
- rather than creating a new string. If *nbytes* is not specified (or 0),
- receive up to the size available in the given buffer. See the Unix manual page
- :manpage:`recv(2)` for the meaning of the optional argument *flags*; it defaults
- to zero.
+ rather than creating a new string. If *nbytes* is not specified (or 0),
+ receive up to the size available in the given buffer. Returns the number of
+ bytes received. See the Unix manual page :manpage:`recv(2)` for the meaning
+ of the optional argument *flags*; it defaults to zero.
.. versionadded:: 2.5