From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-3.2 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_EF,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.4 Received: from zero.zsh.org (zero.zsh.org [IPv6:2a02:898:31:0:48:4558:7a:7368]) by inbox.vuxu.org (Postfix) with ESMTP id 37CEB26F00 for ; Thu, 7 Mar 2024 07:54:12 +0100 (CET) ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1709794452; b=VILPCiE4XuXR8MjGCkY2YdigBzMLoV9BlB19MBwpoEoRh4xRtXoMia6jgLWzcFJA3IkJBvFBUU 9S9oiWnXooM9NxnEK/KB42FtpeSIvmvWb8q+xMHy/T4JZT3LnsRc0xt9FFRZc4THDc1XRBApIS QckZs+jAN79tmRWMdu5aI3ndsqzX88gDwa+RyjBCb1dN34SCK4WKMsurgTQh15j2peO3o+jbj3 jWygpq8uAMnnPVC9EFtj1TUf0a5belMb7eaHGAg1vrsaiPfWitCZI/T3LTMso7kvxz9J+q7npL D/xqML3qoTsvHhMQud+erMR6JJuBuqEtr2ce8YMlabQsiA==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (relay7-d.mail.gandi.net) smtp.remote-ip=217.70.183.200; dmarc=none header.from=chazelas.org; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1709794452; bh=kRsQqMz9SaXRee+gvHgB9IqKUzO1TSOS1dWYbPLQ02c=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:In-Reply-To:Content-Type:MIME-Version:References:Message-ID: Subject:To:From:Date:DKIM-Signature; b=VSRFfUcssooyGkNKK27O9uqgdhTcLP+ml3PU1yT3ad/x6dkiL93kXsmxgVtA4iIqaf+2POxe08 TOk0YeOHen88x2W6f1wjx6pM5RGSSvxBu3VlHEO2nJszjz6Ky6ugKHeRR8ItvOUqc2s98HDvjP PxLyAvRpJZOfBS4lyJunXS6dvgzz1rDJ68nnlGZiJezDJXxbpEhCHEeHeDeuPBm5Fjs6fO/jPh CfwDAQZ20BqES/kn6G75XWdS5sU2evF3MjCPKmN7Lok7eJgwPpPCRN+ekC7Hep6ecX16q0KbJN ZyQ5dqnS8b8i0Ynmj2VvQ7+kV9CP4oBgEOR/MvZzKLmCwQ==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20210803; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:In-Reply-To:Content-Type:MIME-Version :References:Message-ID:Subject:To:From:Date:Reply-To:Cc: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=yuku1yxnUmIos3o8OIrKuL7CPaFY9rZGaB9ud2k/lCY=; b=eLCCRLj9kBTO0FzkXoNfsNq4WL Qf6vcJMB22xve/zH4CfSpLRSyz0kylacXGEv3QIFoffIyyQwIoUdv5QAJPxdNfyygOpCFj0oiZ333 iV0zOUOmCPQkIOS2lA8N5J0e2hPfcP/RZXKouPvTc6mYRwYyR4VVMUsfoyQ3CQYRFr9svwessf0aX +97vZp7X7PY/S1Rg7BaDOEmskPJig5EVMx6KgKaToJgHwYEMppk3siyT3FTkPlMa8B1LM5xIsc8K5 c6JUbTPA51kmhYzPUkdwIQVgCCZZJ8UwITt9nbkDotHq1HdbEHYZy4clfIjL0p6Oxe1X9EUTCe1/A 2v+1FQSA==; Received: by zero.zsh.org with local id 1ri7ds-0002ua-2u; Thu, 07 Mar 2024 06:54:12 +0000 Authentication-Results: zsh.org; iprev=pass (relay7-d.mail.gandi.net) smtp.remote-ip=217.70.183.200; dmarc=none header.from=chazelas.org; arc=none Received: from relay7-d.mail.gandi.net ([217.70.183.200]:48205) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) id 1ri7dc-0002b6-6C; Thu, 07 Mar 2024 06:53:56 +0000 Received: by mail.gandi.net (Postfix) with ESMTPSA id DA53920002 for ; Thu, 7 Mar 2024 06:53:55 +0000 (UTC) Date: Thu, 7 Mar 2024 06:53:54 +0000 From: Stephane Chazelas To: Zsh hackers list Subject: [PATCH][DOC] zsh_eval_context doc improvements (Was: PS2 shows "cmdsubst" for process substitution) Message-ID: <20240307065354.6eq7ptd5w6iwctf2@chazelas.org> Mail-Followup-To: Zsh hackers list References: <20240307063256.qvnogt566fm4ooca@chazelas.org> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="rlpbxvjlcbgiskrc" Content-Disposition: inline In-Reply-To: <20240307063256.qvnogt566fm4ooca@chazelas.org> X-GND-Sasl: stephane@chazelas.org X-Seq: 52704 Archived-At: X-Loop: zsh-workers@zsh.org Errors-To: zsh-workers-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-workers-request@zsh.org X-no-archive: yes List-Id: List-Help: , List-Subscribe: , List-Unsubscribe: , List-Post: List-Owner: List-Archive: --rlpbxvjlcbgiskrc Content-Type: text/plain; charset=us-ascii Content-Disposition: inline 2024-03-07 06:32:56 +0000, Stephane Chazelas: [...] > cmdsubst cmdsubst cmdsubst> echo $zsh_eval_context > toplevel cmdsubst outsubst equalsubst > > > Those "cmdsubst" are a bit misleading. Would it be possible to > change it to those equalsubst, outsubst, insubst from > zsh_eval_context (or just procsubst for process substitution for > all 3)? [...] BTW, I've noted a couple of problems in the zsh_eval_context doc, addressed in the patch attached: - added the new ${ ... } and ${| ...} to the list where $zsh_eval_context has "cmdsubst" - replaced the "file substitution" wording (not used anywhere else) with "process substitution" (from ksh and used elsewhere). -- Stephane --rlpbxvjlcbgiskrc Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="zsh_eval_context-doc.diff" diff --git a/Doc/Zsh/params.yo b/Doc/Zsh/params.yo index 8c5e67e70..65a337595 100644 --- a/Doc/Zsh/params.yo +++ b/Doc/Zsh/params.yo @@ -1030,11 +1030,12 @@ Code specified by the tt(-c) option to the command line that invoked the shell. ) item(tt(cmdsubst))( -Command substitution using the tt(`)var(...)tt(`) or -tt($+LPAR())var(...)tt(RPAR()) construct. +Command substitution using the tt(`)var(...)tt(`), +tt($+LPAR())var(...)tt(RPAR()), tt(${ )var(...)tt( }) or +tt(${|)var(...)tt(}) construct. ) item(tt(equalsubst))( -File substitution using the tt(=+LPAR())var(...)tt(RPAR()) construct. +The tt(=+LPAR())var(...)tt(RPAR()) form of process substitution. ) item(tt(eval))( Code executed by the tt(eval) builtin. @@ -1062,13 +1063,13 @@ item(tt(globsort))( Code executed to order files by the tt(o) glob qualifier. ) item(tt(insubst))( -File substitution using the tt(LPAR())var(...)tt(RPAR()) construct. +The tt(>LPAR())var(...)tt(RPAR()) form of process substitution. ) item(tt(sched))( Code executed by the tt(sched) builtin. --rlpbxvjlcbgiskrc--