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 B79DD22BF6 for ; Fri, 26 Jan 2024 19:29:31 +0100 (CET) ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1706293771; b=lBEjeOajF9qOB51rkBxixFH1r4dgewEWjhZfKZ8gQ3Fsf8LX24P1OAqUFPW9DKIR2kREv85FRX aATgiTps8EHRWgIc+zpNqcboS2mBJAmZFcjs83lXMLuwZw09jlXXXSfOI421WeTcTXx9fR3MEa T6JOKd580ZVAojMOrpUq7OHkIdlHl3/HCcoEywRV5c9cLvh1G2Uwxm1dPFmWYH4qEPj1rxf3GN B1Uq0aPn1HW//phX+5Y1WHCiCNN67+5e44Hr3F0omuMggrv9/pqjrV4aY9oi8ho42zd/Dawue2 DUX1pU8r2uUxSgZrVW17N1wNZp9mkH/LCI5UDccLMYE4/g==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mta01.eastlink.ca) smtp.remote-ip=24.224.136.30; 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=1706293771; bh=O7fiR0IGecy+/pxkTteh1kP2Q77IeGji3sZoCAiWTHs=; 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=JWNLgwYNYgLRXuWiHiomVQQJypLdYD5pb1489XYhKwNhIagtK5+xf06TNUVa0ERYs0Fh+3fWCi lrRDVvZdT2vAkwrrUbjJVosZ92hO4rV++WcNMZ+NJ+EOiABp1OYx15+GodQ+UCpdgdTR9ifOFn YpbqUaOnzlECZqPHnghActAPbsTyE8GFCR7Cs5n9kkEl/QlFR66mLnwx5X68Yj7RuNl7puWfAh bJCwQdoaeTtJgdievqyFUMgF7eOa26iRnD1SAOpCQBZH7XWHQHpzpG2xHyjfd2JCl6DhrW5XCR xx2Tqrd8cSnbTzX+J/Gz5itAOsEwCw+DD9mS3YVEJm/wQA==; 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=me5xGwWinIaRfaozKyehL3ow8C4SCyfqaBG2cfE8gNM=; b=Qaw70+RBUZF+/Ynjrw0ZvJnk72 LdmNsGyom2Df36p4BEGdfjmRrFJ6M6NQx5txKUEOhXTXp9HNc8HdMIUD6K+JGEltErCkWp5fWLRFL ckloktVQclFHC+J6MEc69MImedKOjYFfqJLbtKVvxRbFsAwTgU6DEdahu2TQ1WHu1TFM/OMmbec/l WVWcFW6eXORWtpSXZbZhGg7WsuzGWsUqSvcIQiUREoMz/GG9xFEniZpHf4agMQfpfY8FIUV86vxld dD9e2rJFjm0tCQ+3TCz7gTolziHSjF3g6nxFbWud8W6YWMN8Tw6PRIoFGCP7Z0TWF+iYmNfcwillh OnmBlNYg==; Received: by zero.zsh.org with local id 1rTQxE-0007nv-6s; Fri, 26 Jan 2024 18:29:28 +0000 Authentication-Results: zsh.org; iprev=pass (mta01.eastlink.ca) smtp.remote-ip=24.224.136.30; dmarc=none header.from=eastlink.ca; arc=none Received: from mta01.eastlink.ca ([24.224.136.30]:46631) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1rTQwW-000759-1G; Fri, 26 Jan 2024 18:28:44 +0000 Received: from csp01.eastlink.ca ([71.7.199.166]) by mta01.eastlink.ca ([24.224.136.30]) with ESMTPS id <0S7V0FS1TSJ7U7W0@mta01.eastlink.ca> for zsh-users@zsh.org; Fri, 26 Jan 2024 14:28:42 -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 TQwTrFNjpNVg6TQwUrM2UC (version=TLSv1_2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256); Fri, 26 Jan 2024 14:28:42 -0400 X-Authority-Analysis: v=2.4 cv=DqL1+3/+ c=1 sm=1 tr=0 ts=65b3f9da a=e7T7DzMKK1R988ZCg0wLyw==:117 a=e7T7DzMKK1R988ZCg0wLyw==:17 a=r77TgQKjGQsHNAKrUKIA:9 a=CDkRhKVRMWo5e2dDHvkA:9 a=QEXdDO2ut3YA:10 a=XGQ5bAkIAAAA:8 a=UjlXjBPqWbp8AazSmTQA:9 a=TOWCEGWAPvhTx2da:21 a=_W_S_7VecoQA:10 a=4eFx6D7NvP7b3IdYF4p0:22 X-Vade-Cause: gggruggvucftvghtrhhoucdtuddrgedvkedrvdeljedgudduudcutefuodetggdotefrodftvfcurfhrohhfihhlvgemucfgtefuvffnkffpmfdpqfgfvfenuceurghilhhouhhtmecufedttdenucenucfjughrpegtkfffgggfuffvfhfhjgesrgdtreertddvjeenucfhrhhomheptfgrhicutehnughrvgifshcuoehrrgihrghnughrvgifshesvggrshhtlhhinhhkrdgtrgeqnecuggftrfgrthhtvghrnhephfettefhveeguedvleeggfdvvedufeeuudffvdfgledvvdfgtdeigeeuueelieefnecukfhppedvgedrvddtjedrudelrddufeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepihhnvghtpedvgedrvddtjedrudelrddufedphhgvlhhopegludelvddrudeikedrtddruddungdpmhgrihhlfhhrohhmpehrrgihrghnughrvgifshesvggrshhtlhhinhhkrdgtrgdpnhgspghrtghpthhtohepvddprhgtphhtthhopeerredprhgtphhtthhopeiishhhqdhushgvrhhsseiishhhrdhorhhgpdhgvghtqdgkihhprfgrshhsfigupehtrhhuvg X-Vade-Score: 0 X-Vade-State: 0 X-EL-AUTH: rayandrews@eastlink.ca Content-type: multipart/alternative; boundary="------------78V3gB05uidqcZCnhZgnHg0d" Message-id: Date: Fri, 26 Jan 2024 10:28:41 -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> From: Ray Andrews In-reply-to: X-Seq: 29582 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. --------------78V3gB05uidqcZCnhZgnHg0d Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit On 2024-01-26 09:21, Steve Dondley wrote: >> >> This is why the documentation for the PATH_SCRIPT option in >> zshoptions(1) points you to the INVOCATION section of the main zsh >> manual: the option is really only useful when specified on the >> command line. >> > > I’ve got lots of quibbles with how that section is written. It is not > for mere mortals.  Nice to have another mere moral around.  We will understand each other's frustrations with the docs.  Technical writing is usually bad, and it seems that in the 'nix word that is particularly true. zsh isn't the worst tho, some 'man' pages are designed to baffle. In some ways the zsh manual is a masterpiece of a certain kind of doc -- a compendium of everything that's true -- but helpful it ain't.  I like to say that the guy who wrote it (Paul F. I presume) was so knowledgeable and so intelligent that writing for mere mortals would have been difficult for him. --------------78V3gB05uidqcZCnhZgnHg0d Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 8bit


On 2024-01-26 09:21, Steve Dondley wrote:

This is why the documentation for the PATH_SCRIPT option in zshoptions(1) points you to the INVOCATION section of the main zsh manual: the option is really only useful when specified on the command line.


I’ve got lots of quibbles with how that section is written. It is not for mere mortals.
 Nice to have another mere moral around.  We will understand each other's frustrations with the docs.  Technical writing is usually bad, and it seems that in the 'nix word that is particularly true.  zsh isn't the worst tho, some 'man' pages are designed to baffle.   In some ways the zsh manual is a masterpiece of a certain kind of doc -- a compendium of everything that's true -- but helpful it ain't.  I like to say that the guy who wrote it (Paul F. I presume) was so knowledgeable and so intelligent that writing for mere mortals would have been difficult for him.
--------------78V3gB05uidqcZCnhZgnHg0d--