public inbox for [email protected]  
help / color / mirror / Atom feed
From: Joe Conway <[email protected]>
To: Tom Lane <[email protected]>
Cc: PostgreSQL Patches <[email protected]>
Cc: [email protected]
Subject: Re: [PATCHES] pg_settings doc patch
Date: Sat, 31 Aug 2002 19:52:30 -0700
Message-ID: <[email protected]> (raw)
References: <[email protected]>
	<[email protected]>

Tom Lane wrote:
> pg_settings is not a system catalog, so I don't think it belongs in the
> system catalogs chapter.  In fact it doesn't belong anywhere in the
> Developer's Guide, since it's a user-oriented view.
> 
> I'm not sure where it *does* belong though :-(.  Right at the moment we
> have no documentation of any of the predefined system views, except for
> the ones that fit into the "monitoring" chapter of the Admin Guide.
> 
> I think maybe we ought to make a new chapter for system views ... but
> where to put it?  User's Guide maybe?
> 

What about putting pg_settings documentation at the bottom of:
   ->Administrators Guide
     ->Server run-time environment
       ->run-time configuration
just before the Planner and optimizer tuning subsection?

http://developer.postgresql.org/docs/postgres/runtime-config.html

I think at some point there should be a consolidated section on system 
views, but since they are scattered at the moment, this seems like the 
most logical choice to me. Comments?

Joe




view thread (5+ messages)  latest in thread

reply

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: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: [PATCHES] pg_settings doc patch
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox