From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id BF139158232 for ; Mon, 9 Dec 2024 07:32:01 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 129B3E0BDA; Mon, 9 Dec 2024 07:32:01 +0000 (UTC) Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 69A7FE0BDA for ; Mon, 9 Dec 2024 07:32:00 +0000 (UTC) From: =?UTF-8?q?Ulrich=20M=C3=BCller?= To: gentoo-pms@lists.gentoo.org Cc: =?UTF-8?q?Ulrich=20M=C3=BCller?= Subject: [gentoo-pms] [PATCH] pkg-mgr-commands.tex: More precise wording for assert Date: Mon, 9 Dec 2024 08:31:28 +0100 Message-ID: <20241209073144.11605-1-ulm@gentoo.org> X-Mailer: git-send-email 2.47.1 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Package Manager Specification discussions X-BeenThere: gentoo-pms@gentoo.org X-BeenThere: gentoo-pms@lists.gentoo.org Reply-To: gentoo-pms@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Archives-Salt: fde91e1f-d902-49e0-9e15-cbd63f870a9b X-Archives-Hash: 8c0c600414101d889fae458bdaab4dd2 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 --- 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