On 2009-02-06, Neil Bothwick wrote: > 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. That's one opinion, but I think info very difficult to use. I much prefer a single page. Stuff in info is always broken up into pieces that are way too small. Whatever organization there is supposed to be in info is impossible to perceive while you're looking at a page, and it's way to easy to end up in documentation for something completely unrelated. > You'd expect to find a list of contents, chapters and an index > in a printed reference book, electronic documentation should > be no different. Perhaps, but I think info is an awful implementation. A single large man page is much better, and a single large html page with links in it is far, far, better. -- Grant Edwards grante Yow! HELLO, everybody, at I'm a HUMAN!! visi.com