Bug#551201: /usr/share/man/man3/insque.3.gz: insque() description contradicts POSIX and actual behaviour

2010-09-09 Thread Michael Kerrisk
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



Bug#551201: /usr/share/man/man3/insque.3.gz: insque() description contradicts POSIX and actual behaviour

2009-10-16 Thread Remi Denis-Courmont
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

Best regards,

-- 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-3on-line manual pager

-- no debconf information



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org