On Fri, Mar 5, 2010 at 3:41 PM, Daniel Leidert <daniel.leidert.s...@gmx.net> wrote:
> What's the problem, to write a short manual page, that points to the > --help switch? All the maintainer would have to do is to provide the > intention of the command, point to the help/usage switch, relevant > commands and to locally installed documentation. Such a manual page > won't unlikely become outdated and it doesn't need much maintenance. > This goes for both: authors and maintainers. But it still provides the > necessary information to the user. As a user I'd find such a manual page less than useless, it would be extremely annoying. In any case the undocumented(7) manual page covers these: http://manpages.debian.net/man/7/undocumented I find the following two options acceptable: Good, useful, up-to-date manual pages. No manual page at all. An outdated/unmaintained manual page or one that just points at --help or existing documentation isn't useful or acceptable. -- bye, pabs http://wiki.debian.org/PaulWise -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org Archive: http://lists.debian.org/e13a36b31003042353u40031152j1d7fd5de936d1...@mail.gmail.com
