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 269CD1581F3 for ; Fri, 29 Nov 2024 16:46:26 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 2D21EE07D4; Fri, 29 Nov 2024 16:46:25 +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 2EF3BE07D4 for ; Fri, 29 Nov 2024 16:46:24 +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) server-digest SHA256) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 444C433BE19 for ; Fri, 29 Nov 2024 16:46:23 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id A39AED81 for ; Fri, 29 Nov 2024 16:46:21 +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: <1732896137.42da74a0e2b5f0a93acace279fcca3c6f5487dc6.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: 42da74a0e2b5f0a93acace279fcca3c6f5487dc6 X-VCS-Branch: eapi-9 Date: Fri, 29 Nov 2024 16:46:21 +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: cb5b9da6-8377-4c61-8ffc-53c2569b4cb3 X-Archives-Hash: 833cb255a13f8a761646d7e3fbcd47e7 commit: 42da74a0e2b5f0a93acace279fcca3c6f5487dc6 Author: Ulrich Müller gentoo org> AuthorDate: Fri Nov 29 16:02:17 2024 +0000 Commit: Ulrich Müller gentoo 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 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 \\