Adjust libpq docs to be clearer about 'hostaddr' usage by rewording and

using an itemized list.

diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index e78d70828e17eaafcd57f7bec180e7ec5ff89746..38245886a77edafaf282b45eda03c33087207b2b 100644 (file)
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -164,22 +164,36 @@ PGconn *PQconnectdbParams(const char **keywords, const char **values, int expand
            Using hostaddr instead of host allows the
            application to avoid a host name look-up, which might be important
            in applications with time constraints. However, a host name is
-           required for Kerberos, GSSAPI, or SSPI authentication, as well as
-           for full SSL certificate verification. The following rules are
-           used:
-           If host is specified without hostaddr,
-           a host name lookup occurs.
-           If hostaddr is specified without host,
-           the value for hostaddr gives the server network address.
-           The connection attempt will fail in any of the cases where a
-           host name is required.
-           If both host and hostaddr are specified,
-           the value for hostaddr gives the server network address.
-           The value for host is ignored unless needed for
-           authentication or verification purposes, in which case it will be
-           used as the host name.  Note that authentication is likely to fail
-           if host is not the name of the machine at
-           hostaddr.
+           required for Kerberos, GSSAPI, or SSPI authentication
+           methods, as well as for verify-full SSL
+           certificate verification.  The following rules are used:
+           
+            
+             
+              If host is specified without hostaddr,
+              a host name lookup occurs.
+             
+            
+            
+             
+              If hostaddr is specified without host,
+              the value for hostaddr gives the server network address.
+              The connection attempt will fail if the authentication
+              method requires a host name.
+             
+            
+            
+             
+              If both host and hostaddr are specified,
+              the value for hostaddr gives the server network address.
+              The value for host is ignored unless the
+              authentication method requires it, in which case it will be
+              used as the host name.  
+             
+            
+           
+           Note that authentication is likely to fail if host
+           is not the name of the server at network address hostaddr.
            Also, note that host rather than hostaddr
            is used to identify the connection in ~/.pgpass (see
            ).