Re: [PATCHES] pg_settings doc patch

From: Joe Conway <mail(at)joeconway(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: PostgreSQL Patches <pgsql-patches(at)postgresql(dot)org>, pgsql-docs(at)postgresql(dot)org
Subject: Re: [PATCHES] pg_settings doc patch
Date: 2002-09-01 02:52:30
Message-ID: 3D7180EE.4010106@joeconway.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-patches

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

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Vishnu 2002-09-01 04:55:41 syntax to access/retrieve data from multiple databases
Previous Message Marc G. Fournier 2002-09-01 01:46:53 Re: Projects moved to gborg

Browse pgsql-patches by date

  From Date Subject
Next Message Vishnu 2002-09-01 04:54:11 syntax to access/retrieve data from multiple databases
Previous Message Serguei Mokhov 2002-09-01 02:44:41 Re: postgres: Russian NLS Update