Date: Sat, 13 Nov 2004 17:49:47 -0300
From: Alvaro Herrera <alvherre@dcc.uchile.cl>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-docs@postgresql.org
Subject: Re: Documentation of server configuration
Message-ID: <20041113204947.GA19971@dcc.uchile.cl>
References: <200411132120.51294.peter_e@gmx.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <200411132120.51294.peter_e@gmx.net>
User-Agent: Mutt/1.5.6i

On Sat, Nov 13, 2004 at 09:20:51PM +0100, 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 agree it's somewhat uncomfortable.  As for unusability peak ...
I have seen worse things :-)

> 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.

What about a sort of table of contents, grouped by section and subsection,
inside each of which there would be an alphabetically sorted list of
parameters?  Each parameter in that list, in turn, would have an xref to
its entry in the one-big-alphabetical list.

-- 
Alvaro Herrera (<alvherre[@]dcc.uchile.cl>)
"Tiene valor aquel que admite que es un cobarde" (Fernandel)