Andrew Dunstan <andrew@dunslane.net> writes:
> This needs a LOT more prominence. We probably need to refer to these
> things on the manual pages for each of the libpq clients we have.
> Haven't we learned that lesson from .pgpass ? The number of people who
> read the libpq docs is probably vanishingly small.
Perhaps we should make a concerted effort to split the libpq docs into a
section "for programmers" vs one "for users", the latter part covering
the libpq behavior that is interesting to users of a libpq-based app.
.pgpass, pg_service, the environment vars, SSL behavior, maybe some
other things belong in the "for users" part.
I think only the environment-vars page is currently linked from the
client-apps reference pages, but if we did this we could link to the
entire for-users section and be done with it.
regards, tom lane