Re: Documentation of server configuration - Mailing list pgsql-docs

From Robert Treat
Subject Re: Documentation of server configuration
Date
Msg-id 200411131617.26922.xzilla@users.sourceforge.net
Whole thread Raw
In response to Documentation of server configuration  (Peter Eisentraut <peter_e@gmx.net>)
Responses Re: Documentation of server configuration  (Alvaro Herrera Munoz <alvherre@dcc.uchile.cl>)
List pgsql-docs
On Saturday 13 November 2004 15:20, Peter Eisentraut wrote:
> I've just spent a day working through the current set of server
> configuration parameters, and I think that the documentation at
> <http://developer.postgresql.org/docs/postgres/runtime-config.html> has
> reached its peak of unusability.  I haven't been able to find a single
> parameter all day except by using a text search over the file.
>
> A couple of obvious faults:
>
> - There are too many sections.
>
> - The sections don't have any obvious order.
>
> - The subsections don't have any obvious order.
>
> - The lists of individual parameters inside the sections don't have any
> order.
>
> - If a parameter has a list of possible values, the values are not
> listed in a consistent order.
>
> I have made an attempt and reformatted the whole section into one big
> alphabetical list, and while that has obvious drawbacks, I feel that
> it's already much more usable than what we have now.
>
> Other ideas?

I thought runtime-config was supposed to be ordered in the same order as the
default postgresql.conf ?

--
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL

pgsql-docs by date:

Previous
From: Peter Eisentraut
Date:
Subject: Documentation of server configuration
Next
From: Alvaro Herrera
Date:
Subject: Re: Documentation of server configuration