Issue #19234: Documents socket.fileno() returns -1 on failure

diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
index 8cf4dbae05138cf92aa74c0cae604e34d05d1697..3aa1b138ca816dec39c389b2c7a538763053cbac 100644 (file)
--- a/Doc/library/socket.rst
+++ b/Doc/library/socket.rst
@@ -927,14 +927,13 @@ to sockets.
 
 .. method:: socket.fileno()
 
-   Return the socket's file descriptor (a small integer).  This is useful with
-   :func:`select.select`.
+   Return the socket's file descriptor (a small integer), or -1 on failure. This
+   is useful with :func:`select.select`.
 
    Under Windows the small integer returned by this method cannot be used where a
    file descriptor can be used (such as :func:`os.fdopen`).  Unix does not have
    this limitation.
 
-
 .. method:: socket.get_inheritable()
 
    Get the :ref:`inheritable flag <fd_inheritance>` of the socket's file