X-Original-To: pgsql-hackers-postgresql.org@localhost.postgresql.org Received: from localhost (av.hub.org [200.46.204.144]) by postgresql.org (Postfix) with ESMTP id 95F719DC9FA for ; Sat, 18 Feb 2006 15:49:23 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 86076-06 for ; Sat, 18 Feb 2006 15:49:23 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130]) by postgresql.org (Postfix) with ESMTP id 43E139DC9CD for ; Sat, 18 Feb 2006 15:49:21 -0400 (AST) Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1]) by sss.pgh.pa.us (8.13.1/8.13.1) with ESMTP id k1IJn8wv000456; Sat, 18 Feb 2006 14:49:08 -0500 (EST) To: Andrew Dunstan cc: Michael Fuhr , Martijn van Oosterhout , pgsql-hackers@postgresql.org Subject: Re: Config file for psql In-reply-to: <43F77788.1040603@dunslane.net> References: <20060218185222.GG20716@svana.org> <20060218191939.GA1064@winnie.fuhr.org> <43F77788.1040603@dunslane.net> Comments: In-reply-to Andrew Dunstan message dated "Sat, 18 Feb 2006 14:37:44 -0500" Date: Sat, 18 Feb 2006 14:49:08 -0500 Message-ID: <455.1140292148@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.11 required=5 tests=[AWL=0.110] X-Spam-Score: 0.11 X-Spam-Level: X-Archive-Number: 200602/719 X-Sequence-Number: 79857 Andrew Dunstan 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