Re: Removing the manpage requirement for GUI programs?
On Thu, Mar 04, 2010 at 10:26:06AM +0100, Josselin Mouette wrote:
> Le jeudi 04 mars 2010 à 01:22 +0100, Luca Niccoli a écrit :
> > Manuals are not only for documenting command line switches, they
> > should actually explain how to use a program.
> > I found the lack of good man pages one of the most annoying and
> > widespread problems of OSS.
> > Unfortunately, this gets more and more common with GUIs, as if a
> > graphical program could always be self-explanatory.
>
> No. It’s just that they ship with HTML documentation, which is much more
> suitable for documenting a GUI. A manual page cannot contain things as
> trivial as screenshots, which are mandatory.
But a manual page can at least provide a link to the HTML documentation.
This is far better than letting the user guess how to access the
documentation.
Cheers,
--
Bill. <ballombe@debian.org>
Imagine a large red swirl here.
Reply to: