From 5b14b2694b3eca391cf81df87e476b15b75da4d1 Mon Sep 17 00:00:00 2001
From: Bruno Haible <bruno@clisp.org>
Date: Fri, 1 Jan 2021 14:37:21 +0100
Subject: [PATCH] tests: Add comments.

* gettext-tools/tests/init.cfg: More comments about the Solaris gettext() bug.
---
 gettext-tools/tests/init.cfg | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/gettext-tools/tests/init.cfg b/gettext-tools/tests/init.cfg
index 813fb0c0e..3b814814d 100644
--- a/gettext-tools/tests/init.cfg
+++ b/gettext-tools/tests/init.cfg
@@ -5,9 +5,20 @@
 
 prepare_locale_ ()
 {
-  # Solaris 11 doesn't strip the CODESET part from the locale name,
-  # when looking for a message catalog.  Create a directory link with
-  # CODESET, to work around this.
+  # Solaris 11.[0-3] doesn't strip the CODESET part from the locale name,
+  # when looking for a message catalog. E.g. when the locale is fr_FR.UTF-8,
+  # on Solaris 11.[0-3] it looks for
+  #   <LOCALEDIR>/fr_FR.UTF-8/LC_MESSAGES/<domain>.mo
+  #   <LOCALEDIR>/fr.UTF-8/LC_MESSAGES/<domain>.mo
+  # Similarly, on Solaris 11 OpenIndiana and Solaris 11 OmniOS it looks only for
+  #   <LOCALEDIR>/fr_FR.UTF-8/LC_MESSAGES/<domain>.mo
+  # Reported at <https://www.illumos.org/issues/13423>.
+  # On Solaris 11.4 this is fixed: it looks for
+  #   <LOCALEDIR>/fr_FR.UTF-8/LC_MESSAGES/<domain>.mo
+  #   <LOCALEDIR>/fr.UTF-8/LC_MESSAGES/<domain>.mo
+  #   <LOCALEDIR>/fr_FR/LC_MESSAGES/<domain>.mo
+  #   <LOCALEDIR>/fr/LC_MESSAGES/<domain>.mo
+  # Create a directory link with CODESET, to work around this.
   if test "$1" != "$2" && test "$GLIBC2" = no; then
     case "$host_os" in
       solaris2.11)
-- 
2.47.3