Subject: Re: bin/7249
To: Chuck McManis <email@example.com>
From: Kevin P. Neal <firstname.lastname@example.org>
Date: 07/17/2000 13:02:22
On Sat, Jul 15, 2000 at 02:41:30PM -0700, Chuck McManis wrote:
> Having had some experience at Sun on the "spec" side of the argument I can
> assure you that the NetBSD project doesn't have nearly enough resources to
> maintain a NetBSD specification. Therefore, unless you can do this for all
> man pages (ie spec mode) then it will be no better than guide mode, thus
> I'm going to suggest that the answer is guide mode.
(Sorry, I'm a little behind.)
How about having man pages list the potential errors that each syscall can
return, but not give explanations (refer the reader to intro)?
Descriptions for some of the errors in the syscall-specific pages wouldn't
go away, of course.
Kevin P. Neal http://www.pobox.com/~kpn/
Seen on bottom of IBM part number 1887724:
DO NOT EXPOSE MOUSE PAD TO DIRECT SUNLIGHT FOR EXTENDED PERIODS OF TIME.