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,HTML_MESSAGE,MAILING_LIST_MULTI,MIME_QP_LONG_LINE, RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 9578 invoked from network); 24 Apr 2022 08:13:06 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 24 Apr 2022 08:13:06 -0000 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:To:In-Reply-To:Cc:References: Message-Id:Date:Subject:Mime-Version:From:Content-Transfer-Encoding: Content-Type:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=u0itwGkgCQNviz5tBRc0dFGF/Q8jjBkYeARwq72OFUw=; b=UZPyuUXGbESXJSOkboplFndX+M w/B39E8IWmhxU42GutFCR+uo6Ly/cWUa+uYsgmeuGApMxLq+mE5QnL/TcKdvrvHlvw87Xqoguu9CH X5tz8OD60kKc2/qM0cTZiCu6DzmVAW4MCrha0GGfv/NBrQDTU7z09CrhjZxaSbbCXKEdLC3K39HaA FSgAxP09MpJBx7ZAVwAqtzvh9Hqy6m5m3nHkB10iOo2lIbasYnEmB6Rxm9H0YGVXsuGGoduMjGRlq StOQko8lLqm1RTCr0iqhpUeojRAdJ3S8jxeY0KI4netCVj0F1VgQ88kJ7ijaBB8Le1AZ9hwtCCHCG 3rEbWqfg==; Received: from authenticated user by zero.zsh.org with local id 1niXMg-0006pa-1d; Sun, 24 Apr 2022 08:13:06 +0000 Received: from authenticated user by zero.zsh.org with esmtpsa (TLS1.3:TLS_AES_256_GCM_SHA384:256) id 1niXMN-0006W4-3x; Sun, 24 Apr 2022 08:12:47 +0000 Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailauth.nyi.internal (Postfix) with ESMTP id 9C26F27C0054; Sun, 24 Apr 2022 04:12:44 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute3.internal (MEProxy); Sun, 24 Apr 2022 04:12:44 -0400 X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrtdelgddtvdcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurheptgfghfggufffkfhfvegjvffosegrje hmrehhtdejnecuhfhrohhmpefnrgifrhgvnhgtvggpgggvlhojiihquhgviicuoehlrghr rhihvhesiihshhdrohhrgheqnecuggftrfgrthhtvghrnhephfevledtteduffetlefffe ffheekudeuvdeltdfffffgudffjefggfeufffgjeelnecuvehluhhsthgvrhfuihiivgep tdenucfrrghrrghmpehmrghilhhfrhhomheplhgrrhhrhihvodhmvghsmhhtphgruhhthh hpvghrshhonhgrlhhithihqdduudehudekjeejtdegqdduudelvdejfeekhedqlhgrrhhr hihvpeepiihshhdrohhrghesfhgrshhtmhgrihhlrdgtohhm X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sun, 24 Apr 2022 04:12:44 -0400 (EDT) Content-Type: multipart/alternative; boundary=Apple-Mail-69E52915-C135-443B-88F7-16D0E928FC33 Content-Transfer-Encoding: 7bit From: =?utf-8?Q?Lawrence_Vel=C3=A1zquez?= Mime-Version: 1.0 (1.0) Subject: Re: Problems in `zshmisc` manual page Date: Sun, 24 Apr 2022 04:12:41 -0400 Message-Id: <12B5A0D6-2F16-4100-958A-08B88366620D@zsh.org> References: Cc: zsh-workers@zsh.org In-Reply-To: To: Emily Seville X-Mailer: iPhone Mail (19E258) X-Seq: 50088 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: --Apple-Mail-69E52915-C135-443B-88F7-16D0E928FC33 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable > On Apr 24, 2022, at 3:13 AM, Emily Seville wro= te: > =EF=BB=BF > There is no mention of a terminator after list. It's better to rewrite com= mand description as: >=20 >> if list term then list term [ elif list term then list term ] ... [ else l= ist term ] fi I don=E2=80=99t see the need for this. The term =E2=80=9Clist=E2=80=9D is al= ready defined to include the terminator, so replacing every instance of =E2=80= =9Clist=E2=80=9D with =E2=80=9Clist term=E2=80=9D would be incorrect, repeti= tive, and visually noisy. > A list is a sequence of zero or more sublists, in which each sublist is te= rminated by =E2=80=98;=E2=80=99, =E2=80=98&=E2=80=99, =E2=80=98&|=E2=80=99, =E2= =80=98&!=E2=80=99, or a newline. This terminator may optionally be omitted f= rom the last sublist in the list when the list appears as a complex command i= nside =E2=80=98(...)=E2=80=99 or =E2=80=98{...}=E2=80=99. --=20 vq Sent from my iPhone= --Apple-Mail-69E52915-C135-443B-88F7-16D0E928FC33 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable
= On Apr 24, 2022, at 3:13 AM, Emily Seville <emilyseville7cf@gmail.com>= wrote:
=EF= =BB=BF
There is no mention of a terminator after <= b>list. It's better to rewrite command description as:

=
if list term then list term [ elif list term then list term ] ... [ else list term ] fi

I don=E2=80=99t see the need f= or this. The term =E2=80=9Clist=E2=80=9D is already defined to include the t= erminator, so replacing every instance of =E2=80=9Clist=E2=80=9D with =E2=80= =9Clist term=E2=80=9D would be incorrect, repetitive, and visually noisy.

list is a sequence of zero or more sublists, in whi= ch each sublist is terminated by =E2=80=98;=E2=80=99, =E2=80=98&=E2=80=99, =E2=80=98&|=E2=80=99, =E2=80=98&!=E2=80=99, or a newline. This terminator may optionally be omitte= d from the last sublist in the list when the list appears as a complex comma= nd inside =E2=80=98(...)=E2=80=99 or =E2=80=98<= tt style=3D"-webkit-text-size-adjust: auto;">{...}=E2=80=99.

-- 
vq
Sent from my iPhone
= --Apple-Mail-69E52915-C135-443B-88F7-16D0E928FC33--