<!--
-$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">
<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