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 11A351581F0 for ; Wed, 11 Dec 2024 19:40:04 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 52A4CE0D5C; Wed, 11 Dec 2024 19:40:03 +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) server-digest SHA256) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 31C2AE0D5C for ; Wed, 11 Dec 2024 19:40:03 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (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 smtp.gentoo.org (Postfix) with ESMTPS id 39B4F34316E for ; Wed, 11 Dec 2024 19:40:01 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id C09351F9A for ; Wed, 11 Dec 2024 19:39:58 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1733693839.3503c8704b402b171f5f9509a817fe43e9d71983.ulm@gentoo> Subject: [gentoo-commits] proj/pms:eapi-9 commit in: / X-VCS-Repository: proj/pms X-VCS-Files: pkg-mgr-commands.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 3503c8704b402b171f5f9509a817fe43e9d71983 X-VCS-Branch: eapi-9 Date: Wed, 11 Dec 2024 19:39:58 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 9394f0cc-e14f-457f-aba9-8f26bcc12b49 X-Archives-Hash: 906599618ca19f5638d537aa722dbacb Message-ID: <20241211193958.ouPhIvpS2NVrf1N1Tyk6a2Op0Z2kxX43cwOYLrc8hpI@z> commit: 3503c8704b402b171f5f9509a817fe43e9d71983 Author: Ulrich Müller gentoo org> AuthorDate: Fri Nov 29 16:02:17 2024 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Sun Dec 8 21:37:19 2024 +0000 URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=3503c870 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 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 \\