tags 391402 fixed-upstream
thanks

Hi,

> 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 

Agreed.

> 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.

Perfect.  Changed as you suggest for upstream 2.41.

Thanks for your report.

Cheers,

Michael
-- 
Michael Kerrisk
maintainer of Linux man pages Sections 2, 3, 4, 5, and 7 

Want to help with man page maintenance?  
Grab the latest tarball at
ftp://ftp.win.tue.nl/pub/linux-local/manpages/, 
read the HOWTOHELP file and grep the source 
files for 'FIXME'.


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to