Adrian, I think the idea of your patch is good, but I prefer to use a word other than "deprecated". The problem is that "deprecated" implies a standards body or a vendor made a formal statement about this. It's true that LSB 2.1 says that wait3() is deprecated (http://refspecs.linuxbase.org/LSB_2.1.0/LSB-generic/LSB-generic/baselib-wait3-3.html), but wait4() is currently still part of LSB. So, I applied a slightly modified version of your test: [[ These functions are nonstandard; use .BR waitpid (2) or .BR waitid (2) in new programs. ]] Seem okay? Cheers, Michael On Tue, Sep 18, 2012 at 11:01 PM, Adrian Bunk <bunk@xxxxxxxxxx> wrote: > --- > man2/wait4.2 | 7 ++++++- > 1 file changed, 6 insertions(+), 1 deletion(-) > > diff --git a/man2/wait4.2 b/man2/wait4.2 > index 68e49ad..3548396 100644 > --- a/man2/wait4.2 > +++ b/man2/wait4.2 > @@ -31,7 +31,7 @@ > .\" Rewrote much of this page, and removed much duplicated text, > .\" replacing with pointers to wait.2 > .\" > -.TH WAIT4 2 2010-09-20 "Linux" "Linux Programmer's Manual" > +.TH WAIT4 2 2012-09-18 "Linux" "Linux Programmer's Manual" > .SH NAME > wait3, wait4 \- wait for process to change state, BSD style > .SH SYNOPSIS > @@ -150,10 +150,15 @@ On Linux, > is a library function implemented on top of the > .BR wait4 () > system call. > + > +These functions are deprecated (not in POSIX.1-2001), use > +.BR waitpid (2) > +in new programs. > .SH "SEE ALSO" > .BR fork (2), > .BR getrusage (2), > .BR sigaction (2), > .BR signal (2), > .BR wait (2), > +.BR waitpid (2), > .BR signal (7) > -- > 1.7.10.4 > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Author of "The Linux Programming Interface"; http://man7.org/tlpi/ -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
