[gentoo-pms] [PATCH] EAPI 6: Ensure sane settings for LC_COLLATE and LC_CTYPE.

[Ulrich Mueller]

As I haven't seen any objections from council members against revising
EAPI 6, please find a patch below.

It is worded in a way that LC_ALL=C, as currently done by Paludis,
will conform to it. A setting like LC_COLLATE=C LC_CTYPE=en_GB.UTF-8
is also allowed, or even LC_ALL=C.UTF-8 if such a locale should appear
in glibc at some point.

Please review.

Ulrich


From 047046e00b2fdd53939ff81d2cfb2adabf4118f9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ulrich=20M=C3=BCller?= <ulm@g.o>
Date: Thu, 12 Nov 2015 07:55:26 +0100
Subject: [PATCH] EAPI 6: Ensure sane settings for LC_COLLATE and LC_CTYPE.

Some locales (e.g. tr_TR) change the upper/lowercase mapping for ASCII
characters, which breaks the tr(1) command and the case-modifying word
expansions of Bash version 4.

Therefore, ensure that LC_COLLATE and LC_CTYPE behave in the same way
as the C locale for characters in the ASCII range.
---
 eapi-differences.tex |  4 ++++
 ebuild-env-vars.tex  | 19 +++++++++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/eapi-differences.tex b/eapi-differences.tex
index d4a90e0..aa1e482 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -132,6 +132,9 @@ Parallel tests & \compactfeatureref{parallel-tests} &
 \t{MERGE\_TYPE} & \compactfeatureref{merge-type} &
     No & No & Yes & Yes & Yes \\
 
+Sane locale settings & \compactfeatureref{locale-settings} &
+    Undefined & Undefined & Undefined & Undefined & Yes \\
+
 Profile \t{IUSE} injection & \compactfeatureref{profile-iuse-inject} &
     No & No & No & Yes & Yes \\
 
@@ -345,6 +348,7 @@ EAPI 6 is EAPI 5 with the following changes:
 \item Bash version is 4.2, \featureref{bash-version}.
 \item Default \t{src\_prepare} no longer a no-op, \featureref{src-prepare-6}.
 \item Different \t{src\_install} implementation, \featureref{src-install-6}.
+\item \t{LC\_COLLATE} and \t{LC\_CTYPE} compatible with C locale, \featureref{locale-settings}.
 \item \t{failglob} is enabled in global scope, \featureref{failglob}.
 \item \t{einstall} banned, \featureref{banned-commands}.
 \item \t{die} and \t{assert} called with \t{-n} respect \t{nonfatal}, \featureref{nonfatal-die}.
diff --git a/ebuild-env-vars.tex b/ebuild-env-vars.tex
index 8a9be0e..d577d1e 100644
--- a/ebuild-env-vars.tex
+++ b/ebuild-env-vars.tex
@@ -292,6 +292,25 @@ package manager specific directories.
 \t{GZIP}, \t{BZIP}, \t{BZIP2}, \t{CDPATH}, \t{GREP\_OPTIONS}, \t{GREP\_COLOR} and \t{GLOBIGNORE}
 must not be set.
 
+\featurelabel{locale-settings} The package manager must ensure that the \t{LC\_COLLATE} and
+\t{LC\_CTYPE} locale categories are equivalent to the C or POSIX locale, as far as characters
+in the ASCII range (U+0000 to U+007F) are concerned. Only for EAPIs listed in such a manner in
+table~\ref{tab:locale-settings}.
+
+\ChangeWhenAddingAnEAPI{6}
+\begin{centertable}{Locale settings for EAPIs}
+    \label{tab:locale-settings}
+    \begin{tabular}{ll}
+      \toprule
+      \multicolumn{1}{c}{\textbf{EAPI}} &
+      \multicolumn{1}{c}{\textbf{Sane \t{LC\_COLLATE} and \t{LC\_CTYPE}?}} \\
+      \midrule
+      0, 1, 2, 3, 4, 5  & Undefined \\
+      6                 & Yes       \\
+      \bottomrule
+    \end{tabular}
+\end{centertable}
+
 \subsection{USE and IUSE Handling}
 \label{sec:use-iuse-handling}
 
-- 
2.6.3