clarify by splitting into multiple paragraphs
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
index 1ee2875..a7e746e 100644
--- a/Doc/library/socket.rst
+++ b/Doc/library/socket.rst
@@ -276,11 +276,15 @@
.. function:: gethostname()
Return a string containing the hostname of the machine where the Python
- interpreter is currently executing. If you want to know the current machine's IP
- address, you may want to use ``gethostbyname(gethostname())``. This operation
- assumes that there is a valid address-to-host mapping for the host, and the
- assumption does not always hold. Note: :func:`gethostname` doesn't always return
- the fully qualified domain name; use ``getfqdn()`` (see above).
+ interpreter is currently executing.
+
+ If you want to know the current machine's IP address, you may want to use
+ ``gethostbyname(gethostname())``. This operation assumes that there is a
+ valid address-to-host mapping for the host, and the assumption does not
+ always hold.
+
+ Note: :func:`gethostname` doesn't always return the fully qualified domain
+ name; use ``getfqdn()`` (see above).
.. function:: gethostbyaddr(ip_address)