From: | Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us> |
---|---|
To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | Peter Eisentraut <peter_e(at)gmx(dot)net>, mlw <pgsql(at)mohawksoft(dot)com>, Devrim GUNDUZ <devrim(at)tr(dot)net>, pgsql-hackers(at)postgresql(dot)org |
Subject: | Re: PostgreSQL Password Cracker |
Date: | 2003-01-02 23:52:27 |
Message-ID: | 200301022352.h02NqRG17316@candle.pha.pa.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
Tom Lane wrote:
> Peter Eisentraut <peter_e(at)gmx(dot)net> writes:
> > Bruce Momjian writes:
> >> Yes, I have been feeling we should do that. Justin pointed out just
> >> yesterday that .pgpass is only mentioned in libpq documentation, and in
> >> fact there is lots of stuff mentioned in libpq that releates to the
> >> other interfaces, so it should be pulled out and put in one place.
>
> > It is difficult to make out which place that would be. You can duplicate
> > the information in every place where an interface or tool that uses libpq
> > is documented, but that doesn't seem to be conceptually superior.
>
> Duplicating this info is clearly a losing proposition. But I think
> Bruce is envisioning restructuring the documentation of libpq to
> separate out the parts that are only interesting to a programmer using
> libpq from the parts that are interesting to a user of a libpq-based
> program (for example, all the info about environment variables, conninfo
> string syntax, and .pgpass). Then the docs for interfaces and tools
> could cross-reference the "externally visible behavior" section of the
> libpq docs --- and this section would make sense to an end user,
> without drowning him in details he doesn't care about.
Right. I think as a minimum, we need to move the libpq environment
variables and, as Justin said, the .pgpass stuff out into its own
section, and reference that from libpq and other
interfaces/applications. We have had several reports of folks not
knowing it, and it is obvious is it because the info is inside a C
library API chapter.
--
Bruce Momjian | http://candle.pha.pa.us
pgman(at)candle(dot)pha(dot)pa(dot)us | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2003-01-03 00:26:06 | Re: Upgrading rant. |
Previous Message | Bruce Momjian | 2003-01-02 23:49:43 | Re: PostgreSQL Password Cracker |