"Greg Sabino Mullane" <greg@turnstep.com> writes:
> # foobar: Adjusts the foobariness of the database
> #
> # This uses units of baz from 1-10, with 10 being the strongest
> #
> # Changing this setting requires a reload
> # This setting may also be changed per session
> # The default value is 5
> #
> # For more information, please see:
> # http://postgres.org/doc/foobar.html
> foobar: 7
So your plan is that postgresql.conf will be approximately two thousand
lines long, before the user has ever touched it at all? (Two hundred
or so GUC variables and ten lines of comments for each one)
This seems entirely nuts. Duplicating the whole contents of config.sgml
in another place is pointless as well as maintenance-intensive. And it
*still* wouldn't be enough information for people to know how to twiddle
many of the variables; there are other parts of the SGML docs that
contain relevant info as well.
I could see having *one* comment at the top of the file giving pointers
to where to read the documentation.
regards, tom lane