At 8:46 Uhr +0200 19.10.2006, Alan Barrett wrote:
>I think that the man pages are references, and that we should care
>deeply about their quality.  I think that it's useful to provide some
>tutorial material, much as you have done in this case, but that we
>should stop short of making the man pages a "how to learn to be a
>programmer" guide book.

There's the rub. In daily use, I appreciate NetBSD's man pages for their
concise terseness. Look at the typical Linux Distributions for examples of
what a man page should not be. It's called "man page" for a reason...

My 0.02 EUR,
	hauke



--
"It's never straight up and down"     (DEVO)