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,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 1134 invoked from network); 26 Sep 2021 06:21:31 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 26 Sep 2021 06:21:31 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1632637291; b=TIN8xPXQ8r2EKMCLpmVG5iduzlRjDOy9m19QetgdP6ZncRBQwAFsq4id1vF2V+V9c3rAdxcMS2 wPuRcMsIx9lf7+2+XKBpnhlW7jqF675AIW6/bG3C+jByhyt4nfJGUf2C1kRCOzXp4vNs0BplBq PmUchZBmvVobcxfWdyIGXxhaChM5nGYWvrlaOCQJmUQWQvp3m/AX3kuar/WLE1/3qZyaDxjJqI Meb3OXnuCYV4TvJYEWAlF5ojVLwxObYbCVYuR8Q18TCdVSXz5UrF1TE4CFuvCsorvkcvcmyvSa 0d6z+Q+lbeUovNo6EY7LDbE26uWjuG+5Md2Qa902Ziirrw==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (out1-smtp.messagingengine.com) smtp.remote-ip=66.111.4.25; dkim=pass header.d=daniel.shahaf.name header.s=fm1 header.a=rsa-sha256; dkim=pass header.d=messagingengine.com header.s=fm3 header.a=rsa-sha256; dmarc=none header.from=daniel.shahaf.name; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1632637291; bh=wDTuFeItRNhSkstvOoDxO1QnPNB9lr3QPcrqMQG79Mk=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:Content-Type:Subject:To:From:Date: References:In-Reply-To:Message-ID:MIME-Version:DKIM-Signature: DKIM-Signature:DKIM-Signature; b=sI5MCSCwB/ZFUOaaz1XMLbc8W5ZyFo1qLdP28tBjX2NFPtSZ0eufgnVnqMjIL5XvJ6ZJMfQj59 DKOchpaZiqVwTw8rsd5Xts7uHw0G/GwHmT7lZ19/ltmJkMr+eAtnr0M/HqNSGrPPL+pT1OcTGd 5qt7BOnPysdV8Uk/vtMVse6lV4s/U3HHfhz9I6jfC1N/RkRj+jZ0ddkzX7S+baPyyjmCgrgncT ne0scgncFOdH0md6JxRsb/oXjh8uryOluUtc7oZUoRFebzi5+dZjW5T8g/8K4gEhTao/DlDx+m FRG9wssFqRTP9ccvq7NrsPDVC3sxKGD1uX9VONsNIWeDFg==; 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:Subject:To:From:Date:References:In-Reply-To:Message-Id: Mime-Version:Reply-To:Cc:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=3BaD2lxdwPU/lbEh/JLP8XRUogCHzQE57w8WnzuJVr8=; b=X4dsXX7LTncaZhUadbBe9IGYK5 JoMcUBnEkD718vrc5vFoCtLC4oQQ3QDLSWBU+oZeLu4isvBTcMsiZKw/H3b4YPq0/hjei3bvtNVAW ds5uHOz1XPj3sJM1L1p3KEZFozKYuC5zAgAFXk4/Cm4NHKciy+jPuzlYSswvxmoPhqyvQy97ekr6B Ld4D2exNfnA1IKCgdLWTNmsivXpVjuhquvM9krB9/SXCK+O2gfmMP+eBOcf5TgotGB4G6kZzcWcHm xTwaGiyZHx3J8lnAgbF2SfHAY5qNbNgPC9jZihwNrpYf1aRCg0exlsavSW3FDDBRcYeZ9ThT089Eo wz3mRWrw==; Received: from authenticated user by zero.zsh.org with local id 1mUNXX-00060w-L4; Sun, 26 Sep 2021 06:21:31 +0000 Authentication-Results: zsh.org; iprev=pass (out1-smtp.messagingengine.com) smtp.remote-ip=66.111.4.25; dkim=pass header.d=daniel.shahaf.name header.s=fm1 header.a=rsa-sha256; dkim=pass header.d=messagingengine.com header.s=fm3 header.a=rsa-sha256; dmarc=none header.from=daniel.shahaf.name; arc=none Received: from out1-smtp.messagingengine.com ([66.111.4.25]:37429) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_256_GCM_SHA384:256) id 1mUL8U-000M05-ME; Sun, 26 Sep 2021 03:47:32 +0000 Received: from compute6.internal (compute6.nyi.internal [10.202.2.46]) by mailout.nyi.internal (Postfix) with ESMTP id 5A58A5C011A for ; Sat, 25 Sep 2021 23:47:29 -0400 (EDT) Received: from imap46 ([10.202.2.96]) by compute6.internal (MEProxy); Sat, 25 Sep 2021 23:47:29 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= daniel.shahaf.name; h=mime-version:message-id:in-reply-to :references:date:from:to:subject:content-type :content-transfer-encoding; s=fm1; bh=3BaD2lxdwPU/lbEh/JLP8XRUog CHzQE57w8WnzuJVr8=; b=cprRodWKWoc0Pa4L9OPdDlXwqKBv7FTxnJLeXO8+j3 PFz5ssX7LgMPqbYTONDqU9dEjm8vlmM31C3eUwMUVwACkbIe7/1ldvYd8i93om9D f9vgdfM7bqhZG8S5uGY/+6Uw2M9ljjFjpvxYWarRAJRMYVk0B0Rm85MFLWr62ZTg jYh7UXPbd5mHtanzXXAb0Vp/C0cePGauCiCJoqegAu3M5EgFjbNGgZBdS/vcPvQ2 /FYMBpMMJF55QtastkJNN/6hH2jTwrFub6C0YtGMLRMzr7sztP4tDKKuLec4QhSt EpBjY/ayeCvE7StadHElALw3M7aNQx01jOrWXkRBEXGA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; bh=3BaD2lxdwPU/lbEh/JLP8XRUogCHzQE57w8WnzuJV r8=; b=PJa3VuPzklUKPEzaC3Vm5h1AZIHnv/rORu/jz5z0CpdLPu3SP/ZglIuLC ASqCsCm7Bl5Mp1ZEdr9g8GildiZijbZijChM7IfFJ73D6gnHBLqx5ApzGKYiWbLA FkqkVHwN7GdwtieeJbRvdTOBIOAo5z/kFqwNm+WeVXkbzI1RPY+c1El55APO0Z19 71wKoDvUC+YB2c/axrTJadQAMgWCnMDhjLxavdq2G5NF7HlHAhY6F37c6jc15SJ8 V11rGCtTNiahoANhw0P48SopnUTbPJk3UVkbvMd30mSAtPB4rZZbLdCMUau/fcaf fnfA15a05vTLfIDgiLUT/po8R5BrA== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddrudejgedgjeegucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucenucfjughrpefofgggkfgjfhffhffvufgtgfesth hqredtreerjeenucfhrhhomhepfdffrghnihgvlhcuufhhrghhrghffdcuoegurdhssegu rghnihgvlhdrshhhrghhrghfrdhnrghmvgeqnecuggftrfgrthhtvghrnhepfefhkeefve eileelheeiffdtkedujeelvdfhtdejtdeggedvuefffeelhefhvdfgnecuvehluhhsthgv rhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepugdrshesuggrnhhivghlrd hshhgrhhgrfhdrnhgrmhgv X-ME-Proxy: Received: by mailuser.nyi.internal (Postfix, from userid 501) id 2DD211EE0072; Sat, 25 Sep 2021 23:47:29 -0400 (EDT) X-Mailer: MessagingEngine.com Webmail Interface User-Agent: Cyrus-JMAP/3.5.0-alpha0-1303-gb2406efd75-fm-20210922.002-gb2406efd Mime-Version: 1.0 Message-Id: In-Reply-To: <13541632399773@mail.yandex.ru> References: <20210922211719.39806-1-me@ratijas.tk> <20210922211719.39806-2-me@ratijas.tk> <59ea44b5-1a20-4dbf-b661-0a84dafc11f1@www.fastmail.com> <13541632399773@mail.yandex.ru> Date: Sun, 26 Sep 2021 03:47:07 +0000 From: "Daniel Shahaf" To: zsh-workers@zsh.org Subject: Re: [PATCH 2/2] Add ${==spec} syntax more discoverable in docs Content-Type: text/plain;charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Seq: 49443 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: ivan tkachenko wrote on Thu, 23 Sep 2021 12:31 +00:00: > Also, I'd like to note that other sections of the Expansion chapter=20 > such as "14.3.1 Parameter Expansion Flags" need some template=20 > decorations too. I mean, try to search the page for, let's say, a=20 > letter "t". +1. We _could_ add parentheses around the flags, e.g., =C2=ABitem(+LPAR()%+RPAR())=C2=BB rather than =C2=ABitem(%)=C2=BB, so gr= epping for one-letter flags would be easier. We already do this in the prompt expansion expandos documentation, for instance. Would you like to do the honours? FWIW, I think most of us generally search for =C2=ABt=C2=BB as a whole w= ord, or use the man page and search for /^ *t\>/ (or perhaps fgrep the documentation sources for =C2=ABitem(tt(t=C2=BB=E2=80=A6). > Unless you are a *NIX shell guru and know exactly where and=20 > what to look for, you are toast. Well, one does need to know what part of the documentation to read, but that doesn't require or imply being a guru. > Readability and discoverability of this documentation can/should be > improved by a lot. Any specific observations or suggestions? Cheers, Daniel