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