Re: Removing the manpage requirement for GUI programs?
On Fri, Mar 5, 2010 at 3:41 PM, Daniel Leidert
<Daniel.Leidert.Spam@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
Reply to: