From: Robert Treat <xzilla@users.sourceforge.net>
To: Peter Eisentraut <peter_e@gmx.net>
Subject: Re: Documentation of server configuration
Date: Sat, 13 Nov 2004 16:17:26 -0500
User-Agent: KMail/1.6.2
Cc: pgsql-docs@postgresql.org
References: <200411132120.51294.peter_e@gmx.net>
In-Reply-To: <200411132120.51294.peter_e@gmx.net>
MIME-Version: 1.0
Content-Disposition: inline
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Message-Id: <200411131617.26922.xzilla@users.sourceforge.net>

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