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

Reply via email to