Subject: Re: bin/7249
To: Berndt Josef Wulf <>
From: Matt Thomas <>
List: tech-kern
Date: 07/15/2000 18:25:13
At 09:24 AM 7/16/2000 +0930, Berndt Josef Wulf wrote:
>Erik E. Fair wrote
> > The PR wants every error that a given system call can return in the
> > man page for that system call (in section 2). I'm asking for
> > discussion here as to whether that's reasonable (it is gonna be a
> > maintenance headache, unless we find some automated way to produce it
> > from the code paths).
>I believe that a complete description of error messages for system
>calls are important, especially for the less experienced programmers.

I don't.  Our man pages should document the common cases and differences
from XPG4 or the relavant standard.  If one is doing serious programming
then I'd expect them to buy a XPG4 or whatever book telling them in detail
what things do.  We document where we differ.
Matt Thomas               Internet:
3am Software Foundry      WWW URL:
Cupertino, CA             Disclaimer: I avow all knowledge of this message