Re: explaining "context" column of pg_settings - Mailing list pgsql-docs

From Tom Lane
Subject Re: explaining "context" column of pg_settings
Date
Msg-id 1477.1292605112@sss.pgh.pa.us
Whole thread Raw
In response to Re: explaining "context" column of pg_settings  (Alvaro Herrera <alvherre@commandprompt.com>)
List pgsql-docs
Alvaro Herrera <alvherre@commandprompt.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

pgsql-docs by date:

Previous
From: Fujii Masao
Date:
Subject: Re: Obsolete description in pg_ctl-ref.sgml
Next
From: Euler Taveira de Oliveira
Date:
Subject: Re: explaining "context" column of pg_settings