Bug#45406: PROPOSAL] Config files must have manpages

[Nicolás Lichtmaier <nick@debian.org>]

>   > 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.