Subject: Re: standards/33035: Lack of documentation
To: Dave Huang <khym@azeotrope.org>
From: kernelpanicked <jamesb@bsdnut.com>
List: netbsd-bugs
Date: 03/09/2006 19:06:59
On Thu, 9 Mar 2006, Dave Huang wrote:

> 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++


http://netbsd.org/Documentation/

Not to be a jerk, but why are you even responding to NetBSD PRs if you don't know where the damn docs are located for the system?