[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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: