| 1 |
On Fri, 6 Feb 2009 08:17:46 +0100 (CET), Jesús Guerrero wrote: |
| 2 |
|
| 3 |
> Well, in that sense, ALL the man pages of for anything that's more |
| 4 |
> complext than ls will be horrible. There's no way to can shorten |
| 5 |
> it unless you take features off from bash. It's a very powerful |
| 6 |
> shell. |
| 7 |
> |
| 8 |
> Same goes for my other example: fvwm. |
| 9 |
|
| 10 |
And for mplayer/mencoder. The problem is that man pages are single pages |
| 11 |
and therefore only suitable for fairly short documents. The alternative, |
| 12 |
as used by zsh, is to split the information into several man pages, then |
| 13 |
you never know which one to look at. procmail is a good example of how to |
| 14 |
do this badly, with procmailrc's documentation being split across |
| 15 |
three man pages. |
| 16 |
|
| 17 |
That's why info is a much better format for complex or multipurpose |
| 18 |
programs. You'd expect to find a list of contents, chapters and an |
| 19 |
index in a printed reference book, electronic documentation should be |
| 20 |
no different. |
| 21 |
|
| 22 |
|
| 23 |
-- |
| 24 |
Neil Bothwick |
| 25 |
|
| 26 |
The sooner you fall behind the more time you'll have to catch up. |
Archives