[gentoo-pms] [PATCH 20/21] EAPI 8: usev has an optional second argument

[Ulrich Müller]

Bug: https://bugs.gentoo.org/744868
Signed-off-by: Ulrich Müller <ulm@g.o>
---
 eapi-differences.tex |  4 ++++
 pkg-mgr-commands.tex | 23 ++++++++++++++---------
 2 files changed, 18 insertions(+), 9 deletions(-)

diff --git a/eapi-differences.tex b/eapi-differences.tex
index d263cbc..5609de6 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -317,6 +317,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 \\
 
@@ -529,6 +532,7 @@ EAPI 8 is EAPI 7 with the following changes:
 \item \t{dosym} can create relative paths, \featureref{dosym-relative}.
 \item \t{insopts} no longer affects \t{doconfd}, \t{doenvd} and \t{doheader}, \featureref{insopts}.
 \item \t{exeopts} no longer affects \t{doinitd}, \featureref{exeopts}.
+\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 58254fa..eac17de 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -936,15 +936,17 @@ 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:use-list-args} 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}, 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
-    (\t{\$\{value\}}). For EAPIs listed in table~\ref{tab:use-with-third-arg} as not supporting it,
+    (\t{\$\{value\}}). For EAPIs listed in table~\ref{tab:use-list-args} as not supporting it,
     an empty third argument is treated as if it weren't provided. If the USE flag is set, outputs
     \t{-{}-with-\$\{opt\}=\$\{value\}} if the third argument was provided, and
     \t{-{}-with-\$\{opt\}} otherwise. If the flag is not set, then it outputs
@@ -979,15 +981,18 @@ table~\ref{tab:use-list-strictness}.
 \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}
-    \begin{tabular}{ll}
+\begin{centertable}{\t{usev}, \t{use_with} and \t{use_enable} arguments for EAPIs}
+    \label{tab:use-list-args}
+    \begin{tabular}{lll}
       \toprule
       \multicolumn{1}{c}{\textbf{EAPI}} &
-      \multicolumn{1}{c}{\textbf{Supports empty third argument?}} \\
+      \multicolumn{1}{P{8em}}{\textbf{\t{usev} has optional second argument?}} &
+      \multicolumn{1}{P{14em}}{\textbf{\t{use_with} and \t{use_enable} support empty third
+        argument?}} \\
       \midrule
-      0, 1, 2, 3        & No  \\
-      4, 5, 6, 7, 8     & Yes \\
+      0, 1, 2, 3        & No  & No  \\
+      4, 5, 6, 7        & No  & Yes \\
+      8                 & Yes & Yes \\
       \bottomrule
     \end{tabular}
 \end{centertable}
-- 
2.31.1