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=-2.7 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HTML_MESSAGE,HTML_MIME_NO_HTML_TAG,MAILING_LIST_MULTI, MIME_HTML_ONLY,RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 13528 invoked from network); 23 Sep 2021 12:31:57 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 23 Sep 2021 12:31:57 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1632400317; b=Emj8EGAWY820SQQlzSi3dRDBA4cPrOTGzaNwKbiIZskPbr32v4X0QYXYjifevKs7TNvDJ78Bat 5zt/NiBiDf9lVEsHTHLRLVzHViBw2fHectD4ya77z5Xfj08c4rHdiTVwYNtj16vm6UoGWEryiB 2ql3yVbJ+yVaCkLdHm9mzU8Wx89FCWEjFaYEYTTgf5R0j/FeZv9Zrl1zg5ziaok95IeTaWk2MC dQs8yS4AAdRKGpXrDvNrBX9l89GwsEDOyCzwCFBajcoOf39HN6j7Yd4egAf/mW6Rk+WvgaV96X cQTmzJ7GXo61F+Shqy4zxywWbs4P7q668BvGix4/lTcIjg==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (forward501o.mail.yandex.net) smtp.remote-ip=37.140.190.203; dkim=pass header.d=ratijas.tk header.s=mail header.a=rsa-sha256; dmarc=none header.from=ratijas.tk; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1632400317; bh=viquQo65wMN7zdAnv1C8CfJIA+ifJFufpW04Xg+U/Jw=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Type:Content-Transfer-Encoding:Message-ID:Date: MIME-Version:Subject:References:In-Reply-To:Cc:To:From:DKIM-Signature: DKIM-Signature; b=h7DUbDF+J1WVFbI10lt4rkDsnoYhENeAEMXf7r2P46yDiMhXCsf6GUU8iMUC1Y8A7Ebr4ZWOTb Qx0UQUp7foLUgTMXa9AEmNfPah/HVobNygA76SxMUmeJgvsDE/IMIIF7nmwW6B1OILcpBU6pz3 lt7krAseyZ9fCt4/LLCq2MDV7EIp483zsOSJQoToyPwId4yjKV0W4X5gRqiA9R4nUfb9RiY8lF 5iNOomIAYRX6qgcwq1Vu1us6kZOgQ1MnrJzLlq8dgrQktwQ64OucB16LhyxTTuJV9AKd2UkwSp DVVlNlFOiXRrz4kOFo+pkmfcze5s8DZMN4FR7MTmdKoiAA==; 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-Type: Content-Transfer-Encoding:Message-Id:Date:MIME-Version:Subject:References: In-Reply-To:Cc:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=viquQo65wMN7zdAnv1C8CfJIA+ifJFufpW04Xg+U/Jw=; b=Fe1tpAsveQsNwP2WO8Z5OF8q3Q LQ+jMRxqijxcTgoguNd9MWNJ5cW1twaUhoZ+SlloUPa/JBafg6FVdiN/kP1ADi3G7LB/Hh5/s7Cdz 7lIFXJqpKs/bAcvm7K320DbaSjT/jU9N0zhUNcBHjzU26QweJA8+FpOm35LYyEC+iq9gU+RFxkHrc HOZDN2ZhlHcfhIORxp/EJnXEp80jagqYA0oLIv6tKSlddvpXLMW+9LWU1aPkqvnBCIfBB1hTE/dYs 2xpvz8bE1bNAIWvqjSskTHNQm+8VfLCWj7529ibSc4YWRY4wGUZ0GFrLsJrJb022F4zaWga6GNLd5 9RECbgAw==; Received: from authenticated user by zero.zsh.org with local id 1mTNtM-0009Mw-1d; Thu, 23 Sep 2021 12:31:56 +0000 Authentication-Results: zsh.org; iprev=pass (forward501o.mail.yandex.net) smtp.remote-ip=37.140.190.203; dkim=pass header.d=ratijas.tk header.s=mail header.a=rsa-sha256; dmarc=none header.from=ratijas.tk; arc=none Received: from forward501o.mail.yandex.net ([37.140.190.203]:52640) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) id 1mTNsl-00093N-UC; Thu, 23 Sep 2021 12:31:21 +0000 Received: from myt5-00a806c30094.qloud-c.yandex.net (myt5-00a806c30094.qloud-c.yandex.net [IPv6:2a02:6b8:c12:f92:0:640:a8:6c3]) by forward501o.mail.yandex.net (Yandex) with ESMTP id 72C5045C4338; Thu, 23 Sep 2021 15:31:16 +0300 (MSK) Received: from 2a02:6b8:c12:4c0c:0:640:b4bf:12e3 (2a02:6b8:c12:4c0c:0:640:b4bf:12e3 [2a02:6b8:c12:4c0c:0:640:b4bf:12e3]) by myt5-00a806c30094.qloud-c.yandex.net (mxback/Yandex) with HTTP id EVe7lH9FUmI1-VFFeIJXj; Thu, 23 Sep 2021 15:31:15 +0300 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ratijas.tk; s=mail; t=1632400275; bh=viquQo65wMN7zdAnv1C8CfJIA+ifJFufpW04Xg+U/Jw=; h=References:Date:Message-Id:Cc:Subject:In-Reply-To:To:From; b=bFsNiZtVzKaZ7YoXRMtW2QzevjloMd5Hv0lx6EGd5Bszdkucc+9zNHWsxCA4XyZ7K GjX5PkcGDh+Sx+cAyR/oUHfcSmXd5+Py1ZHAxeZqNUq5Cf/UmfyLzDdHEq0LZg4AGk rs/6AJQJ0eCrlNllcysuzKvHTe2KAFVmenq0/5jA= Authentication-Results: myt5-00a806c30094.qloud-c.yandex.net; dkim=pass header.i=@ratijas.tk Received: by myt6-b4bf12e3bb53.qloud-c.yandex.net with HTTP; Thu, 23 Sep 2021 15:31:15 +0300 From: ivan tkachenko To: =?utf-8?B?TGF3cmVuY2UgVmVsw6F6cXVleg==?= Cc: "zsh-workers@zsh.org" In-Reply-To: <59ea44b5-1a20-4dbf-b661-0a84dafc11f1@www.fastmail.com> References: <20210922211719.39806-1-me@ratijas.tk> <20210922211719.39806-2-me@ratijas.tk> <59ea44b5-1a20-4dbf-b661-0a84dafc11f1@www.fastmail.com> Subject: Re: [PATCH 2/2] Add ${==spec} syntax more discoverable in docs MIME-Version: 1.0 X-Mailer: Yamail [ http://yandex.ru ] 5.0 Date: Thu, 23 Sep 2021 20:31:15 +0800 Message-Id: <13541632399773@mail.yandex.ru> Content-Transfer-Encoding: 8bit Content-Type: text/html; charset=utf-8 X-Seq: 49438 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:

This might also be useful for ${^^spec} and ${~~spec}.

Sounds reasonable. I'll amend the commit, and send a new patch set in a few moments.
 
Also, I'd like to note that other sections of the Expansion chapter such as "14.3.1 Parameter Expansion Flags" need some template decorations too. I mean, try to search the page for, let's say, a letter "t". Unless you are a *NIX shell guru and know exactly where and what to look for, you are toast. Readability and discoverability of this documentation can/should be improved by a lot.
 
--
ivan (@ratijas)