Subject: Re: standards/33035: Lack of documentation
To: Martin Husemann <martin@duskware.de>
From: kernelpanicked <jamesb@bsdnut.com>
List: netbsd-bugs
Date: 03/09/2006 14:06:32
On Thu, 9 Mar 2006, Martin Husemann wrote:

> The following reply was made to PR standards/33035; it has been noted by GNATS.
>
> From: Martin Husemann <martin@duskware.de>
> To: gnats-bugs@netbsd.org
> Cc:
> Subject: Re: standards/33035: Lack of documentation
> Date: Thu, 9 Mar 2006 09:59:09 +0100
>
> On Thu, Mar 09, 2006 at 03:40:00AM +0000, kernelpanicked@bsdnut.com wrote:
>
> > [..] this would be a good thing as most (all?) of NetBSD's docs
> > are only Web accessable.
>
> This is not true. All programs are documented in their man pages.
> Some bigger, externally maintained programs have additional documentation
> in html format (this is what you found).
>
> If you discover some program in the base installation that man(1) does not
> know about, please file a PR.
>
> Martin
>
>

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.

KernelPanicked