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:   matt@3am-software.com
3am Software Foundry      WWW URL:    http://www.3am-software.com/bio/matt/
Cupertino, CA             Disclaimer: I avow all knowledge of this message