Bug#45406: PROPOSAL] Config files must have manpages
On Sat, Sep 18, 1999 at 04:18:40PM +0200, Raphael Hertzog wrote:
> Le Sat, Sep 18, 1999 at 04:10:42AM -0300, Nicolás Lichtmaier écrivait:
> > Package: debian-policy
> > Severity: wishlist
> > Version: 3.0.1.1
> >
> > 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.
>
> No I don't think that it's good idea. There's no point adding a bunch of
> undocumented symlink to all missing man page for configuration file. :-)
>
> I agree that having a man page for the configuration file is good but I
> don't want to force Debian developers to write man page for each
> configuration file that is not documented upstream. Furthermore some
> configuration files are well documented but in a file in /usr/share/doc
> and so on. There's no need to force the existence of a man page.
How would you feel about a symlink to the manpage of the program that uses
the conf file, if no manpage specific to that conf file is supplied?
Symlinks should be easy to do for maintainers..
There have been several times when I see a file laying around in my
filesystem, and I don't know what it is for. A man on that filename produces
nothing, which is a bit annoying; then I do not know what uses that file,
etc.
(Actually, if there is any easy way to use the debian package management
system to find out this info, I suppose that would make me more than
happy...)
--
Seth Arnold | http://www.willamette.edu/~sarnold/
Hate spam? See http://maps.vix.com/rbl/ for help
Hi! I'm a .signature virus! Copy me into
your ~/.signature to help me spread!
Reply to: