tags 551201 fixed-upstream thanks On Fri, Oct 16, 2009 at 4:41 PM, Remi Denis-Courmont <r...@remlab.net> 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 debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org