Fix doc strings

Author: nanjekyejoannah

Doc/library/socket.rst

@@ -1567,6 +1567,7 @@ to sockets.
 .. method:: socket.send_fds(sock, buffers, fds[, flags[, address]])
 
    Send the list of file descriptors *fds* over an :const:`AF_UNIX` socket.
+   The *fds* parameter is a sequence of file descriptors.
    Consult :meth:`sendmsg` for the documentation of these parameters.
 
    .. availability:: Unix supporting :meth:`~socket.sendmsg` and :const:`SCM_RIGHTS` mechanism.
@@ -1578,7 +1579,7 @@ to sockets.
    Receive up to *maxfds* file descriptors. Return ``(msg, list(fds), flags, addr)``. Consult
    :meth:`recvmsg` for the documentation of these parameters.
 
-   .. availability:: Unix supporting :meth:`~socket.sendmsg` and :const:`SCM_RIGHTS` mechanism.
+   .. availability:: Unix supporting :meth:`~socket.recvmsg` and :const:`SCM_RIGHTS` mechanism.
 
    .. versionadded:: 3.9
 

Lib/socket.py

@@ -469,7 +469,7 @@ def fromfd(fd, family, type, proto=0):
     import array
 
     def send_fds(sock, buffers, fds, flags=0, address=None):
-        """ send_fds(sock, buffers, fds[, flags[, address]]) -> socket object
+        """ send_fds(sock, buffers, fds[, flags[, address]]) -> integer
 
         Send the list of file descriptors fds over an AF_UNIX socket.
         """
@@ -481,9 +481,10 @@ def send_fds(sock, buffers, fds, flags=0, address=None):
     import array
 
     def recv_fds(sock, bufsize, maxfds, flags=0):
-        """ recv_fds(sock, bufsize, maxfds[, flags]) -> (socket object, socket object)
+        """ recv_fds(sock, bufsize, maxfds[, flags]) -> (data, list of file
+        descriptors, msg_flags, address)
 
-        receive up to maxfds file descriptors returning the message
+        Receive up to maxfds file descriptors returning the message
         data and a list containing the descriptors.
         """
         # Array of ints

Lib/test/test_socket.py

@@ -6279,7 +6279,7 @@ def close_fds(fds):
         with sock1, sock2:
             socket.send_fds(sock1, [MSG], fds)
             # request more data and file descriptors than expected
-            msg, fds2, flags, addr  = socket.recv_fds(sock2, len(MSG) * 2, len(fds) * 2)
+            msg, fds2, flags, addr = socket.recv_fds(sock2, len(MSG) * 2, len(fds) * 2)
             self.addCleanup(close_fds, fds2)
 
         self.assertEqual(msg, MSG)