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.