Message-ID: <54CD8FD6.4060306@gmx.net>
Date: Sat, 31 Jan 2015 21:30:46 -0500
From: Peter Eisentraut <peter_e@gmx.net>
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.10;
 rv:31.0) Gecko/20100101 Thunderbird/31.4.0
MIME-Version: 1.0
To: David Johnston <david.g.johnston@gmail.com>,
 "pgsql-docs@postgresql.org" <pgsql-docs@postgresql.org>
Subject: Re: Suggest adding reference to pg_db_role_setting in chapter
 18; expand catalog page
References: 
 <CAKFQuwaEcdoVNvFQPWtmdyVpronHLqAyvrgP8SRG=-7nXPrBog@mail.gmail.com>
In-Reply-To: 
 <CAKFQuwaEcdoVNvFQPWtmdyVpronHLqAyvrgP8SRG=-7nXPrBog@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

On 1/17/15 1:08 AM, David Johnston wrote:
> ​Attached is a patch that provides a link to the catalog page for
> pg_db_role_settings from config.sgml.  It also updates said catalog page
> to mention that the data from this catalog is available via psql \drds
> and also provides a query that will explode the setconfig column into
> its component parts - which \drds does not do.

I don't like different parts of the system fighting each other about
what is better.  If the exploded view is better, then we should change
\drds to show it.

> I am imagine there might be a reason that the catalog pages do not
> reference the relevant psql meta-commands, or provide human-friendly
> examples, but I cannot think of what that might be and so here I provide.

The catalog descriptions are in the "internals" part, so you'd only
arrive there if you know what you are doing.  If you want to learn about
user-facing tools such as psql or pgadmin, they have their own
documentation.


-- 
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs