On Wed, 20 Aug 2008 15:49:39 -0000
"Greg Sabino Mullane" <greg@turnstep.com> wrote:
>
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: RIPEMD160
> Sure, why not? Clarity should always trump brevity. The only people
> who gain from a comment-less file are the ones who are already expert
> in it.
You are right, Clarity always trumps brevity but then again, some
things are only clear if they are brief. Point being, the
documentation in the postgresql.conf isn't really useful and to make it
useful; would make the configuration file itself not useful. A succinct
file with directed links that are explicitly telling you, "Don't be
stupid read the docs" is a very good idea.
>
> To add some more fuel to the fire, are those in the no-comments,
> bare-bone camp going to argue for cleaning up pg_hba.conf as well?
>
Well I would. I find the pg_hba.conf obnoxious. Especially if we pushed
the documentation to a man page and windows help.
Sincerely,
Joshua D. Drake
--
The PostgreSQL Company since 1997: http://www.commandprompt.com/
PostgreSQL Community Conference: http://www.postgresqlconference.org/
United States PostgreSQL Association: http://www.postgresql.us/
Donate to the PostgreSQL Project: http://www.postgresql.org/about/donate
