commit: 49219c2e4cafe73711c48504fec45cf3a2db7bd0
Author: Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Thu Nov 9 16:33:34 2017 +0000
Commit: Michał Górny <mgorny <AT> gentoo <DOT> org>
CommitDate: Thu Nov 9 20:28:02 2017 +0000
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=49219c2e
EAPI 7 has ENV_BLACKLIST
eapi-differences.tex | 4 ++++
ebuild-env-vars.tex | 20 +++++++++++++-------
profile-variables.tex | 4 ++++
3 files changed, 21 insertions(+), 7 deletions(-)
diff --git a/eapi-differences.tex b/eapi-differences.tex
index b666500..3f25555 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -181,6 +181,9 @@ Parallel tests & \compactfeatureref{parallel-tests} &
Sane locale settings & \compactfeatureref{locale-settings} &
Undefined & Undefined & Undefined & Yes & Yes \\
+\t{ENV_BLACKLIST} & \compactfeatureref{env-blacklist} &
+ No & No & No & No & Yes \\
+
Profile \t{IUSE} injection & \compactfeatureref{profile-iuse-inject} &
No & No & Yes & Yes & Yes \\
@@ -483,6 +486,7 @@ EAPI 7 is EAPI 6 with the following changes:
\item \t{domo} installs to \t{/usr}, \featureref{domo-path}.
\item Controllable stripping and \t{dostrip}, \featureref{dostrip}.
\item Version manipulation and comparison commands, \featureref{ver-commands}.
+\item \t{ENV_BLACKLIST}, \featureref{env-blacklist}.
\end{compactitem}
\ChangeWhenAddingAnEAPI{7}
diff --git a/ebuild-env-vars.tex b/ebuild-env-vars.tex
index 32ed634..055fb89 100644
--- a/ebuild-env-vars.tex
+++ b/ebuild-env-vars.tex
@@ -334,18 +334,24 @@ must not be set.
\featurelabel{locale-settings} The package manager must ensure that the
\t{LC_CTYPE} and
\t{LC_COLLATE} locale categories are equivalent to the 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}.
+table~\ref{tab:system-env-vars}.
+
+\featurelabel{env-blacklist} If the ebuild uses EAPI listed in
table~\ref{tab:system-env-vars}
+as supporting the \t{ENV_BLACKLIST} variable, then it specifies a
whitespace-separated list
+of variable names. All variables whose names are included in that list must
not be set.
\ChangeWhenAddingAnEAPI{7}
-\begin{centertable}{Locale settings for EAPIs}
- \label{tab:locale-settings}
- \begin{tabular}{ll}
+\begin{centertable}{System environment variables}
+ \label{tab:system-env-vars}
+ \begin{tabular}{lll}
\toprule
\multicolumn{1}{c}{\textbf{EAPI}} &
- \multicolumn{1}{c}{\textbf{Sane \t{LC_CTYPE} and \t{LC_COLLATE}?}} \\
+ \multicolumn{1}{c}{\textbf{Sane \t{LC_CTYPE} and \t{LC_COLLATE}?}} &
+ \multicolumn{1}{c}{\textbf{\t{ENV_BLACKLIST}?}} \\
\midrule
- 0, 1, 2, 3, 4, 5 & Undefined \\
- 6, 7 & Yes \\
+ 0, 1, 2, 3, 4, 5 & Undefined & No \\
+ 6 & Yes & No \\
+ 7 & Yes & Yes \\
\bottomrule
\end{tabular}
\end{centertable}
diff --git a/profile-variables.tex b/profile-variables.tex
index 309f9e9..fa967b2 100644
--- a/profile-variables.tex
+++ b/profile-variables.tex
@@ -29,6 +29,10 @@ incrementally; otherwise, the following variables may or may
not be treated incr
\item \t{USE_EXPAND_UNPREFIXED}
\end{compactitem}
+If the package manager supports any EAPI listed in
table~\ref{tab:system-env-vars} as supporting
+\t{ENV_BLACKLIST} variable, this variable must be treated incrementally.
Otherwise, it may or may
+not be treated incrementally.
+
Other variables, except where they affect only package-manager-specific
functionality (such as
Portage's \t{FEATURES} variable), must not be treated incrementally---later
definitions shall
completely override those in parent profiles.
