public inbox for [email protected]  

help / color / mirror / Atom feed

From: Ian Barwick <[email protected]>
To: Peter Eisentraut <[email protected]>
Cc: [email protected]
Cc: Bruce Momjian <[email protected]>
Cc: Alvaro Herrera <[email protected]>
Cc: Scott Marlowe <[email protected]>
Cc: Tom Lane <[email protected]>
Subject: Re: order of entries in admin docs
Date: Fri, 9 May 2008 10:28:04 +0900
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>

2008/5/8 Peter Eisentraut <[email protected]>:
> Bruce Momjian wrote:
>> There isn't much additional text except a description of each item.
>
> That's the way it should be: Each parameter explains what it does.  There can
> be more extensive documentation about how they all fit together elsewhere.
>
> What I would like to see is getting rid of the sections the parameters are
> grouped in and put them all in alphabetical order.  I find the current
> arrangement completely unusable; nine times out of ten I cannot find the
> right section.  The topical grouping of the options would be the job of the
> more extensive documentation elsewhere I mentioned above.
>
> I think Postfix has arranged this nicely:
> http://www.postfix.org/documentation.html -- You have various sections
> explaining how to configure for various jobs, and one big list of all
> parameters explained.
>
> --
> Sent via pgsql-docs mailing list ([email protected])
> To make changes to your subscription:
> http://www.postgresql.org/mailpref/pgsql-docs
>



-- 
http://sql-info.de/index.html

view thread (17+ 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], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: order of entries in admin docs
  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