GNU bug report logs - #59275
Unexpected return value of `string-collate-lessp' on Mac

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Ihor Radchenko <yantar92 <at> posteo.net>
Cc: 59275 <at> debbugs.gnu.org
Subject: bug#59275: Unexpected return value of `string-collate-lessp' on Mac
Date: Wed, 23 Nov 2022 16:58:20 +0200

> From: Ihor Radchenko <yantar92 <at> posteo.net>
> Cc: 59275-done <at> debbugs.gnu.org
> Date: Wed, 23 Nov 2022 10:39:22 +0000
> 
> Eli Zaretskii <eliz <at> gnu.org> writes:
> 
> >> See the attached patch.
> >
> > Thanks, installed.
> 
> Should we update the manual as well?
> 4.5 Comparison of Characters and Strings section contains the old
> docstring verbatim.

I see in the manual text that is not a verbatim copy of the doc string, but
an expanded version of it with more detailed explanations.  Which is how it
should be: it is IMNSHO bad documentation-fu to have the manual just copycat
the doc strings.  (We sometimes do it for lack of time, but it is not a Good
Thing.)

The note about case-sensitivity of the fallback was missing from the manual,
so I added it.

> P.S. I am wondering if there is some automated way to deal with verbatim
> docstrings in the manuals. They are so easy to slip through when the
> Elisp docstrings get updated.

There should be no verbatim copies of doc strings in the manual.  So I'm not
interested in making that bad practice easier ;-)

Thanks.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.