Subject: Re: CVS commit: src/lib/libc/sys
To: Perry E. Metzger <perry@piermont.com>
From: Klaus Klein <kleink@mibh.de>
List: source-changes
Date: 11/05/2004 20:20:16
On Thursday 26 August 2004 16:21, Perry E. Metzger wrote:
> 
> YAMAMOTO Takashi <yamt@mwd.biglobe.ne.jp> writes:
> >> Module Name: src
> >> Committed By: pooka
> >> Date:  Wed Aug 25 11:56:50 UTC 2004
> >> 
> >> Modified Files:
> >>  src/lib/libc/sys: sigprocmask.2
> >> 
> >> Log Message:
> >> The values for the parameter "how" are defined in sys/signal.h, not signal.h
> >
> > is there any benefit to document such an internal detail in this manpage?
> 
> Indeed. The single unix specification says <signal.h>, and that is
> what the man page should specify. It is not something for the user to
> know about if they're trying to write portable code.

Agreed.  But worse, the wording used could be interpreted as
a requirement to include <sys/signal.h> for those definitions,
apparently conflicting with the synopsis section.


- Klaus

P.S. See errno(3) or signal(7) for current practice.