discuss: man pages
Subject:
Re: man pages
From:
Michael Still ####@####.####
Date:
4 Jan 2004 23:10:50 -0000
Message-Id: <Pine.LNX.4.44.0401051003300.30860-100000@diskbox.stillhq.com>
On 4 Jan 2004, Glen Turner wrote:
> The quality of the man pages is a typical Linux distribution
> makes me despair for the sanity of users.
>
> There are commands without man pages, there are command
> options which are unexplained, there are descriptions
> so detailed as to boggle the mind but no example of
> the most common usages.
It is my understanding that Debian requires all packages to have a man
page, so in a sense there is a project working on this.
Man pages are the responsibility of the individual project developer(s). I
would imagine that individual projects would be willing to accept
documentation patches, but because there is no central software project,
there is also no central documentation project.
Cheers,
Mikal
--
Michael Still ####@####.#### | "All my life I've had one dream,
http://www.stillhq.com | to achieve my many goals"
UTC + 11 | -- Homer Simpson