This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH v2] Remove union wait
- From: Roland McGrath <roland at hack dot frob dot com>
- To: Florian Weimer <fweimer at redhat dot com>
- Cc: libc-alpha at sourceware dot org
- Date: Fri, 1 Apr 2016 15:00:04 -0700 (PDT)
- Subject: Re: [PATCH v2] Remove union wait
- Authentication-results: sourceware.org; auth=none
- References: <56BE07C8 dot 40205 at redhat dot com> <20160307225511 dot 093E92C3BF5 at topped-with-meat dot com> <56DEA20E dot 3040907 at redhat dot com> <20160330224704 dot 81D102C3C51 at topped-with-meat dot com> <56FEEB31 dot 7070400 at redhat dot com>
> Oh. I wasn't aware that 4.3+BSD was a term made up by Richard Stevens
> for the 1993 edition of Advanced Programming in the UNIX Environment
> (which predates 4.4BSD).
The last book I read about Unix programming was the first edition of K&R
(unless you count the hardcopy set of of 4.3BSD man pages I had). I only
refer to the sources, header files, and machine-readable documentation
that's part of the system.
> In any case, union wait is not documented at all in the book.
An example of why such books are not good resources for authoritative
information.
> > This should probably be more thoroughly rewritten, probably dropping the
> > section and describing wait3 as obsolete just alongside wait4.
>
> That's a separate patch, right?
Either way, as long as it doesn't get forgotten and doesn't lag long past
the code patch. The state your patch leaves the manual in looks a bit like
the state source code gets in after a patch that removes a bunch of code
but doesn't remove comments that refer to that code.