Re: [patch] wait4.2: Add a note that these functions are deprecated
From: Michael Kerrisk (man-pages) <hidden>
Date: 2012-09-23 14:02:27
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 [off-list ref] wrote:
quoted hunk
--- 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-u79uwXL29TY76Z2rM5mHXA@public.gmane.org More majordomo info at http://vger.kernel.org/majordomo-info.html