discuss: man pages


Previous by date: 4 Jan 2004 11:06:55 -0000 Re: docs, Saqib Ali
Next by date: 4 Jan 2004 11:06:55 -0000 USB from DOS bootfloppy, Pedro M.
Previous in thread: 4 Jan 2004 11:06:55 -0000 Re: man pages, Ismael Olea
Next in thread: 4 Jan 2004 11:06:55 -0000 Re: man pages, Michael Still

Subject: man pages
From: Glen Turner ####@####.####
Date: 4 Jan 2004 11:06:55 -0000
Message-Id: <1073214269.4967.51.camel@andromache>

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.

Is there a project which is working on this?

If not, is there are list of best practices for man pages?

Glen
(trying hard not to volunteer a lifetime's work,
 but getting a nasty feeling that it may be
 inevitable)



Previous by date: 4 Jan 2004 11:06:55 -0000 Re: docs, Saqib Ali
Next by date: 4 Jan 2004 11:06:55 -0000 USB from DOS bootfloppy, Pedro M.
Previous in thread: 4 Jan 2004 11:06:55 -0000 Re: man pages, Ismael Olea
Next in thread: 4 Jan 2004 11:06:55 -0000 Re: man pages, Michael Still


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