discuss: man pages


Previous by date: 4 Jan 2004 23:10:50 -0000 Re: Putting Together Information For a HOWTO, Devin Watson
Next by date: 4 Jan 2004 23:10:50 -0000 Re: man pages, Ruth A. Kramer
Previous in thread: 4 Jan 2004 23:10:50 -0000 man pages, Glen Turner
Next in thread: 4 Jan 2004 23:10:50 -0000 Re: man pages, Ruth A. Kramer

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


Previous by date: 4 Jan 2004 23:10:50 -0000 Re: Putting Together Information For a HOWTO, Devin Watson
Next by date: 4 Jan 2004 23:10:50 -0000 Re: man pages, Ruth A. Kramer
Previous in thread: 4 Jan 2004 23:10:50 -0000 man pages, Glen Turner
Next in thread: 4 Jan 2004 23:10:50 -0000 Re: man pages, Ruth A. Kramer


  ©The Linux Documentation Project, 2014. Listserver maintained by dr Serge Victor on ibiblio.org servers. See current spam statz.