Subject: Re: bin/7249
To: Berndt Josef Wulf <firstname.lastname@example.org>
From: Matt Thomas <email@example.com>
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: firstname.lastname@example.org
3am Software Foundry WWW URL: http://www.3am-software.com/bio/matt/
Cupertino, CA Disclaimer: I avow all knowledge of this message