On Fri, 6 Feb 2009 08:17:46 +0100 (CET), Jesús Guerrero wrote:

> Well, in that sense, ALL the man pages of for anything that's more
> complext than ls will be horrible. There's no way to can shorten
> it unless you take features off from bash. It's a very powerful
> shell.
> 
> Same goes for my other example: fvwm.

And for mplayer/mencoder. The problem is that man pages are single pages
and therefore only suitable for fairly short documents. The alternative,
as used by zsh, is to split the information into several man pages, then
you never know which one to look at. procmail is a good example of how to
do this badly, with procmailrc's documentation being split across
three man pages.

That's why info is a much better format for complex or multipurpose
programs. You'd expect to find a list of contents, chapters and an
index in a printed reference book, electronic documentation should be
no different.


-- 
Neil Bothwick

The sooner you fall behind the more time you'll have to catch up.

Attachment: signature.asc
Description: PGP signature

Reply via email to