On Fri, Apr 04, 2003 at 05:52:46PM -0800, Kevin Brown wrote:
> Shouldn't each variable listed in postgresql.conf.sample have comments
> right above it explaining what it does anyway? A self-documenting
> configuration file is a really handy thing to have.
That's no help. It makes the config file very long (some of the
config values are complicated to use, and so you'd need to explain
all of that to avoid danger), so people are likely to stop reading
the comments. Given that the thing one is trying to prevent is
handing a loaded foot-gun to the RTFM-averse, adding documentation
doesn't seem to be a help.
A
--
----
Andrew Sullivan 204-4141 Yonge Street
Liberty RMS Toronto, Ontario Canada
<andrew@libertyrms.info> M2P 2A8 +1 416 646 3304
x110