From: Ihor Radchenko <yantar92@posteo.net>
Date: Tue, 22 Nov 2022 01:21:17 +0000 (+0800)
Subject: Improve the doc string of 'string-collate-lessp'
X-Git-Tag: emacs-29.0.90~1595
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7c090ebf6b3fa065063906f9f8c9da7477fa7818;p=emacs.git

Improve the doc string of 'string-collate-lessp'

* src/fns.c (Fstring_collate_lessp): Clarify that
IGNORE-CASE argument might be ignored when the operating
system does not implement string collation for the
specified locale.  (Bug#59275)
---

diff --git a/src/fns.c b/src/fns.c
index 035fa129352..e337c0958d5 100644
--- a/src/fns.c
+++ b/src/fns.c
@@ -596,8 +596,9 @@ To emulate Unicode-compliant collation on MS-Windows systems,
 bind `w32-collate-ignore-punctuation' to a non-nil value, since
 the codeset part of the locale cannot be \"UTF-8\" on MS-Windows.
 
-If your system does not support a locale environment, this function
-behaves like `string-lessp'.  */)
+Some operating systems do not implement correct collation (in specific
+locale environments or at all).  Then, this functions falls back to
+case-sensitive `string-lessp' and IGNORE-CASE argument is ignored.  */)
   (Lisp_Object s1, Lisp_Object s2, Lisp_Object locale, Lisp_Object ignore_case)
 {
 #if defined __STDC_ISO_10646__ || defined WINDOWSNT