On Freitag 06 Februar 2009, 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. You'd expect to find a list of contents, chapters and an > index in a printed reference book, electronic documentation should be > no different.
except that info is horrible. I hate info. If you don't know exactly what you are looking for, you are lost. And you can never sure in which part they hid the information you are looking for. Oh - and the navigation? A nightmare. I prefer man. Even huge manpages. You can easily search them and if you don't know what you are looking for you can glanze them over quickly. I hate info.