Subject: Re: bin/7249
To: None <tech-kern@netbsd.org>
From: Mirian Crzig Lennox <mirian@cosmic.com>
List: tech-kern
Date: 07/17/2000 13:20:06
Someone mentioned having some man pages be automatically generated
by software which parses through syscalls looking for error codes
I just want to add my two cents about that, which is that this is
the sort of thing (similar) which Sun does with its Java documentation,
and the result is a lot of... well, STUFF which crowds out the actual
meaningful documentation.  I much prefer a couple of paragraphs of 
carefuly-written and coherent documentation to reams of generated
boilerplate.

NetBSD's man pages, omissions and all, are about as good as it gets in
terms of clarity and readability; let's preserve that.

--Mirian