* [gentoo-pms] [PATCH] pkg-mgr-commands.tex: More precise wording for assert
@ 2024-12-09 7:31 Ulrich Müller
0 siblings, 0 replies; only message in thread
From: Ulrich Müller @ 2024-12-09 7:31 UTC (permalink / raw
To: gentoo-pms; +Cc: Ulrich Müller
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@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 6bd325e..35f32e1 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{8}
-\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 \\
--
2.47.1
^ permalink raw reply related [flat|nested] only message in thread
only message in thread, other threads:[~2024-12-09 7:32 UTC | newest]
Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-12-09 7:31 [gentoo-pms] [PATCH] pkg-mgr-commands.tex: More precise wording for assert Ulrich Müller
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox