From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-3.2 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_EF,HEADER_FROM_DIFFERENT_DOMAINS,HTML_MESSAGE, MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.4 Received: from zero.zsh.org (zero.zsh.org [IPv6:2a02:898:31:0:48:4558:7a:7368]) by inbox.vuxu.org (Postfix) with ESMTP id CA71A2161A for ; Fri, 26 Jan 2024 21:40:59 +0100 (CET) ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1706301659; b=S3QDpiuBicKBXnYvNU+9R5YK7F527ae2ycc/Pzv5upADnlg91l2JWfKqIfp9Y73VBbKBDEwHDj Sq1vKNOVAGchF3IcLBv0CmO+wNdCphVCkr9ECBPN7/9WFFDeiof5nJE4hBGiNe5C72DV0ViXmx mXo4DUptNXG4IiryXeW49aBibh6CqqNfsBvlIfGYFVYlmwdXAO3pnSXnINPKXtnkscVHQ/6iDn rs+sofT7hiTpoG60+xIlGABgRlynK7QGVcF85xls8DVH/bNalAoaqrpmNeRWLHzEGq6Hud9+7C vcbcKnMFLMWqlIP+uleY0P9mVdos3sWt6ICQ72Fl4dKRZA==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mta03.eastlink.ca) smtp.remote-ip=24.224.136.9; dmarc=none header.from=eastlink.ca; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1706301659; bh=f5c/IB/fwlLQRghw8oNBVauiXLUlSsg2HoI4ED0cvaw=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:In-Reply-To:From:References:To:Subject:MIME-Version:Date: Message-ID:Content-Type:DKIM-Signature; b=padsnlXwxJV1ImlROJ5nDGfv0MjmSqHvBRLhzvDFGqYuo559UL14lCfOjW/lT7To73S7gSCo9V 7Ch57htxuXswCnnlsS+7u4JA8uy7M5/6LmteUGF0la6pEcv2/MrzTAAlJqGfQuxGOzIahnRKi2 tvaMCiC9IkNDQ33vv8rx5PT2Y+VpGlpGMA5ZfBrsyTRvsko482CoFlMFQ4yp+JfEIzsdhkfjeW TIxz5IIDCm70kNZIIWsHXEgoXfAAZMhryF5BA12SuuZZwD62cr1JXzQaBifiinxX2ZLU/1xkW2 7yyfBNQUo6WqXnRQxohnaL/yZhjDDnC5kizPVzeEsHkorg==; 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:From:References:To: Subject:MIME-version:Date:Message-id:Content-type:Reply-To:Cc: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=Whfw4QXOuU7wZdEpjp+08c9V6R8Cqbv1IkDrmIbgL7E=; b=PNjwWH9TanltKK/qZ9RRxi9yVJ iQVTdeJFZCWc8KtZZ4GVVPtWbJm+g5XzUrTE/tpfEbdQFvjJOH81QmaKh9upZ0VXhdz13eVOhjUBz OMq75b4wwLdTgRsIW8V2BbrqK5AAHbbKUh2X3cfzTV+vLLjRRcOOUQw0bHJS9Xky29oPJo3pnO15N Z/7o2hXxxyYBiVpvXTFrf1/lxB/KSDmvu26kPUuRztnxSel4KHzdQjDGHWI2qsY2imyP2/Uz0HC0q Ow6ljqmpIkoHT/FZQxZCSf5ewuZLBz5uF535sUO6qfF74bVuqOFJeE6H49lUnq4wqDDvSpAtrt7X+ SQOUpotQ==; Received: by zero.zsh.org with local id 1rTT0U-0001AK-L9; Fri, 26 Jan 2024 20:40:58 +0000 Authentication-Results: zsh.org; iprev=pass (mta03.eastlink.ca) smtp.remote-ip=24.224.136.9; dmarc=none header.from=eastlink.ca; arc=none Received: from mta03.eastlink.ca ([24.224.136.9]:41059) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1rTSzy-0000R5-FQ; Fri, 26 Jan 2024 20:40:26 +0000 Received: from csp01.eastlink.ca ([71.7.199.166]) by mta03.eastlink.ca ([24.224.136.9]) with ESMTPS id <0S7V0BT2LYPZZ9G1@mta03.eastlink.ca> for zsh-users@zsh.org; Fri, 26 Jan 2024 16:40:25 -0400 (AST) Received: from [192.168.0.11] (host-24-207-19-13.public.eastlink.ca [24.207.19.13]) by csp01.eastlink.ca ([71.7.199.166]) with ESMTPSA id TSzwrFg4zNVg6TSzxrM7eY (version=TLSv1_2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256); Fri, 26 Jan 2024 16:40:25 -0400 X-Authority-Analysis: v=2.4 cv=DqL1+3/+ c=1 sm=1 tr=0 ts=65b418b9 a=e7T7DzMKK1R988ZCg0wLyw==:117 a=e7T7DzMKK1R988ZCg0wLyw==:17 a=r77TgQKjGQsHNAKrUKIA:9 a=SVV_vUV9vUzI3df2eeIA:9 a=QEXdDO2ut3YA:10 a=pGLkceISAAAA:8 a=ZfRma8p8Njwka8Tk8mwA:9 a=2GtQcT5VYfm-xE65:21 a=_W_S_7VecoQA:10 X-Vade-Cause: gggruggvucftvghtrhhoucdtuddrgedvkedrvdeljedgudefkecutefuodetggdotefrodftvfcurfhrohhfihhlvgemucfgtefuvffnkffpmfdpqfgfvfenuceurghilhhouhhtmecufedttdenucenucfjughrpegtkfffgggfuffvfhfhjgesrgdtreertddvjeenucfhrhhomheptfgrhicutehnughrvgifshcuoehrrgihrghnughrvgifshesvggrshhtlhhinhhkrdgtrgeqnecuggftrfgrthhtvghrnhephfettefhveeguedvleeggfdvvedufeeuudffvdfgledvvdfgtdeigeeuueelieefnecukfhppedvgedrvddtjedrudelrddufeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepihhnvghtpedvgedrvddtjedrudelrddufedphhgvlhhopegludelvddrudeikedrtddruddungdpmhgrihhlfhhrohhmpehrrgihrghnughrvgifshesvggrshhtlhhinhhkrdgtrgdpnhgspghrtghpthhtohepvddprhgtphhtthhopeerredprhgtphhtthhopeiishhhqdhushgvrhhsseiishhhrdhorhhgpdhgvghtqdgkihhprfgrshhsfigupehtrhhuvg X-Vade-Score: 0 X-Vade-State: 0 X-EL-AUTH: rayandrews@eastlink.ca Content-type: multipart/alternative; boundary="------------R3Fgc3Oa4uqUwXmsyBVq40AX" Message-id: <81b44e1d-49f4-48ab-99ed-4aaf2f20e8d7@eastlink.ca> Date: Fri, 26 Jan 2024 12:40:24 -0800 MIME-version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: Can't tell the difference in operation between PATH_SCRIPT and NO_PATH_SCRIPT Content-language: en-US To: zsh-users@zsh.org References: <73E4333B-C282-4A58-837C-A50F73E13289@dondley.com> <680FA5D3-E8FD-49F2-9AE3-C169A6D9DA9E@dondley.com> <4a1df20e-70c4-41ed-b370-4fbbae0619b9@app.fastmail.com> <3DC872AC-5B19-468D-85D5-5D3A501EF7E9@dondley.com> <2CF29A22-6721-4275-8E92-7FF61CE4CDCB@dondley.com> <316F625D-EC13-43C5-808F-B78DD09E906C@dondley.com> <395469e2-bcfe-467b-b749-85a284876b64@eastlink.ca> From: Ray Andrews In-reply-to: X-Seq: 29594 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: This is a multi-part message in MIME format. --------------R3Fgc3Oa4uqUwXmsyBVq40AX Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit On 2024-01-26 12:08, Roman Perepelitsa wrote: > Exactly, zsh documentation is a nuclear power station blueprints. > Transforming it into a basic physics tutorial I quite agree.  A manual is not a tutorial.  Still, that's no reason for the manual to be impenetrable -- as if that was somehow a virtue.  A while back Peter rewrote something and it went from being baffling to being helpful.  Why *not* make things as clear as possible? > I agree that your version would be better for someone unfamiliar withthis concept.But can you see that it might be less efficient for > someone who already understands it? And consider where to draw the > line with foundational explanations. Should we also explain what $HOME > is, what a directory means, or what 'consult' implies? It's always a matter of judgement where one draws the line.  It goes without saying that things should not be dumbed down to the point of dilution.  Within, say, a thousand words, why not make those thousand words as clear as they can be?  Steve's sample -- what is *lost*?  What utility is compromised?  If much is gained and nothing is lost, I say it's a plain improvement.  Put it this way: if my needs and your needs are in conflict as to the manual, yours must prevail.  But what if my needs could be met without compromising yours? --------------R3Fgc3Oa4uqUwXmsyBVq40AX Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 8bit


On 2024-01-26 12:08, Roman Perepelitsa wrote:
Exactly, zsh documentation is a nuclear power station blueprints. 
Transforming it into a basic physics tutorial

I quite agree.  A manual is not a tutorial.  Still, that's no reason for the manual to be impenetrable -- as if that was somehow a virtue.  A while back Peter rewrote something and it went from being baffling to being helpful.  Why *not* make things as clear as possible?  


I agree that your version would be better for someone unfamiliar withthis concept. But can you see that it might be less efficient for
someone who already understands it? And consider where to draw the
line with foundational explanations. Should we also explain what $HOME
is, what a directory means, or what 'consult' implies?

It's always a matter of judgement where one draws the line.  It goes without saying that things should not be dumbed down to the point of dilution.  Within, say, a thousand words, why not make those thousand words as clear as they can be?  Steve's sample -- what is *lost*?  What utility is compromised?  If much is gained and nothing is lost, I say it's a plain improvement.  Put it this way: if my needs and your needs are in conflict as to the manual, yours must prevail.  But what if my needs could be met without compromising yours?



--------------R3Fgc3Oa4uqUwXmsyBVq40AX--