On Tue, Oct 02, 2001 at 01:28:33PM -0500, William Rowe wrote: > > We don't need to list all of the possible alternatives either. > > Just the most sane one. And, some of those values *are* the > > default - no need to specify them in our example config. > > Bzzt ... no. Anything the user is likely to want to change, EVEN if we > choose the default, should be listed. Anything obscure or of limited > interest can be jettisoned. > > But don't jettison anything from the config just 'because' it happens > to be a default. Config merging is a tricky thing, the explicit config > may have a different effect on other sections than the implicit default.
It looks to me like we have typically left the default directives in the config and merely commented them out, leaving a little blurb above it describing what it is and/or providing references to external documentation. Let's do that here. -aaron
