From a9cdc4a23c9ba93095cb6595972cbe2fde450e2c Mon Sep 17 00:00:00 2001
From: Ken Brown <kbrown@cornell.edu>
Date: Mon, 2 Nov 2015 11:22:51 -0500
Subject: [PATCH] Document behavior of collation on Cygwin
* test/automated/fns-tests.el (fns-tests-collate-sort): Mark as
expected failure on Cygwin.
* doc/lispref/strings.texi (Text Comparison): Document that
punctuation and whitespace are not ignored for sorting on Cygwin.
---
doc/lispref/strings.texi | 7 +++++--
test/automated/fns-tests.el | 2 ++
2 files changed, 7 insertions(+), 2 deletions(-)
diff --git a/doc/lispref/strings.texi b/doc/lispref/strings.texi
index 143de82d9ad..f8685d9312c 100644
--- a/doc/lispref/strings.texi
+++ b/doc/lispref/strings.texi
@@ -584,8 +584,8 @@ determined by the lexicographic order of the characters contained in
relations between these characters. Usually, it is defined by the
@var{locale} environment Emacs is running with.
-For example, punctuation and whitespace characters might be considered
-less significant for @ref{Sorting,,sorting}.
+For example, punctuation and whitespace characters might be ignored
+for sorting (@pxref{Sequence Functions}):
@example
@group
@@ -594,6 +594,9 @@ less significant for @ref{Sorting,,sorting}.
@end group
@end example
+This behavior is system-dependent; punctuation and whitespace are
+never ignored on Cygwin, regardless of locale.
+
The optional argument @var{locale}, a string, overrides the setting of
your current locale identifier for collation. The value is system
dependent; a @var{locale} @code{"en_US.UTF-8"} is applicable on POSIX
diff --git a/test/automated/fns-tests.el b/test/automated/fns-tests.el
index 7e9c1f1058d..b5222db3ca1 100644
--- a/test/automated/fns-tests.el
+++ b/test/automated/fns-tests.el
@@ -155,6 +155,8 @@
(9 . "aaa") (9 . "zzz") (9 . "ppp") (9 . "fff")])))
(ert-deftest fns-tests-collate-sort ()
+ ;; See https://lists.gnu.org/archive/html/emacs-devel/2015-10/msg02505.html.
+ :expected-result (if (eq system-type 'cygwin) :failed :passed)
(skip-unless (fns-tests--collate-enabled-p))
;; Punctuation and whitespace characters are relevant for POSIX.
--
2.39.5