discuss: man pages
Subject:
Re: man pages
From:
"Ruth A. Kramer" ####@####.####
Date:
5 Jan 2004 14:52:30 -0000
Message-Id: <3FF91694.1A2C@fast.net>
Michael Still wrote:
> 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.
I agree that man pages leave something to be desired, especially for a
beginner.
One of my objectives in starting WikiLearn is to address things like
this. I invite you and anyone else to participate. See, for example:
http://twiki.org/cgi-bin/view/Wikilearn/WebHome
follow the links to:
AboutThesePages (and then to:
UsingFtpBeginner
UsingFtpReminder
WebChanges
regards,
Randy Kramer
>
> 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
>
> ______________________
> http://lists.tldp.org/