Hi Adrian, On Sun, Sep 23, 2012 at 4:24 PM, Adrian Bunk <bunk@xxxxxxxxxx> wrote: > On Sun, Sep 23, 2012 at 04:02:27PM +0200, Michael Kerrisk (man-pages) wrote: >> Adrian, > > Hi Michael, > >> 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? > > the wait3() function is not "nonstandard, since as the URL you gave > correctly states it is part of SuSv2 (and also of SuSv1). Yep, but marked LEGACY in SUSv2, and removed altogether in SUSv3. So, not part of contemporary standard. (BTW, I did also add text under CONFORMING TO to note those details.) So, I think I'll leave the text as I gave already, unless you have a better alternative to propose. 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
