clarify by splitting into multiple paragraphs

This commit is contained in:
Benjamin Peterson 2008-11-03 20:43:20 +00:00
parent b9828f67b8
commit accb38c74f
1 changed files with 9 additions and 5 deletions

View File

@ -276,11 +276,15 @@ The module :mod:`socket` exports the following constants and functions:
.. function:: gethostname() .. function:: gethostname()
Return a string containing the hostname of the machine where the Python 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 interpreter is currently executing.
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 If you want to know the current machine's IP address, you may want to use
assumption does not always hold. Note: :func:`gethostname` doesn't always return ``gethostbyname(gethostname())``. This operation assumes that there is a
the fully qualified domain name; use ``getfqdn()`` (see above). 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) .. function:: gethostbyaddr(ip_address)