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. <[email protected]> Imagine a large red swirl here. -- To UNSUBSCRIBE, email to [email protected] with a subject of "unsubscribe". Trouble? Contact [email protected] Archive: http://lists.debian.org/20100304142054.gv4...@yellowpig
