Clean up some docstrings. Some docstrings didn't show their return
value; others were inconsistent in what to name the argument or return
value; a few module-global functions had "socket." in front of their
name, against convention.
diff --git a/Modules/socketmodule.c b/Modules/socketmodule.c
index a540a2a..29b6339 100644
--- a/Modules/socketmodule.c
+++ b/Modules/socketmodule.c
@@ -1110,7 +1110,7 @@
}
PyDoc_STRVAR(gettimeout_doc,
-"gettimeout()\n\
+"gettimeout() -> timeout\n\
\n\
Returns the timeout in floating seconds associated with socket \n\
operations. A timeout of None indicates that timeouts on socket \n\
@@ -1387,7 +1387,7 @@
}
PyDoc_STRVAR(connect_ex_doc,
-"connect_ex(address)\n\
+"connect_ex(address) -> errno\n\
\n\
This is like connect(address), but returns an error code (the errno value)\n\
instead of raising an exception when an error occurs.");
@@ -1787,7 +1787,7 @@
}
PyDoc_STRVAR(sendto_doc,
-"sendto(data[, flags], address)\n\
+"sendto(data[, flags], address) -> count\n\
\n\
Like send(data, flags) but allows specifying the destination address.\n\
For IP sockets, the address is a pair (hostaddr, port).");
@@ -2712,8 +2712,8 @@
}
PyDoc_STRVAR(getaddrinfo_doc,
-"socket.getaddrinfo(host, port [, family, socktype, proto, flags])\n\
- --> List of (family, socktype, proto, canonname, sockaddr)\n\
+"getaddrinfo(host, port [, family, socktype, proto, flags])\n\
+ -> list of (family, socktype, proto, canonname, sockaddr)\n\
\n\
Resolve host and port into addrinfo struct.");
@@ -2790,7 +2790,7 @@
}
PyDoc_STRVAR(getnameinfo_doc,
-"socket.getnameinfo(sockaddr, flags) --> (host, port)\n\
+"getnameinfo(sockaddr, flags) --> (host, port)\n\
\n\
Get host and port for a sockaddr.");
@@ -2809,7 +2809,7 @@
}
PyDoc_STRVAR(getdefaulttimeout_doc,
-"socket.getdefaulttimeout() -> None | float\n\
+"getdefaulttimeout() -> timeout\n\
\n\
Returns the default timeout in floating seconds for new socket objects.\n\
A value of None indicates that new socket objects have no timeout.\n\
@@ -2839,7 +2839,7 @@
}
PyDoc_STRVAR(setdefaulttimeout_doc,
-"socket.setdefaulttimeout(None | float)\n\
+"setdefaulttimeout(timeout)\n\
\n\
Set the default timeout in floating seconds for new socket objects.\n\
A value of None indicates that new socket objects have no timeout.\n\
@@ -3013,8 +3013,9 @@
*/
PyDoc_STRVAR(socket_doc,
-"Implementation module for socket operations. See the socket module\n\
-for documentation.");
+"Implementation module for socket operations.\n\
+\n\
+See the socket module for documentation.");
PyMODINIT_FUNC
init_socket(void)