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 1481 invoked from network); 26 Sep 2021 06:24:42 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 26 Sep 2021 06:24:42 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1632637482; b=P8qXT9wlMu5YTjCwEqN40YHYo/rvrS3gQQQa2ip6CS1qXfbqYW4RgXonSvFbpNumHgQQH815Iq NB/HUpjq0f4SWhB5O1o2mIqe/xy813PZtDGi1rYfkhae/rI+x1Teozn955UmQnBoOTewp0zdvn RwuJOEgYDL14QWli45fK3xjO4EZFFW7WP2xff6B/yJyCVnebxvkXvFv85b0fU4YarLAOIikXls A4a54Oc2upvevRqAroBDY5fa28Ha2zJITmpNG9IJNPr5ADm+1c/lBFPFGhSg6kL8XsWiA2DF/E mfrRfaGSx4mgP4BfHB7qV7nWYQpBi1aT2YClWndMmMOTsA==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (forward100o.mail.yandex.net) smtp.remote-ip=37.140.190.180; 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=1632637482; bh=cQfY+JhLVsJL1r1rZuhYc1fS46xmX1TvoikzNXAftDw=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:MIME-Version:References: In-Reply-To:Message-ID:Date:Subject:Cc:To:From:DKIM-Signature: DKIM-Signature; b=kBZgw+9KDzWNPVKM1AmOuJiXMDO7kiFfEp3sznNcT3OEAB4xysquHUzhtASPAGfEV48Y39xir3 AyWnc+kYF6d3UMC721FC6e+rQ34x+C+eltL9xL4M6W7yvv8ziogXFOFhF0aJgwg6EJG7JB5xue 51xN5F83cQ4tJwF8k0SXoFm/b50KcNjqSt1V/cKgQ2CFXSibeJ2eOZ6Q0q1Yuivo6gflszsSHu EPkIn9fFIlTPj3mkm1sPbYWH5VVGU6RGqT0gKNT4jCe+cegN1Nfk0S4FkF5LfDyiLfTGej39MD 0cf3JmFN7dd1+pQTTD/5uBu5y4dWACMutEYv52yn9WpZaA==; 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: MIME-Version:References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From: Reply-To:Content-Type:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=osEib1ayNxLIS0piWIsDBk1sordpfv4FdfZSHXAkvAs=; b=Qi3cvBbHsstOLH/Mxbx0aRoetp gpcAJnhSCER89gi9/9tCznNv/HvjcNqe7bcesn7UTp/K2oJW8fKCvg5DVzZRZV8t0RUi3ObdjWKjW bEKeNhIoQPUUpUVqsGLS/T+TwoRtT8jJRnzlWtRn9iBCXpNhWHBpV7LWM1rC8CRek5YPl0hl2f3/8 Mk6sydNEFFDgjv0dr11bdKg7HXjrnishw/DzxnIl4sUXxSVJsYLEjwmXb3l7CnWfSxG254aErSDOV CF57fg0kS4v0bhLhj0YymVdU/w+fT1hDmklLZ3iQPpeImRb7eh9rr5TK+x6xuqAE5yE6tN1Rl1bix Y/Sm4CcA==; Received: from authenticated user by zero.zsh.org with local id 1mUNab-0007Du-SI; Sun, 26 Sep 2021 06:24:41 +0000 Authentication-Results: zsh.org; iprev=pass (forward100o.mail.yandex.net) smtp.remote-ip=37.140.190.180; dkim=pass header.d=ratijas.tk header.s=mail header.a=rsa-sha256; dmarc=none header.from=ratijas.tk; arc=none Received: from forward100o.mail.yandex.net ([37.140.190.180]:60314) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) id 1mTOAk-000ALN-Ag; Thu, 23 Sep 2021 12:49:54 +0000 Received: from myt6-5c8bb24560be.qloud-c.yandex.net (myt6-5c8bb24560be.qloud-c.yandex.net [IPv6:2a02:6b8:c12:299e:0:640:5c8b:b245]) by forward100o.mail.yandex.net (Yandex) with ESMTP id 1B6D552ABC77; Thu, 23 Sep 2021 15:49:53 +0300 (MSK) Received: from myt5-cceafa914410.qloud-c.yandex.net (myt5-cceafa914410.qloud-c.yandex.net [2a02:6b8:c12:3b23:0:640:ccea:fa91]) by myt6-5c8bb24560be.qloud-c.yandex.net (mxback/Yandex) with ESMTP id fINBVGdOnh-nqEO2VSW; Thu, 23 Sep 2021 15:49:53 +0300 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ratijas.tk; s=mail; t=1632401393; bh=osEib1ayNxLIS0piWIsDBk1sordpfv4FdfZSHXAkvAs=; h=In-Reply-To:Message-Id:References:Date:Subject:To:From:Cc; b=g7lpUp5bgGvKmWqNK8Z0MTT4yqnOdwAcrfpqPhtPfbN7V4uiPkQQE0LBP+mToPfLV NWKgFv5iCskJgzXiOcWtrkx8MXSfqPYQ+ubenR7bTTDqk/juGHuVRAInx5NKoF5LWB +q1hE1rYnpukPcznGKlrG11ZeDvI+0Gloaqu1wEo= Authentication-Results: myt6-5c8bb24560be.qloud-c.yandex.net; dkim=pass header.i=@ratijas.tk Received: by myt5-cceafa914410.qloud-c.yandex.net (smtp/Yandex) with ESMTPSA id i5N2tEcia6-nqZaPf7e; Thu, 23 Sep 2021 15:49:52 +0300 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) (Client certificate not present) From: ivan tkachenko To: zsh-workers@zsh.org Cc: =?UTF-8?q?Lawrence=20Vel=C3=A1zquez?= , ivan tkachenko Subject: [PATCH 2/2] Make Parameter Expansion syntax more discoverable in docs Date: Thu, 23 Sep 2021 15:49:41 +0300 Message-Id: <20210923124941.4895-2-me@ratijas.tk> X-Mailer: git-send-email 2.33.0 In-Reply-To: <20210923124941.4895-1-me@ratijas.tk> References: <13541632399773@mail.yandex.ru> <20210923124941.4895-1-me@ratijas.tk> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Validation-by: larryv@zsh.org X-Seq: 49440 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: It affects all three occurrences of double-flags in Parameter Expansion sub-section: * ${^^spec} * ${==spec} * ${~~spec} --- Doc/Zsh/expn.yo | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo index eea147bde..d40d1b439 100644 --- a/Doc/Zsh/expn.yo +++ b/Doc/Zsh/expn.yo @@ -872,7 +872,8 @@ of the string tt($-) and the array tt($*) respectively. If tt(POSIX_IDENTIFIERS) is set, then braces are required for the tt(#) to be treated in this fashion. ) -item(tt(${^)var(spec)tt(}))( +xitem(tt(${^)var(spec)tt(})) +item(tt(${^^)var(spec)tt(}))( pindex(RC_EXPAND_PARAM, toggle) cindex(array expansion style, rc) cindex(rc, array expansion style) @@ -895,7 +896,8 @@ happening later. If word splitting is also in effect the tt($var[)var(N)tt(]) may themselves be split into different list elements. ) -item(tt(${=)var(spec)tt(}))( +xitem(tt(${=)var(spec)tt(})) +item(tt(${==)var(spec)tt(}))( pindex(SH_WORD_SPLIT, toggle) cindex(field splitting, sh style, parameter) cindex(sh, field splitting style, parameter) @@ -911,7 +913,8 @@ Note that splitting is applied to var(word) in the assignment forms of var(spec) em(before) the assignment to var(name) is performed. This affects the result of array assignments with the tt(A) flag. ) -item(tt(${~)var(spec)tt(}))( +xitem(tt(${~)var(spec)tt(})) +item(tt(${~~)var(spec)tt(}))( pindex(GLOB_SUBST, toggle) Turn on the tt(GLOB_SUBST) option for the evaluation of var(spec); if the `tt(~)' is doubled, turn it off. When this option is -- 2.33.0