Skip site navigation (1) Skip section navigation (2)

Re: explaining "context" column of pg_settings

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
Cc: Josh Kupershmidt <schmiddy(at)gmail(dot)com>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: explaining "context" column of pg_settings
Date: 2010-12-17 16:58:32
Message-ID: (view raw, whole thread or download thread mbox)
Lists: pgsql-docs
Alvaro Herrera <alvherre(at)commandprompt(dot)com> writes:
> Excerpts from Tom Lane's message of jue dic 16 21:11:49 -0300 2010:
>> I did some work on this patch and attach an updated version.  I'm not
>> however convinced that it's a good idea to bury this material in
>> catalogs.sgml --- I think few people ever read that chapter.  Shouldn't
>> we put this into config.sgml instead, somewhere in section 18.1?

> Perhaps we can replace the current "this setting requires a restart"
> boilerplate with "this setting has context foo" in setting descriptions,
> and have a pointer to wherever the description of each context is.

Hm, that's a thought.  I've never been too happy with those boilerplate
sentences, mainly because they are of necessity brief and so don't
really convey all the implications.  "This setting has context foo" is
brief too, but it could be a link to someplace that's more verbose.

If we were starting from scratch I'd want to try to think of some other
word than "context" to use here, but we're probably stuck with that one
because it's what's used in the pg_settings view.

			regards, tom lane

In response to

pgsql-docs by date

Next:From: Euler Taveira de OliveiraDate: 2010-12-17 18:08:40
Subject: Re: explaining "context" column of pg_settings
Previous:From: Fujii MasaoDate: 2010-12-17 02:00:03
Subject: Re: Obsolete description in pg_ctl-ref.sgml

Privacy Policy | About PostgreSQL
Copyright © 1996-2018 The PostgreSQL Global Development Group