Subject: Re: CVS commit: src/lib/libc/sys
To: Perry E. Metzger <firstname.lastname@example.org>
From: Klaus Klein <email@example.com>
Date: 11/05/2004 20:20:16
On Thursday 26 August 2004 16:21, Perry E. Metzger wrote:
> YAMAMOTO Takashi <firstname.lastname@example.org> 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.
P.S. See errno(3) or signal(7) for current practice.