tags 551201 fixed-upstream
thanks
On Fri, Oct 16, 2009 at 4:41 PM, Remi Denis-Courmont <[email protected]> wrote:
> Package: manpages-dev
> Version: 3.22-1
> Severity: normal
> File: /usr/share/man/man3/insque.3.gz
>
>
> Hello,
>
> The manual page for insque() states that
> insque(&elem, NULL);
> is invalid. However, the POSIX standards and the actual glibc
> implementation both explicitly allows this:
> http://www.opengroup.org/onlinepubs/009695399/functions/remque.html
Remi, thanks for this report. With respect to current glibc behavior,
you are correct. However the manual page was correct at the time that
it was written. In glibc 2.5, the implementation was fixed to conform
to POSIX. I've made many changes to the page, among other things
noting that prev==NULL is possible, and also adding a BUGS section
that says the following:
BUGS
In glibc 2.4 and earlier, it was not possible to specify
prev as NULL. Consequently, to build a linear list, the
caller had to build a list using an initial call that
contained the first two elements of the list, with the
forward and backward pointers in each element suitably
initialized.
Look okay to you? (Check misc/insremque.c in glibc 2.4 source.)
The changes will be in upstream man-pages-3.27.
Thanks.
Michael
> -- System Information:
> Debian Release: squeeze/sid
> APT prefers unstable
> APT policy: (100, 'unstable')
> Architecture: i386 (i686)
>
> Kernel: Linux 2.6.30.9 (SMP w/2 CPU cores)
> Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8)
> Shell: /bin/sh linked to /bin/dash
>
> Versions of packages manpages-dev depends on:
> ii manpages 3.22-1 Manual pages about using a
> GNU/Lin
>
> manpages-dev recommends no packages.
>
> Versions of packages manpages-dev suggests:
> ii konqueror [man-browser] 4:4.3.2-1 KDE 4's advanced file manager,
> web
> ii man-db [man-browser] 2.5.6-3 on-line manual pager
>
> -- no debconf information
>
>
>
>
--
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, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
