Mention limited usefulness of .pgpass database field.

diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 70d9202e50da968242d8e5e214e742fc4de2d9e6..a911c500d31451c51f3e6253dc8a8d7f6c6b6389 100644 (file)
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -6331,6 +6331,8 @@ myEventProc(PGEventId evtId, void *evtInfo, void *passThrough)
    or the default socket directory) connections coming from the local
    machine. In a standby server, a database name of <literal>replication</>
    matches streaming replication connections made to the master server.
+   The <literal>database</> field is of limited usefulness because
+   users have the same password for all databases in the same cluster.
   </para>
 
   <para>