[patch] wait4.2: Add a note that these functions are deprecated

[patch] wait4.2: Add a note that these functions are deprecated

[Adrian Bunk]

---
 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

--
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

Re: [patch] wait4.2: Add a note that these functions are deprecated

[Michael Kerrisk (man-pages)]

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-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org> 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-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [patch] wait4.2: Add a note that these functions are deprecated

[Adrian Bunk]

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).

> Cheers,
> 
> Michael

cu
Adrian


> On Tue, Sep 18, 2012 at 11:01 PM, Adrian Bunk <bunk-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org> 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
--
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

Re: [patch] wait4.2: Add a note that these functions are deprecated

[Michael Kerrisk (man-pages)]

Hi Adrian,

On Sun, Sep 23, 2012 at 4:24 PM, Adrian Bunk <bunk-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org> 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-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org> 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-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [patch] wait4.2: Add a note that these functions are deprecated

[Adrian Bunk]

On Sun, Sep 23, 2012 at 04:34:36PM +0200, Michael Kerrisk (man-pages) wrote:
> Hi Adrian,
> 
> On Sun, Sep 23, 2012 at 4:24 PM, Adrian Bunk <bunk-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org> 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.

My problem is with the word "nonstandard" for wait3(), that was 
specified in older standards.

What about "obsolete" instead?

> Cheers,
> 
> Michael

cu
Adrian

-- 

       "Is there not promise of rain?" Ling Tan asked suddenly out
        of the darkness. There had been need of rain for many days.
       "Only a promise," Lao Er said.
                                       Pearl S. Buck - Dragon Seed

--
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

Re: [patch] wait4.2: Add a note that these functions are deprecated

[Michael Kerrisk (man-pages)]

>> >> 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.
>
> My problem is with the word "nonstandard" for wait3(), that was
> specified in older standards.
>
> What about "obsolete" instead?

Okay -- done!

Cheers,

Michael




-- 
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

Re: [patch] wait4.2: Add a note that these functions are deprecated

[Adrian Bunk]

On Mon, Sep 24, 2012 at 07:16:28AM +0200, Michael Kerrisk (man-pages) wrote:
> >> >> 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.
> >
> > My problem is with the word "nonstandard" for wait3(), that was
> > specified in older standards.
> >
> > What about "obsolete" instead?
> 
> Okay -- done!

Thanks!

> Cheers,
> 
> Michael

cu
Adrian

-- 

       "Is there not promise of rain?" Ling Tan asked suddenly out
        of the darkness. There had been need of rain for many days.
       "Only a promise," Lao Er said.
                                       Pearl S. Buck - Dragon Seed

--
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