From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-3.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, T_SCC_BODY_TEXT_LINE,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 6951 invoked from network); 31 Mar 2022 08:43:17 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 31 Mar 2022 08:43:17 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1648716197; b=ANqGygA8uqGeTUWJzBBoznNG037TMOC6jBybletf00Op7oaSiSOnjJr7EHPIa1nTe/R7CRiZbo 8k3/TLTe8WM7FxZ+5JrIzmDLYgCm6IQsWFvtELSw4YVOAAe0hvsLLLaNHVZ8CD61PALMsHghGI fNGVLBJpqq79pniBE1KUDw673LpdlnDtVynbBSYQNa4vb8sSjDwV7t1PHe5DdenKh8iWItzWNJ 7x0AlzNpDTvYchhIgjWAz2KS9ksFcl4IgpwWBa4A4s7iGOEAmTG+SoU6eASGPLxU1Tgo0jpy+1 SzXj+TwXXDqqO2LZFPsK3ohBJyOVBZlXpY+wKTJlvkungw==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (smtpq2.tb.ukmail.iss.as9143.net) smtp.remote-ip=212.54.57.97; dkim=pass header.d=ntlworld.com header.s=meg.feb2017 header.a=rsa-sha256; dmarc=pass header.from=ntlworld.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1648716197; bh=U0yoaWH4j3gMnTnKVpoyOdIbL8oO4saTD6WXvIK1npw=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:Content-Type:MIME-Version:Subject: References:In-Reply-To:Message-ID:To:From:Date:DKIM-Signature: DKIM-Signature; b=KHfCBL1dUHeJil7neLs8f8E0TLEaYkJpgPwr6oxze8jEui5jeA/U9FbjP1aftFKngfjXGRHjqf Q91anABFSdwn7laCV+20ENvqqSKXOE68PVSIqrFmAjEyNI01C3fLREhh6KtiGJNB6i91YxQHyR 7FjCZwJRNqL0NUpB1fIrZMB8oDjjs57e3JFYVUs/k8zjrvO21MGFaT8dxCgI+84P76O5WB0RQ9 AEsJH3mytwYGF9CEhiKZXSgLbEBkeEeU6n1IetUVBK5Dj7NdsYG+glz1uJwWSYAwTKNj49ivdV HjGBjW/sTMSXE4ot36uLJYlC3r0BnkG/ttmQUUE+h0y11Q==; 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:Content-Transfer-Encoding: Content-Type:MIME-Version:Subject:References:In-Reply-To:Message-ID:To:From: Date:Reply-To:Cc:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=HHejfdlFPypwO+wmlAtR4QSnV1fgZRUn38kDyX1twBI=; b=L8SCNUxhyX7cp2BXEqSwSZngCJ RNku4bG/kiNrupV4crBw5lbMQ9iO+8SO7o4GjbhdxK5UryBc1Mk9yHoRyxizlMKcI2MzBrNNmffMm ZaCawq8WvO6duKQm/MHWzn63XNQggHhJRFGpcWONQGxN7T0IJdZtQphe7piUJxp01h9PmVvR3UwHI x9LyFSYmKUITTavlKi5AYQ89Vt5EsTHzXG4iSkmFytvPQ4Mqtk3MG9Toc6MbxI31NJuQ4+ozf1IjN V3Av6yrGUPoLHfZd8P2VwZug9CaYhTVtYDHyvVXU9wpQeI5nKQ4PnT6xhZUK9033YqX6tJQ7KZsH2 38ksEm6g==; Received: from authenticated user by zero.zsh.org with local id 1nZqOi-0009N7-0r; Thu, 31 Mar 2022 08:43:16 +0000 Authentication-Results: zsh.org; iprev=pass (smtpq2.tb.ukmail.iss.as9143.net) smtp.remote-ip=212.54.57.97; dkim=pass header.d=ntlworld.com header.s=meg.feb2017 header.a=rsa-sha256; dmarc=pass header.from=ntlworld.com; arc=none Received: from smtpq2.tb.ukmail.iss.as9143.net ([212.54.57.97]:46628) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) id 1nZqNo-0008gy-7u; Thu, 31 Mar 2022 08:42:20 +0000 Received: from [212.54.57.80] (helo=smtp1.tb.ukmail.iss.as9143.net) by smtpq2.tb.ukmail.iss.as9143.net with esmtp (Exim 4.90_1) (envelope-from ) id 1nZqNn-00025j-Ql for zsh-users@zsh.org; Thu, 31 Mar 2022 10:42:19 +0200 Received: from oxbe25.tb.ukmail.iss.as9143.net ([172.25.160.156]) by smtp1.tb.ukmail.iss.as9143.net with ESMTP id ZqNnnIDJ2BAYNZqNnnRhJP; Thu, 31 Mar 2022 10:42:19 +0200 X-Env-Mailfrom: p.w.stephenson@ntlworld.com X-Env-Rcptto: zsh-users@zsh.org X-SourceIP: 172.25.160.156 X-CNFS-Analysis: v=2.4 cv=IZSU5Ema c=1 sm=1 tr=0 ts=6245696b cx=a_exe a=NA7IgXeTfPXpJV+SL5V8Rw==:117 a=wbvTLvLwOfMA:10 a=IkcTkHD0fZMA:10 a=7H6ixmLU1AQA:10 a=HYshxDoSAAAA:8 a=gx1CBIM47LfIdZ_mOVQA:9 a=QEXdDO2ut3YA:10 a=na7qQM7zoEAPfvOk0o6d:22 X-Authenticated-Sender: p.w.stephenson@ntlworld.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ntlworld.com; s=meg.feb2017; t=1648716139; bh=U0yoaWH4j3gMnTnKVpoyOdIbL8oO4saTD6WXvIK1npw=; h=Date:From:To:In-Reply-To:References:Subject; b=5JekK/O4np5q2GGcbBRo7+10eFfgA7amqdES30RwWG0GaRjjq2xXlutLkB1MTP6n6 oHmqEu52K0BZwb5SZ5ZfKyjZcqXJiGuD1BkzDQJJeLFOzlkm3XEI33/Mq3KbQMjoGb VIwIU4CITDzHWdhuaZyHvYfrSyWOS5qVYqdQYr7ZzAAd6pxDvtaPAJPQpvPQJdo3dE CPJ53+ahzYqkwborsjRJLR6nfVgNtAyYyv/S7x6EMygI0X4F43ASyTDQuURzUKx+/q OkzTMiZ3+hc5LdneFDXuhyjQ5vC0DZqJx5sOaY6+wkGfNe6dm3oNbmyzffvWRcpJ2Z rhjgNEsAixzkA== Date: Thu, 31 Mar 2022 09:42:19 +0100 (BST) From: Peter Stephenson To: Leah Neukirchen , zsh-users@zsh.org Message-ID: <1929934417.782788.1648716139543@mail2.virginmedia.com> In-Reply-To: <4ede1b1e-f441-4b67-bc30-158c3397ca1d@www.fastmail.com> References: <87im12pj3i.fsf@vuxu.org> <4ede1b1e-f441-4b67-bc30-158c3397ca1d@www.fastmail.com> Subject: Re: _brace_parameter: misleading help text for # MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Priority: 3 Importance: Medium X-Mailer: Open-Xchange Mailer v7.8.4-Rev72 X-Originating-IP: 147.161.167.85 X-Originating-Client: open-xchange-appsuite X-CMAE-Envelope: MS4xfKdvn8RQvqd7oB2LeVeQ3/6DBAAjQ5uy+t0g7qk0RaMOUTNJexZ9we5AesahKYSY7uUNZn4qauMafztJGlesjz/UjS761fvXQC9vfgoD6sCiG96WN911 +3exNXjZQf39R4bcpJAVGL62sgT9knPLN8iyUuU685sqfRpuCd6MUWDBCGkktsx+gMra88rNEA7+zgx1E6/v3/f6E9tQgQxME5mfnqUYGlZm+zmgGuqzqHj1 /0MoxYA9sX1pCgBk12Py7A== X-Seq: 27639 Archived-At: X-Loop: zsh-users@zsh.org Errors-To: zsh-users-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-users-request@zsh.org X-no-archive: yes List-Id: List-Help: List-Subscribe: List-Unsubscribe: List-Post: List-Owner: List-Archive: > On 31 March 2022 at 06:49 Lawrence Vel=C3=A1zquez wrote: >=20 >=20 > On Thu, Jul 22, 2021, at 9:35 AM, Leah Neukirchen wrote: > > echo ${( shows > > ... > > # -- evaluate as numeric expression > > ... > > > > zshexpn(1) says: > > # Evaluate the resulting words as numeric expressions and ou= tput > > the characters corresponding to the resulting integer. > > > > I think the help text is missing the crucial bit here: > > output the characters corresponding to the resulting integer. > > > > Perhaps > > "#:evaluate as numeric expression and interpret as character codes" > > or so would be a better description. >=20 > Apologies, Leah. This hasn't been addressed, as far as I can tell. >=20 > workers: Anyone want to take a stab at it? Yes, that's a good idea --- I think this sort of thing has confused me in the past. I'm wondering if the use of the phrase "the resulting words" is clear. It is explained at the top of parameter expansion, so I'm probably worrying about nothing --- i.e. it's already explicit that something like "32 65" is just one word unless you're in one of the cases where the shell does splitting on it. The phrase occurs repeatedly in this area, so it would need explaining higher up if it wasn't clear. But I'll leave it alone unless anyway else thinks they're confused. pws diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo index 00cbbcd27..bbacc6ae4 100644 --- a/Doc/Zsh/expn.yo +++ b/Doc/Zsh/expn.yo @@ -968,9 +968,10 @@ following flags are supported: =20 startitem() item(tt(#))( -Evaluate the resulting words as numeric expressions and output the -characters corresponding to the resulting integer. Note that this form is -entirely distinct from use of the tt(#) without parentheses. +Evaluate the resulting words as numeric expressions and interpret +these as character codes. Output the corresponding characters. Note +that this form is entirely distinct from use of the tt(#) without +parentheses. =20 If the tt(MULTIBYTE) option is set and the number is greater than 127 (i.e. not an ASCII character) it is treated as a Unicode character.