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

[Ulrich Müller]

commit:     fd3c7bfed5bd1502a021325b7e603124a27d6135
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Sun May 16 18:59:37 2021 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun May 16 18:59:37 2021 +0000
URL:        https://gitweb.gentoo.org/proj/pms.git/commit/?id=fd3c7bfe

EAPI 8: usev has an optional second argument

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

 eapi-differences.tex |  4 ++++
 pkg-mgr-commands.tex | 20 ++++++++++++++++++--
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/eapi-differences.tex b/eapi-differences.tex
index 0579fa3..559a686 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -313,6 +313,9 @@ Controllable stripping & \compactfeatureref{dostrip} &
 \t{dostrip} & \compactfeatureref{dostrip} &
     No & No & No & Yes & Yes \\
 
+\t{usev} second arg & \compactfeatureref{usev} &
+    No & No & No & No & Yes \\
+
 \t{use_with} empty third arg & \compactfeatureref{use-with} &
     * & Yes & Yes & Yes & Yes \\
 
@@ -532,6 +535,7 @@ EAPI 8 is EAPI 7 with the following changes:
 \item Less strict naming rules for files in \t{updates} directory, \featureref{updates-filenames}.
 \item \t{dosym} can create relative paths, \featureref{dosym-relative}.
 \item \t{PROPERTIES}, \t{RESTRICT} accumulated across eclasses, \featureref{accumulate-vars}.
+\item \t{usev} supports an optional second argument, \featureref{usev}.
 \end{compactitem}
 
 \ChangeWhenAddingAnEAPI{8}

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 8d5c903..41b3b47 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -931,8 +931,10 @@ table~\ref{tab:use-list-strictness}.
 \item[use] Returns shell true (0) if the first argument (a \t{USE} flag name) is enabled, false
     otherwise.  If the flag name is prefixed with \t{!}, returns true if the flag is disabled, and
     false if it is enabled. It is guaranteed that this command is quiet.
-\item[usev] The same as \t{use}, but also prints the flag name if the condition
-    is met.
+\item[usev] \featurelabel{usev} The same as \t{use}, but also prints the flag name if the condition
+    is met. In EAPIs listed in table~\ref{tab:usev-second-arg} as supporting an optional second
+    argument for \t{usev}, prints the second argument instead, if it is specified and if the
+    condition is met.
 \item[useq] Deprecated synonym for \t{use}.
     In EAPIs listed in table~\ref{tab:banned-commands-table-2}, this command is banned as per
     section~\ref{sec:banned-commands}.
@@ -973,6 +975,20 @@ table~\ref{tab:use-list-strictness}.
     \end{tabular}
 \end{centertable}
 
+\ChangeWhenAddingAnEAPI{8}
+\begin{centertable}{EAPIs supporting an optional second argument in \t{usev}}
+    \label{tab:usev-second-arg}
+    \begin{tabular}{ll}
+      \toprule
+      \multicolumn{1}{c}{\textbf{EAPI}} &
+      \multicolumn{1}{c}{\textbf{Supports optional second argument?}} \\
+      \midrule
+      0, 1, 2, 3, 4, 5, 6, 7  & No  \\
+      8                       & Yes \\
+      \bottomrule
+    \end{tabular}
+\end{centertable}
+
 \ChangeWhenAddingAnEAPI{8}
 \begin{centertable}{EAPIs supporting empty third argument in \t{use_with} and \t{use_enable}}
     \label{tab:use-with-third-arg}