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 12410 invoked from network); 4 Sep 2022 07:23:39 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 4 Sep 2022 07:23:39 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1662276219; b=oAaIKE3xngXu/WbxOgVHVook5GR55gHBYYNXblm9WxIs4cdOllZPbX0n1v0nx6jOyUOme9bset TEaV6C6tek6RUNMgczvB9AP/N/a8OC8rF60wIfuiaQLIenkSGwnGc9Y/Mg/f3l/41OjDqot00V mNm00CT6DsjmO+Rc33kp3f+/nK6Bjb5s5Jz6KnAk0JtF0ABWBUVCsdpvzj9YgWg4twkmFOg6Dg mCDlzDDy9IV2oiOmtKpEQL9KfxLL8cQK+zM76tQtcNsitKWI+MdR2fsVHyyRYM84NvUeumxn1Q PPT/mGnVoOW9U/G6GEvHyiZS/xJB9arlado7wLGQWouaaQ==; 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=1662276219; bh=ntDen/G+aC4Gx3mORV/k0/UUiO0Lkxo5y4CltwFbBzY=; 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:Cc:To:From:Date:DKIM-Signature: DKIM-Signature:DKIM-Signature; b=otNvO1zsYTrc+PSpm+tM4HTTFAIhKtu+qEJnLqb0mQS5u1mzeLIg2MBzPh427kbVdUu8mMkkCg q+dWqemv8pSFLM9aQC+ORtbYtJZff2rss4029o/yzzR4VWoqdTioFo5YzfH1jOwSiwOKTWMSjC fvrlTCU0PxOk91INbQv/GpkAW9IQcmjWDNOy153NQ5RL6HFE0AacqMreNRRU/PsMlenAMoccbG aMCCvRUZD6sBvUMv7DqkpPomSqZhQfgS+4cGX54V4sLvKVigrOKlsYG3hn187tTbzebniCJ4TW SuDUsWLpyl6JO5gBv+qBEpR6OGm7oq6YQonv3ZqXhuFhEA==; 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:Cc:To:From:Date: Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender :Resent-To:Resent-Cc:Resent-Message-ID; bh=OhOl6Oj9/hcNKOXTGLmczCrd3gBgT9eUshi//J/hqbs=; b=VP8h6g7ef/CO8gIb7nj9e70zCo wUOHpA8WY+4sWB3/88ZRkw4l6q6w7ZQayFdNya6YV4EnEoZDPDtMXyRnSOMRa2dFzLFJPe5B0r/mF cA3uhbpEEBMOkih4Vu0/qd5WYTnUJKWHbZqzde9G+GUdlz5ABwt3vx53Cx99KswXtE6btuwkBqA5s Ns0+banlwRo8FW4eC7vVp1n3qnlrjFykTQ7Pt8N4EeJBZ3TXDss8ahwKcLzBVOnOP1XR7Gp8+Uk+O JIu0sAz6DORgpbn6snfMgjQe7ZSfIx62/mtAqT+7UYBbrvKSIwyPSRDmPG7zpncnvLnMhHKc1pVIC hEUWhjhA==; Received: from authenticated user by zero.zsh.org with local id 1oUjyl-000GPw-Cl; Sun, 04 Sep 2022 07:23:39 +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]:59321) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_256_GCM_SHA384:256) id 1oUjoW-000FSj-8h; Sun, 04 Sep 2022 07:13:04 +0000 Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id 8B0C85C0073; Sun, 4 Sep 2022 03:13:03 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute1.internal (MEProxy); Sun, 04 Sep 2022 03:13:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= daniel.shahaf.name; h=cc: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=1662275583; x=1662361983; bh=OhOl6Oj9/h cNKOXTGLmczCrd3gBgT9eUshi//J/hqbs=; b=E1zNUuShbNeLfHky+RKFwNSeNy wbS4IMg+phMBf7GFIgGIp11btgMWy+fLw+QZwmzYe4b0f32ApIqs3L92YD7s5Lqw yZFwA5bnL7QW7AxeyuBIR7a9cqP4YgI2H35/amBKPmELFiV09m/1b5n99i+sr/OW 4PAgdXI7uLfNSMJcJk66OEQd7j0fJeIvBVN6x5ikintzKZdBNDpHuk+8l2yU/JSM rZK6RyJbTMqTcV/j7+1sJ6HAal4tuqBScNohJXixlTNV5+bh7+wCOOMt8mvyEU9l 8fV4IhuH+a5RNkFjjIWKvZ6JkaHR8V22bbJHXypQDsyw2rLjTPV3llqrRR8g== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc: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=1662275583; x= 1662361983; bh=OhOl6Oj9/hcNKOXTGLmczCrd3gBgT9eUshi//J/hqbs=; b=s gTh5DEMY7Fx7EG4U0ytf9AzyvuTwdGo911EVYfjC2ObXlS0j0Iox/357yFEu4Ija p61WH8yb82qN2T3WpksN3qKNbUB3blJahVwALB5qrBAsqz7ERliQRzZ4CUjAVCTf Jnh6kfL3vghhFhGX7yTGom/gT8exs011S6H0HTFEa4HGSm73/d8Dgg8rMIjKFDRK lJQpZI3ff9djqhu97tyvr+bMYtzdxhduvSy+xOF+vv9YdaqDvr6YerZZJgFr59Ka CV/kTrHYQvS3ofOl8RcZ2zBpoA+he35R0HiD5BowT/0wcbQhkO0lYrK4gtgIXWPO LQwb5lGb3SlttegiKKMtA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrvdelfedgudduiecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpeffhffvvefukfhfgggtugfgjggfsehtkedttddtreejnecuhfhrohhmpeff rghnihgvlhcuufhhrghhrghfuceougdrshesuggrnhhivghlrdhshhgrhhgrfhdrnhgrmh gvqeenucggtffrrghtthgvrhhnpeehtdefudelteejueefjeelgedvtedvtdehhfffjefg gfeuheetheduueekuefhheenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmh grihhlfhhrohhmpegurdhssegurghnihgvlhdrshhhrghhrghfrdhnrghmvg X-ME-Proxy: Feedback-ID: i425e4195:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sun, 4 Sep 2022 03:13:03 -0400 (EDT) Received: by tarpaulin.shahaf.local2 (Postfix, from userid 1000) id 4ML2t45Ktjz1Y6; Sun, 4 Sep 2022 07:13:00 +0000 (UTC) Date: Sun, 4 Sep 2022 07:13:00 +0000 From: Daniel Shahaf To: Ray Andrews Cc: zsh-users@zsh.org Subject: Re: Most minimal configuration challenge Message-ID: <20220904071300.GQ5920@tarpaulin.shahaf.local2> References: <1c9b6072-26e7-467e-b8cc-7d44f15eaf1b@www.fastmail.com> <9116efd4-7c88-4ea3-9601-9c522236fee7@www.fastmail.com> <20220831092831.GA992100@zira.vinc17.org> <2a3b5ac0-f4f8-4c14-835a-c3d31db6d4fb@www.fastmail.com> <20220902103648.GM5920@tarpaulin.shahaf.local2> <789b8b92-ef70-940f-b24a-4edb27a59bd7@eastlink.ca> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <789b8b92-ef70-940f-b24a-4edb27a59bd7@eastlink.ca> User-Agent: Mutt/1.10.1 (2018-07-13) X-Seq: 28041 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: Ray Andrews wrote on Fri, Sep 02, 2022 at 07:26:54 -0700: > On 2022-09-02 03:36, Daniel Shahaf wrote: > > Ironically this sentence would be the perfect start to some doc about > zstyle that was actually helpful: > > > There's no easy way to explain zstyle in a sentence since it has so many > > moving parts (keys, values, contexts, context patterns). > > ... start off by letting the reader know that zstyle is [complex] Personally, I find that sentence doesn't actually convey any (objective) information about what zstyle is or does, so it'd be among the first things I'd cut. You are of course welcome to grab a pen or a keyboard and write "Ray's Introduction to zstyle" (or whatever you might call it) and start it like that. If you use a nice markdown editor and put it on github… > > > > 3. Readers (including lurkers) would get a fishing rod rather than a fish. > > > But sometimes what you want is a fish.  That's the perfect analogy tho.  > Sometimes I > want a fishing rod, sometimes I want a fish.  When it comes to > documentation, they > are very different things. Perhaps what you have in mind here is the difference between a tutorial or user manual on the one hand, and a reference manual on the other hand. zsh's manual is of the second kind.