> > Most configuration files have manpages, but not all. It would be useful > >if every config file (intended to be edited) would be forced to be > >documented in a manpage. > > Would it not be sufficient to require documentation either in a manpage > or (as is often done) by comments in the configuration file itself?
Wouldn't be sufficient to have documentation in `tool --help'. Having a manpage is a nicer and cleaner solution IMO. There's a whole man section (5) for that. A sysadmin could delete the comments; he could choose to not upgrade the file (when asked by dpkg) and have incorrect docs.. but the manpage will be there.
