Skip site navigation (1) Skip section navigation (2)

Re: Documentation of server configuration

From: Robert Treat <xzilla(at)users(dot)sourceforge(dot)net>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: Documentation of server configuration
Date: 2004-11-13 21:17:26
Message-ID: 200411131617.26922.xzilla@users.sourceforge.net (view raw or flat)
Thread:
Lists: pgsql-docspgsql-general
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

In response to

Responses

pgsql-docs by date

Next:From: Alvaro Herrera MunozDate: 2004-11-13 22:00:27
Subject: Re: Documentation of server configuration
Previous:From: Alvaro HerreraDate: 2004-11-13 20:49:47
Subject: Re: Documentation of server configuration

pgsql-general by date

Next:From: Alvaro HerreraDate: 2004-11-13 21:55:36
Subject: Re: The classic "NEW used in query that is not in a rule" problem again
Previous:From: Alvaro HerreraDate: 2004-11-13 20:49:47
Subject: Re: Documentation of server configuration

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group