Kevin Brown <kevin@sysexperts.com> writes:
> Shouldn't each variable listed in postgresql.conf.sample have comments
> right above it explaining what it does anyway?
Not really --- if you can't be bothered to consult the Admin Guide when
in doubt, you have no business editing the config file. A word or two
of hints is one thing, but circles and arrows and a paragraph on the
back of each one just ain't gonna fly.
We went down that path previously with pg_hba.conf, and finally realized
that it was a waste of time to maintain what amounted to two separate
sets of documentation.
regards, tom lane