Tom Lane wrote:
> Peter Eisentraut <[EMAIL PROTECTED]> 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
  [EMAIL PROTECTED]               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073

---------------------------(end of broadcast)---------------------------
TIP 6: Have you searched our list archives?

http://archives.postgresql.org

Reply via email to