From: Paul Eggert <eggert@cs.ucla.edu>
Date: Mon, 2 Dec 2024 20:47:54 +0000 (-0800)
Subject: doc: mention tr issues in multi-byte locales
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b40645caa91dad69ba8a14ef53dc0013e12497fc;p=thirdparty%2Fautoconf.git

doc: mention tr issues in multi-byte locales

* doc/autoconf.texi (tr): Mention multi-byte issues.
---

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 222647b84..dd0b1fa2b 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -19985,6 +19985,14 @@ timestamp truncation problems that @samp{cp -p} has.
 @item @command{tr}
 @c ---------------
 @prindex @command{tr}
+
+Many @command{tr} implementations do not support multi-byte locales
+well.  For example, Solaris 10 @command{tr} rejects character classes in
+multi-byte locales.  Also, ranges have well-defined behavior only in the
+@samp{C} (or @samp{POSIX}) locale, so if you cannot guarantee the
+setting of @env{LC_ALL} it is better to spell out a range
+@samp{[ABCDEFGHIJKLMNOPQRSTUVWXYZ]} than to rely on @samp{[A-Z]}.
+
 @cindex carriage return, deleting
 @cindex newline, deleting
 @cindex deleting carriage return