docs/usocket: Describe address format once at the beginning.

pfalcon · pfalcon · commit 0d10e5310a7e · 2016-04-23T00:31:05.000+03:00
Different ports may have different formats.
diff --git a/docs/library/usocket.rst b/docs/library/usocket.rst
@@ -10,6 +10,15 @@ This module provides access to the BSD socket interface.
 See corresponding `CPython module <https://docs.python.org/3/library/socket.html>`_ for
 comparison.
 
+Socket address format(s)
+------------------------
+
+Functions below which expect a network address, accept it in the format of
+`(ipv4_address, port)`, where `ipv4_address` is a string with dot-notation numeric
+IPv4 address, e.g. ``"8.8.8.8"``, and port is integer port number in the range
+1-65535. Note the domain names are not accepted as `ipv4_address`, they should be
+resolved first using ``socket.getaddrinfo()``.
+
 Functions
 ---------
 
@@ -85,8 +94,7 @@ Methods
 
     .. method:: socket.bind(address)
 
-       Bind the socket to address. The socket must not already be bound. The format of ``address``
-       is: ``(ipv4 address, port)``
+       Bind the socket to address. The socket must not already be bound.
 
     .. method:: socket.listen([backlog])
 
@@ -104,7 +112,7 @@ Methods
 
     .. method:: socket.connect(address)
 
-       Connect to a remote socket at address. The format of address is: ``(ipv4 address, port)``
+       Connect to a remote socket at address.
 
     .. method:: socket.send(bytes)
 
@@ -122,8 +130,7 @@ Methods
     .. method:: socket.sendto(bytes, address)
 
        Send data to the socket. The socket should not be connected to a remote socket, since the
-       destination socket is specified by address. The ``address`` has the same format as the
-       rest of the methods, see above.
+       destination socket is specified by `address`.
 
     .. method:: socket.recvfrom(bufsize)
 
