From: Peter Eisentraut <peter_e@gmx.net>
To: pgsql-docs@postgresql.org
Subject: Documentation of server configuration
Date: Sat, 13 Nov 2004 21:20:51 +0100
User-Agent: KMail/1.5.1
MIME-Version: 1.0
Content-Type: text/plain;
  charset="us-ascii"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200411132120.51294.peter_e@gmx.net>

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?

-- 
Peter Eisentraut
http://developer.postgresql.org/~petere/