From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Josh Kupershmidt <schmiddy@gmail.com>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: explaining "context" column of pg_settings
Date: Fri, 11 Mar 2011 11:03:25 -0500 (EST)
Message-ID: <201103111603.p2BG3PJ01892@momjian.us> (raw)
In-Reply-To: <17754.1292544709@sss.pgh.pa.us>
I am unclear where to put this as well so I suggest we just put it in
catalogs.sgml and be done with it.
---------------------------------------------------------------------------
Tom Lane wrote:
> Josh Kupershmidt <schmiddy@gmail.com> writes:
> > The six different kinds of contexts in the pg_settings system view
> > aren't terribly well documented. The current doc page says only:
> > "Context required to set the parameter's value". A search through the
> > archives turned up only a brief explanation[1] of what "postmaster"
> > means for this setting. The recent book "PostgreSQL 9.0 High
> > Performance"[2] complains "The context field isn't documented very
> > well in the official manual."
>
> > I've put together a patch to help document these values based on the
> > comments in guc.h, the explanations in [2], and my own understanding.
> > My crude explanations could probably use some further wordsmithing and
> > check for accuracy :-)
>
> 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?
>
> > I avoided just copy-pasting from guc.h, particulary because some of
> > the explanations struck me as confusing or incorrect.
>
> Well, your replacement explanations seemed even less correct ;-).
> Also, I think what the text needs to emphasize is *how* to change
> each setting type, so that prompted some of my editing.
>
> regards, tom lane
>
Content-Description: guc-context-docs-2.patch
>
> --
> Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
> To make changes to your subscription:
> http://www.postgresql.org/mailpref/pgsql-docs
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ It's impossible for everything to be true. +
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: bruce@momjian.us, tgl@sss.pgh.pa.us, schmiddy@gmail.com
Subject: Re: explaining "context" column of pg_settings
In-Reply-To: <201103111603.p2BG3PJ01892@momjian.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox