public inbox for gentoo-pms@lists.gentoo.org
 help / color / mirror / Atom feed
* [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