Re: CVS commit: src/lib/libc/sys

[Klaus Klein <kleink%mibh.de@localhost>]

On Thursday 26 August 2004 16:21, Perry E. Metzger wrote:
> 
> YAMAMOTO Takashi <yamt%mwd.biglobe.ne.jp@localhost> 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.