Received: from localhost (maia-5.hub.org [200.46.204.182])
	by postgresql.org (Postfix) with ESMTP id 479229FB653;
	Tue, 20 Feb 2007 14:15:56 -0400 (AST)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.204.182]) (amavisd-new, port 10024)
	with ESMTP id 28419-03; Tue, 20 Feb 2007 14:15:46 -0400 (AST)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.4
X-Greylist: from auto-whitelisted by SQLgrey-1.7.4
Received: from momjian.us (momjian.us [70.90.9.53])
	by postgresql.org (Postfix) with ESMTP id 008D29FB69F;
	Tue, 20 Feb 2007 14:15:46 -0400 (AST)
Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id
 l1KIFis12465;
	Tue, 20 Feb 2007 13:15:44 -0500 (EST)
From: Bruce Momjian <bruce@momjian.us>
Message-Id: <200702201815.l1KIFis12465@momjian.us>
Subject: Re: [GENERAL] Password issue revisited
In-Reply-To: <15855.1170007901@sss.pgh.pa.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Date: Tue, 20 Feb 2007 13:15:44 -0500 (EST)
CC: Michael Schmidt <michaelmschmidt@msn.com>,
	PostgreSQL General <pgsql-general@postgresql.org>,
	pgsql-docs@postgresql.org
X-Mailer: ELM [version 2.4ME+ PL123]
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=0.075 tagged_above=0 required=5 tests=AWL, BAYES_50,
	SPF_HELO_PASS, SPF_PASS
X-Spam-Level: 
X-Archive-Number: 200702/12
X-Sequence-Number: 4143

Tom Lane wrote:
> "Michael Schmidt" <michaelmschmidt@msn.com> writes:
> > ... Regarding how I concluded 
> > that PGPASSFILE was deprecated for pg_dump, I offer the following.
> 
> > 1.  The documentation for pg_dump in the manual (Section VI) includes a 
> > section labeled "Environment".  This lists PGDATABASE, PGHOST, PGPORT, 
> > and PGUSER.  It also says "default connection parameters" but there is 
> > no hyperlink or reference to another manual section to explain/define 
> > this term.
> 
> Yeah.  There is a link down in "See Also" but the incomplete
> "Environment" section of these man pages seems misleading.
> 
> Rather than try to maintain complete lists in each of the
> client-application man pages, I propose we remove those sections
> completely, and just rely on the See Also links to section 29.12.

I think we can conclude that adding libpq in the "See Also" section of
the documentation isn't sufficient.  I have removed that mention, and
added this text to the bottom of the "Environment" section for each
utility:

+    This utility, like most other <productname>PostgreSQL</> utilities,
+    also uses the environment variables supported by <xref
+    linkend="libpq-envars" endterm="libpq">.

I have backpatched this to 8.2.X.

-- 
  Bruce Momjian  <bruce@momjian.us>          http://momjian.us
  EnterpriseDB                               http://www.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +