Subject: Re: What information belongs into man pages?
To: Alan Barrett <firstname.lastname@example.org>
From: Hauke Fath <hauke@Espresso.Rhein-Neckar.DE>
Date: 10/19/2006 19:27:20
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,
"It's never straight up and down" (DEVO)