diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 70d9202..a911c50 100644
*** a/doc/src/sgml/libpq.sgml
--- b/doc/src/sgml/libpq.sgml
*************** myEventProc(PGEventId evtId, void *evtIn
*** 6331,6336 ****
--- 6331,6338 ----
     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>