I disagree a little bit on on this point.

When writing code in userland, I view man pages as the -requirements-
that the system call will conform to.  It's really nice to know that
"system call a doesn't return N, but may in the future", so that if
that case is relevent it can be appropriately trapped.

e.g. it's more important to me to know about the call as it is
specified than as it is currently implemented, assuming the impl is
conformant to the specification.  

Mike

On Mon, Oct 01, 2001 at 08:25:22AM -0700, Matthew Jacob wrote:
> FWIW, I agree here. man pages (should) document current behaviour.
> 

-- 
Michael P. Lyle
Chief Technical Officer
Recourse Technologies, Inc.