Subject: Re: standards/33035: Lack of documentation
To: kernelpanicked <jamesb@bsdnut.com>
From: Dave Huang <khym@azeotrope.org>
List: netbsd-bugs
Date: 03/09/2006 15:32:12
On Thu, Mar 09, 2006 at 02:06:32PM -0600, kernelpanicked wrote:
> Sorry, that is a completely lame cop out. Yes, man pages are great but they
> are not a replacement for good documentation. Any UNIX system should come
> with all the needed documentation to learn how to use it, as well as the
> tools needed to read the documentation.
What documentation specifically are you looking for? You mention that
only about four programs are documented in /usr/share/doc. Well,
that's because man pages are the main documentation for the
programs--if you're looking for documentation on the programs that
come with NetBSD, the man pages are where you should look first. I
don't see "look at the man pages" as a cop-out at all. man pages
aren't a replacement for good documentation, they _are_ good
documentation.
And as an aside, /usr/share/doc has info on more than just four
programs.
You also mention web-based documentation... what specifically are you
talking about? There's certainly plenty of unofficial how-to type
documentation on the web written by random NetBSD users, but I don't
see why that should be included with NetBSD.
--
Name: Dave Huang | Mammal, mammal / their names are called /
INet: khym@azeotrope.org | they raise a paw / the bat, the cat /
FurryMUCK: Dahan | dolphin and dog / koala bear and hog -- TMBG
Dahan: Hani G Y+C 30 Y++ L+++ W- C++ T++ A+ E+ S++ V++ F- Q+++ P+ B+ PA+ PL++