public inbox for [email protected]  

help / color / mirror / Atom feed

From: Alvaro Herrera <[email protected]>
To: Peter Eisentraut <[email protected]>
Cc: [email protected]
Subject: Re: Documentation of server configuration
Date: Sat, 13 Nov 2004 17:49:47 -0300
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

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)

view thread (22+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: Documentation of server configuration
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox