Subject: Re: standards/33035: Lack of documentation
To: Martin Husemann <email@example.com>
From: kernelpanicked <firstname.lastname@example.org>
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 <email@example.com>
> To: firstname.lastname@example.org
> 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, email@example.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.
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.