[gentoo-commits] proj/pms:eapi-8 commit in: /

["Ulrich Müller" <ulm@gentoo.org>]

commit:     2c5789d7debc6c573ea4e486d89b678cc24a4bac
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Sun May 16 12:05:17 2021 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Thu May 27 19:15:25 2021 +0000
URL:        https://gitweb.gentoo.org/proj/pms.git/commit/?id=2c5789d7

EAPI 8: useq, hasv and hasq are banned

Bug: https://bugs.gentoo.org/199722
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 eapi-differences.tex | 11 +++++++++++
 pkg-mgr-commands.tex | 16 ++++++++++++++++
 2 files changed, 27 insertions(+)

diff --git a/eapi-differences.tex b/eapi-differences.tex
index c7af2b3..a2a74b8 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -236,6 +236,15 @@ Most utilities die & \compactfeatureref{die-on-failure} &
 \t{libopts} & \compactfeatureref{banned-commands} &
     Yes & Yes & Yes & Banned & Banned \\
 
+\t{useq} & \compactfeatureref{banned-commands} &
+    Yes & Yes & Yes & Yes & Banned \\
+
+\t{hasv} & \compactfeatureref{banned-commands} &
+    Yes & Yes & Yes & Yes & Banned \\
+
+\t{hasq} & \compactfeatureref{banned-commands} &
+    Yes & Yes & Yes & Yes & Banned \\
+
 Query command options & \compactfeatureref{pm-query-options} &
     None & \t{-{}-host-root} & \t{-{}-host-root} & \t{-b}, \t{-d}, \t{-r} &
     \t{-b}, \t{-d}, \t{-r} \\
@@ -503,6 +512,8 @@ EAPI 8 is EAPI 7 with the following changes:
 \item Empty working directory in \t{pkg_*} phase functions, \featureref{phase-function-dir}.
 \item Different \t{src_prepare} implementation, \featureref{src-prepare}.
 \item \t{PROPERTIES} and \t{RESTRICT} accumulated across eclasses, \featureref{accumulate-vars}.
+\item \t{useq} banned, \featureref{banned-commands}.
+\item \t{hasv} and \t{hasq} banned, \featureref{banned-commands}.
 \end{compactitem}
 
 \ChangeWhenAddingAnEAPI{8}

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 71d1e89..c56e592 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -73,6 +73,16 @@ called, the package manager must abort the build process indicating an error.
       4, 5              & Yes & Yes & No  & No  & No  & No  \\
       6                 & Yes & Yes & Yes & No  & No  & No  \\
       7, 8              & Yes & Yes & Yes & Yes & Yes & Yes \\
+      \midrule
+      \multicolumn{1}{c}{\textbf{EAPI}} &
+      \multicolumn{6}{c}{\textbf{Command banned?}} \\
+      \multicolumn{1}{c}{} &
+      \multicolumn{1}{c}{\textbf{\t{useq}}} &
+      \multicolumn{1}{c}{\textbf{\t{hasv}}} &
+      \multicolumn{1}{c}{\textbf{\t{hasq}}} & & & \\
+      \midrule
+      0, 1, 2, 3, 4, 5, 6, 7  & No  & No  & No  & & & \\
+      8                       & Yes & Yes & Yes & & & \\
       \bottomrule
     \end{tabular}
 \end{centertable}
@@ -842,6 +852,8 @@ table~\ref{tab:use-list-strictness}.
 \item[usev] The same as \t{use}, but also prints the flag name if the condition
     is met.
 \item[useq] Deprecated synonym for \t{use}.
+    In EAPIs listed in table~\ref{tab:banned-commands-table}, this command is banned as per
+    section~\ref{sec:banned-commands}.
 \item[use_with] \featurelabel{use-with} Has one-, two-, and three-argument forms. The first
     argument is a USE flag name, the second a \t{configure} option name (\t{\$\{opt\}}), defaulting
     to the same as the first argument if not provided, and the third is a string value
@@ -916,7 +928,11 @@ These functions check whitespace-separated lists for a particular value.
 \item[has] Returns shell true (0) if the first argument (a word) is found in the list of subsequent
     arguments, false otherwise. Guaranteed quiet.
 \item[hasv] The same as \t{has}, but also prints the first argument if found.
+    In EAPIs listed in table~\ref{tab:banned-commands-table}, this command is banned as per
+    section~\ref{sec:banned-commands}.
 \item[hasq] Deprecated synonym for \t{has}.
+    In EAPIs listed in table~\ref{tab:banned-commands-table}, this command is banned as per
+    section~\ref{sec:banned-commands}.
 \end{description}
 
 \subsection{Version manipulation and comparison commands}