Re: Removing the manpage requirement for GUI programs?
On Fri, 2010-03-05 at 15:53 +0800, Paul Wise wrote:
> 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.
> An outdated/unmaintained manual page or one that just points at --help
> or existing documentation isn't useful or acceptable.
I get to wonder how many DD/DM even ping their upstream about this
issue.
A short manpage, pointing to "native" documentation have proven to be
useful (see GNU programs, and info pages).
Wouldn't it be possible to build a manpage the docbook file (because the
command lines are documented there, right ?)
At the risk of repeating myself, "man $foo" is a unified "Interface" for
humans.
Franklin
Reply to: