diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index b8499f02323..bff6f294f48 100644
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/libpq.sgml,v 1.121 2003/04/28 04:29:11 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/libpq.sgml,v 1.122 2003/04/28 19:30:49 tgl Exp $
 -->
 
  <chapter id="libpq">
@@ -2519,10 +2519,13 @@ This file should have lines of the following format:
 <synopsis>
 <replaceable>hostname</replaceable>:<replaceable>port</replaceable>:<replaceable>database</replaceable>:<replaceable>username</replaceable>:<replaceable>password</replaceable>
 </synopsis>
-Each of these fields may be a literal name or <literal>*</literal>, which
-matches anything.  The first matching entry will be used, so put more-specific
-entries first.  When an entry contain <literal>:</literal> or
-<literal>\</literal>, it must be escaped with <literal>\</literal>.
+Each of the first four fields may be a literal value, or <literal>*</literal>,
+which
+matches anything.  The password field from the first line that matches the
+current connection parameters will be used.  (Therefore, put more-specific
+entries first when you are using wildcards.)
+If an entry needs to contain <literal>:</literal> or
+<literal>\</literal>, escape this character with <literal>\</literal>.
 </para>
 <para>
 The permissions on <filename>.pgpass</filename> must disallow any