Re: Documentation of server configuration

From: elein <elein(at)varlena(dot)com>
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-14 01:05:11
Message-ID: 20041113170511.C22405@cookie.varlena.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-general

Is it possible to have an alphabetical hyperlink index to the sections?
I really like that it is in the same order as those in the
file and the like parameters are grouped.

But the table is too big and needs an index for faster access...
no wait that was the database...no wait...

elein

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 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/
>
>
> ---------------------------(end of broadcast)---------------------------
> TIP 9: the planner will ignore your desire to choose an index scan if your
> joining column's datatypes do not match
>

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Josh Berkus 2004-11-14 01:54:47 Re: Documentation of server configuration
Previous Message Tom Lane 2004-11-14 00:17:35 Re: Documentation of server configuration

Browse pgsql-general by date

  From Date Subject
Next Message Josh Berkus 2004-11-14 01:54:47 Re: Documentation of server configuration
Previous Message Tom Lane 2004-11-14 00:17:35 Re: Documentation of server configuration