commit: 42da74a0e2b5f0a93acace279fcca3c6f5487dc6
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Fri Nov 29 16:02:17 2024 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Nov 29 16:02:17 2024 +0000
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=42da74a0
pkg-mgr-commands.tex: More precise wording for assert
The pipe status variable is an array, which consists of array elements.
The term "components" is used with a different meaning elsewhere.
Update the command properties table. These apply only to the die
command, and assert inherits them ("calls die, passing any parameters
to it").
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
pkg-mgr-commands.tex | 12 +++++-------
1 file changed, 5 insertions(+), 7 deletions(-)
diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index ad2493e..4ab8fdf 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -199,20 +199,18 @@ completing. Ebuilds must not run any of these commands
once the current phase fu
\featurelabel{subshell-die} In EAPIs listed in
table~\ref{tab:die-properties} as not providing
subshell support, \t{die} is \emph{not} guaranteed to work correctly if
called from a subshell
environment.
-\item[assert] Checks the value of the shell's pipe status variable, and if any
component is non-zero
- (indicating failure), calls \t{die}, passing any parameters to it.
+\item[assert] Checks the shell's pipe status array, and if any element is
non-zero (indicating
+ failure), calls \t{die}, passing any parameters to it.
\end{description}
\ChangeWhenAddingAnEAPI{9}
-\begin{centertable}{Properties of \t{die} and \t{assert} commands in EAPIs}
+\begin{centertable}{Properties of \t{die} command in EAPIs}
\label{tab:die-properties}
\begin{tabular}{lll}
\toprule
\multicolumn{1}{c}{\textbf{EAPI}} &
- \multicolumn{2}{c}{\textbf{\t{die} and \t{assert}}} \\
- &
- \multicolumn{1}{c}{\textbf{support \t{-n}?}} &
- \multicolumn{1}{c}{\textbf{work in subshell?}} \\
+ \multicolumn{1}{c}{\textbf{Supports \t{die -n}?}} &
+ \multicolumn{1}{c}{\textbf{\t{die} works in subshell?}} \\
\midrule
0, 1, 2, 3, 4, 5 & No & No \\
6 & Yes & No \\
