Package: manpages-dev
Version: 2.39-1
Severity: minor
The qsort(3) man page seems to imply that strcmp can be passed as a
comparison routine to qsort. The sentence I refer to is:
Library routines suitable for use as the _compar_ argument include
strcmp() (see below), alphasort(), and versionsort().
As written, the sentence is self-contradictory: it (falsely) claims that
strcmp is suitable for use as the _compar_ argument, and then refers the
reader to the example which (correctly) explains that this is not the case.
Since strcmp really cannot be used as _compar_, I propose to change the
sentence.
I believe the intention of mentioning strcmp there was to say that strcmp is
useful for *implementing* a comparison function, and that intention is worth
retaining. That is why I propose the sentence to be changed to something
like:
Library routines suitable for use as the _compar_ argument include
alphasort() and versionsort(). To compare C strings, the comparison
function can call strcmp(), as shown in the example below.
-- System Information:
Debian Release: testing/unstable
APT prefers testing
APT policy: (900, 'testing'), (500, 'stable')
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/bash
Kernel: Linux 2.6.16-2-686
Locale: LANG=en_US, LC_CTYPE=en_US (charmap=ISO-8859-1)
Versions of packages manpages-dev depends on:
ii manpages 2.39-1 Manual pages about using a GNU/Lin
manpages-dev recommends no packages.
-- no debconf information
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
