Clarify description of CIDR-address column of pg_hba.conf, to discourage

people from trying notations like '10.6/16', which is accepted but does
not mean what you probably think.  Per example from Paul Forgey.

diff --git a/doc/src/sgml/client-auth.sgml b/doc/src/sgml/client-auth.sgml
index a77d89db0e54985775d629aa0d490b9bd98f98d8..f418332a395f2e69fe64380c003a6b5ba8fb7873 100644 (file)
--- a/doc/src/sgml/client-auth.sgml
+++ b/doc/src/sgml/client-auth.sgml
@@ -1,4 +1,4 @@
-
+
 
 
  Client Authentication
@@ -226,11 +226,12 @@ hostnossl  database  user
       
 
       
-       A typical CIDR-address is
+       Typical examples of a CIDR-address are
        172.20.143.89/32 for a single host, or
-       172.20.143.0/24 for a network.
+       172.20.143.0/24 for a small network, or
+       10.6.0.0/16 for a larger one.
        To specify a single host, use a CIDR mask of 32 for IPv4 or
-       128 for IPv6.
+       128 for IPv6.  In a network address, do not omit trailing zeroes.