From eea36f661c6efbb27258f1ed68dffa5f1ecb0914 Mon Sep 17 00:00:00 2001
From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Mon, 28 Apr 2003 19:30:49 +0000
Subject: [PATCH] Minor wordsmithing on .pgpass description.

---
 doc/src/sgml/libpq.sgml | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index b8499f0232..bff6f294f4 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