From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Michael Schmidt <michaelmschmidt@msn.com>
Cc: PostgreSQL General <pgsql-general@postgresql.org>
Cc: pgsql-docs@postgresql.org
Subject: Re: [GENERAL] Password issue revisited
Date: Tue, 20 Feb 2007 13:15:44 -0500 (EST)
Message-ID: <200702201815.l1KIFis12465@momjian.us> (raw)
In-Reply-To: <15855.1170007901@sss.pgh.pa.us>
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. +
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: bruce@momjian.us, tgl@sss.pgh.pa.us, michaelmschmidt@msn.com, pgsql-general@postgresql.org
Subject: Re: [GENERAL] Password issue revisited
In-Reply-To: <200702201815.l1KIFis12465@momjian.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox