Re: Fwd: Bug#308535: postgresql-client: [psql] manual page does not document ~/.pgpass file

From: Martin Pitt <mpitt(at)debian(dot)org>
To: PostgreSQL Bugs <pgsql-bugs(at)postgresql(dot)org>
Subject: Re: Fwd: Bug#308535: postgresql-client: [psql] manual page does not document ~/.pgpass file
Date: 2005-05-13 16:07:08
Message-ID: 20050513160708.GA2597@piware.de
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-bugs pgsql-docs

Hi!

Tom Lane [2005-05-13 9:49 -0400]:
> Martin Pitt <mpitt(at)debian(dot)org> writes:
> > We recently got the bug report below. Do you agree that documenting
> > ~/.pgpass in psql(1) is a good idea?
>
> On that theory we'd have to replicate large parts of the libpq
> documentation on every one of the "client application" pages,
> which doesn't seem very maintainable. (.pgpass is just the tip
> of the iceberg; the "environment variables" and "SSL support"
> pages are also pretty critical for users to know about.)
>
> I agree that there needs to be some more prominent mention,
> but this doesn't look like the way to do it. Maybe some
> "see also" links?

A prominent pointer (URL and hint to local documentation) would
certainly be adequate then.

Thanks and have a nice weekend!

Martin

--
Martin Pitt http://www.piware.de
Ubuntu Developer http://www.ubuntulinux.org
Debian Developer http://www.debian.org

In response to

Browse pgsql-bugs by date

  From Date Subject
Next Message David Walker 2005-05-13 16:09:00 Re: initdb fails on ultra2. followup
Previous Message Tom Lane 2005-05-13 13:49:27 Re: Fwd: Bug#308535: postgresql-client: [psql] manual page does not document ~/.pgpass file

Browse pgsql-docs by date

  From Date Subject
Next Message Andrew Sullivan 2005-05-13 21:07:35 Re: Whence the Opterons?
Previous Message Tom Lane 2005-05-13 13:49:27 Re: Fwd: Bug#308535: postgresql-client: [psql] manual page does not document ~/.pgpass file