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.3 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, 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 7703 invoked from network); 4 Sep 2022 06:43:53 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 4 Sep 2022 06:43:53 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1662273833; b=Q0dJkSsLQ/24jxVODWMpPyHcYgPTC+mniKnAUMNBqyc3CiAAsm5+mXPE2Gt6+MrOuEMLr0+6U8 lgmbmHBhnwsBTxdvvnYsDcLWJS09hoxECN501g2o4G4+3VOVR/oUzL6JIlavLHDOyVWOgeIHOm 9QKOvkfDBpAw+Cmp9iGUZ0X9dukiGGw54Z2yYv2mN6PwIrIP4MYfO0De46ZO4NaPcA7I1TPhgt +bKtnFNjd5jSROAwMOov4ReBq8qiMQtGlF9gyZ7VHIPWTTrZyjx+xQrlQ7OWfjw4eApcszWkqH nDt0cwVsUtxjoiUYDRzVQ7hI+Qa/wuv+6qx8DtTTp8pRbQ==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (out3-smtp.messagingengine.com) smtp.remote-ip=66.111.4.27; dkim=pass header.d=daniel.shahaf.name header.s=fm3 header.a=rsa-sha256; dkim=pass header.d=messagingengine.com header.s=fm1 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=1662273833; bh=WqtUXmBIxHkST4KtPkrLMBeX4mwcuiiMLIRWrg54ubM=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:In-Reply-To:Content-Transfer-Encoding:Content-Type: MIME-Version:References:Message-ID:Subject:To:From:Date:DKIM-Signature: DKIM-Signature:DKIM-Signature; b=I4E+9GwXZ4sZEMIwAySzI26xIt2PNnNWNckCueSjAPgrLxXYU/LFh3jhLqOOyAN2Ktc4FnMP7n /J/G8nYa0kySWAdNuR/w5Wdv+PmYbzh3INIHzlJihAI433AeWUXnbyxqBf2QDwHnlQigP9b2fO f4jmlvdVbq2jUAqlvZ7v2Pzw2U0cy4+5+fySLbSPU6mUUkRRwHktRtotaYq+J7kvcVpew4/mOM SIV6qB8oIX871NDW4VuvpcunHr+PY0G4XU7Jx+KQJiDN1oAjOqgrhLgn66u6QNB5CirCg5BzHK 59y/3CtbDOR0uMD3bLkxhKPSvM4akE5de6z5OrLQGBMJNw==; 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:In-Reply-To:Content-Transfer-Encoding :Content-Type:MIME-Version:References:Message-ID:Subject:To:From:Date: Reply-To:Cc:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=Y75H+mCiFEG1ivMtQum/3mU5ZEhiN2xSXP1uVaeB0Y4=; b=YvGTLeJkV/Sqxp69x/KI54eFyY KAfBqHZsdu+hGBFtsvIzwy7XQwNKxdT6X8nrXt0Kthir0Lr2QjnfVEZtA4ODhdlvyw1k/fC+8SC+O f8OvLTZXCt6V9/N5hmc4ovw9w/J170WYrUl1BkMlqsLiclIpNISnWEtzqa3ThuJasz8BzPSNiW1eX LJ7jQKmwIjM3lloVMw7kDVHMaw9BncQOTgQ9rwuvXprXHJZQriaz+LJ8a1Ia9TyIDmvEvvfvHm6cu +0NPFmKRWHYi2JW3vUoVBd5G8lPRokdVEX+hTaFYM6OUkzAe6kwD/t9rQ/cS/5tQIw7rQ3BGkdP+Q eX7Hu0vQ==; Received: from authenticated user by zero.zsh.org with local id 1oUjMC-000D6j-Vb; Sun, 04 Sep 2022 06:43:49 +0000 Authentication-Results: zsh.org; iprev=pass (out3-smtp.messagingengine.com) smtp.remote-ip=66.111.4.27; dkim=pass header.d=daniel.shahaf.name header.s=fm3 header.a=rsa-sha256; dkim=pass header.d=messagingengine.com header.s=fm1 header.a=rsa-sha256; dmarc=none header.from=daniel.shahaf.name; arc=none Received: from out3-smtp.messagingengine.com ([66.111.4.27]:37645) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_256_GCM_SHA384:256) id 1oUjKv-000CPL-EM; Sun, 04 Sep 2022 06:42:31 +0000 Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.nyi.internal (Postfix) with ESMTP id A23B15C0073; Sun, 4 Sep 2022 02:42:27 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute3.internal (MEProxy); Sun, 04 Sep 2022 02:42:27 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= daniel.shahaf.name; h=cc:content-transfer-encoding:content-type :date:date:from:from:in-reply-to:in-reply-to:message-id :mime-version:references:reply-to:sender:subject:subject:to:to; s=fm3; t=1662273747; x=1662360147; bh=Y75H+mCiFEG1ivMtQum/3mU5Z EhiN2xSXP1uVaeB0Y4=; b=aIkNxE5oShrxlHlBst7bUHR8OAX8zDwU4A6F4YCgS zbp8gB2Ta8ChxumpqHr5uzTQS4Hew9r+kVDHxRxLWUHgpZEs2noebs1B/FqAPUKZ KZNM7SitLahys3Gv/f4gvF/OrqH2InMM6tElxJmcDHj2sv0IdZR1OmURgoA3Yagx DUcwocwaVJi1i8adgrRftKk4oy/HKi4S/Dom9xUyg2GDogV+dmXDF/RK1qHQx5vB 1TmgCeHf83h6eMCYF2lRU39xKJnAMwF3ouj47jgstT4bDL2eABtULwrFdV6eSzUL X+ILtUtwIsEyqVeyD/D+E/QigyXIII8fHexBsmu8uN3ng== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:date:feedback-id:feedback-id:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:sender :subject:subject:to:to:x-me-proxy:x-me-proxy:x-me-sender :x-me-sender:x-sasl-enc; s=fm1; t=1662273747; x=1662360147; bh=Y 75H+mCiFEG1ivMtQum/3mU5ZEhiN2xSXP1uVaeB0Y4=; b=ag6J0ZN8duv0JtDlN 3hsvt/WCtZ0g3WYGmjh2Xm+ikC1lxR5gokvXYjmcNhV+j8Q+KpBYYZkX2fVEl7TJ DN6GY/BQRvXwO6O520gTCRxGY/gZiJhm/0u5rKJ57Z39MN75HAI1rJgE8DDFTuIB RY1SNAyM5riIPflgJw7CuFWPbLNlIuvxxeea27sL1o01Y5FNItZ7HhsHymchbEpj rhpidEjcym0QYIElW8yzyIQDktuJqg0dW18yhtZvDCj3/B1c/nSULoi0Kwfshzyh xogwxTsIRDgbTg6K4FbcLk7dpCNloHCH42yffWMLVLeCcS7FvorN8I67hseBtpfe o5+Rw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrvdelfedguddutdcutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhepfffhvffukfhfgggtugfgjggfse htkedttddtreejnecuhfhrohhmpeffrghnihgvlhcuufhhrghhrghfuceougdrshesuggr nhhivghlrdhshhgrhhgrfhdrnhgrmhgvqeenucggtffrrghtthgvrhhnpefgkefgfeejgf dvvdfguddtleelkedvfeetiedtudfhveevveduhfdvveeffedvueenucevlhhushhtvghr ufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegurdhssegurghnihgvlhdrsh hhrghhrghfrdhnrghmvg X-ME-Proxy: Feedback-ID: i425e4195:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Sun, 4 Sep 2022 02:42:27 -0400 (EDT) Received: by tarpaulin.shahaf.local2 (Postfix, from userid 1000) id 4ML2Bm2Swyz1Y6; Sun, 4 Sep 2022 06:42:24 +0000 (UTC) Date: Sun, 4 Sep 2022 06:42:24 +0000 From: Daniel Shahaf To: zsh-users@zsh.org Subject: Re: Most minimal configuration challenge Message-ID: <20220904064224.GO5920@tarpaulin.shahaf.local2> References: <0e8bc96d-17a7-4be2-afab-7a0fd827866f@www.fastmail.com> <5141de6b-dbee-4d4b-3b74-d95a671fa04e@luffy.cx> <33d0bd1a-4da7-416d-a92a-04ceb07d1107@www.fastmail.com> <1c9b6072-26e7-467e-b8cc-7d44f15eaf1b@www.fastmail.com> <9116efd4-7c88-4ea3-9601-9c522236fee7@www.fastmail.com> <20220831092831.GA992100@zira.vinc17.org> <20220902092640.GJ5920@tarpaulin.shahaf.local2> <20220902144434.GG255755@cventin.lip.ens-lyon.fr> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20220902144434.GG255755@cventin.lip.ens-lyon.fr> User-Agent: Mutt/1.10.1 (2018-07-13) X-Seq: 28039 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: Vincent Lefevre wrote on Fri, Sep 02, 2022 at 16:44:34 +0200: > On 2022-09-02 09:26:40 +0000, Daniel Shahaf wrote: > > Vincent Lefevre wrote on Wed, Aug 31, 2022 at 11:28:31 +0200: > > > On 2022-08-28 18:29:27 +0000, Daniel Shahaf wrote: > > > > zstyle has been explained multiple times in the past so you might want > > > > to look those up and ask about parts that are unclear to you. > > > > > > > > In short, «zstyle ':foo:bar:*:baz' key v1 v2» translates as "When > > > > library foo asks for the value of key in a situation of the form > > > > bar:*:baz, tell it the answer is «v1 v2»". > > > > > > Perhaps there should be a zsh function that translates a zstyle line > > > to plain English. :-) > > > > What do you have in mind, exactly? It'd be pretty easy to write > > something that, say, runs «zstyle -L» and applies the sh-to-English > > mechanical transformation I did above. That's just a compiler… > > The above is not very helpful for the end user. > > For instance, "zstyle -L" gives in particular: > > zstyle :urlglobber url-local-schema ftp file > zstyle ':url-quote-magic:*' url-metas '*?[]^(|)~#{}=' > > but I can't find any explanation about why it should be ":urlglobber" > and not something else. The man page looks similar for urlglobber and > url-quote-magic, though they look different above. > By convention, context patterns are of the form «:foo:…» where «foo» identifies a particular library / module / plugin for namespacing reasons. So, it says ":urlglobber" and not something else because that's what the author of urlglobber named urlglobber. > In the zshmodules(1) man page: > > For example, a fictional `weather' plugin might state in its > documentation that it looks up the preferred-precipitation style > under the `:weather:continent:day-of-the-week:phase-of-the-moon' > context. According to this, you might set the following in your > zshrc: > > zstyle ':weather:europe:*' preferred-precipitation rain > zstyle ':weather:*:Sunday:*' preferred-precipitation snow > > So I would expect the translator to mention "continent", > "day-of-the-week" and "phase-of-the-moon" in its output. The zstyle completion actually does this; try completing «zstyle :vcs_info:» or «zstyle :completion:». > Moreover, for ':completion:*', it is difficult to find the associated > documentation, because if one searches for "completion" in the zshall > man page, one gets too many matches. In this case the best approach is to look for the style name. In other formats of the manual, each style name has its own index entry. ---- Potentially some of the above should be added to the manual. Daniel (I might not have time this morning to reply to all threads I participated in)