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.3 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,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 203552884F for ; Fri, 26 Jan 2024 18:22:57 +0100 (CET) ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1706289777; b=S/DRH3npCw0FfE0XfiRLOwjTiN3Dp2L89AvjjiXyVKOr8ABu6rYoHI+UPkMUnMUVpz75boH4aQ V+Zat1gvU+X9rsCmU+Yh5TP7c+gWZbVREYYPjqidvTQGnXFtPI0HqciK+3AUAY6gIy8MCirA+s sUHz7LirhP0sjkOKHFwN4SKD20hDyV+RhdnDjT2AP1uVg9l0sqfRYA9RMVBkfawNp3caXIKV82 6JfGOe/Ydr7VOLdLmzIDvHDolOi0JjBcs9iePUgpAmBUcPfdP6awISDG+v2Wc4T2cocvyU+93J 9HAES4DiU4x33fccy2W4ZX+5lUO04nU/hZMBH3x0Drx6lQ==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (email.dondley.com) smtp.remote-ip=34.203.132.18; dkim=pass header.d=dondley.com header.s=default header.a=rsa-sha256; dmarc=pass header.from=dondley.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1706289777; bh=17aZ0tjLKmhNFqEleCcy13q6R3q5wJcownvh++jTl+A=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:References:To:Cc:In-Reply-To:Date:Subject:MIME-Version: Content-Type:Message-ID:From:DKIM-Signature:DKIM-Signature; b=cGmo7vvKzRv6CF16F2OP2InpjNAxuVnAurSl/6dCpc/wJuqQssuGwYGsxaOu08MGqlE6ZgFKQp rA5xq8YwUvqqb6n0H7kX643297gSnQ5f3T9zixenfpBjusZGXPoMFRrVydZ52Ngpr+UgPbb26u vI0zQiZqdpkOeI5iU/RVUKOCUxzyvtglwm3XvgI1GXqIbeFmhgQzhkj9LwA7JI2kCV9aoFCtX8 j4OtqtSchDNtthiqkXPudUcwP0CdIPIjfJ0+oFp/nFkJRGEOG9omLiCyRykqDkabtCuNn6/d1x LL4WpElqIIbnrZXaxSHKb1OxNsFQY1u854GYhqco/S+chw==; 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:References:To:Cc:In-Reply-To:Date: Subject:Mime-Version:Content-Type:Message-Id:From:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=4akU5iKn3C4hZEFpBjfctgyq8gtKXiMVyAD7oQnIT0Q=; b=J+CvfLpSYivHhC9vg2VnfSinf0 b9oJOfEN3n1u9z876XexurjcA5pkv2sBRg7cvIo5ZsxXRZc9Cc5NPHJWps/NgBCH6aSkSQoBvH6W0 i2Kfd96xk1gSbu9NTeBTSJ0s41Xv0/3g3SorhNaCAdGR74C0fnA/lfS33Sos7OTLZpzuBmpc056a0 hRBql4DFR+vqwONhLzOGqQjAX/Fr4B9SmgjqsoFFKEkNi2oP7dv0QIEOsGOH8yCSoeQ1IuQOSI3zm wSYIDUFYtU/ZOzNBwU9NUuB0+QYVmIJwL9bu3w8QAf2YDOFQWExWlYNYtNfAsG/MBjQhfdIKjZ7LX Q2RikV0g==; Received: by zero.zsh.org with local id 1rTPur-00045r-HP; Fri, 26 Jan 2024 17:22:57 +0000 Authentication-Results: zsh.org; iprev=pass (email.dondley.com) smtp.remote-ip=34.203.132.18; dkim=pass header.d=dondley.com header.s=default header.a=rsa-sha256; dmarc=pass header.from=dondley.com; arc=none Received: from email.dondley.com ([34.203.132.18]:57336) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_256_GCM_SHA384:256) id 1rTPtn-0003NA-MH; Fri, 26 Jan 2024 17:21:53 +0000 Received: from smtpclient.apple (unknown [216.193.141.189]) by email.dondley.com (Postfix) with ESMTPSA id D6C232018C; Fri, 26 Jan 2024 12:21:49 -0500 (EST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=dondley.com; s=default; t=1706289709; bh=17aZ0tjLKmhNFqEleCcy13q6R3q5wJcownvh++jTl+A=; h=From:Subject:Date:In-Reply-To:Cc:To:References:From; b=UFxrpMyEUOrnAPKj+fytFJaQBs0qv49353GHYvE/9EDM64kY8taZ6VR/7OQnydncE t6pzwCOtiwcvO2iGP+amNoc5TyZojwLIFeb9TKmI1PtGfVjkfETj3FW6eEVxzsDDZK ZRxr3UK/MbMZ4mK2XmXJd114cM2wGjIozn0gLahmA9SsGmV8AVWm9sKBWWWRqAj15P P8W65fu7t/NOUt1q0VWLW8ntx+3u88Gy0ZwGEwVzyc5BDOj0XlRsCgCbikNb32wRO+ WO0KbH0UuF0D8mdKtZEuplp1UixUG4CKAag4E5gxSVwSr/HfvR7qmpT2uZnpWJqh00 6ljAYQS77Z0GA== From: Steve Dondley Message-Id: Content-Type: multipart/alternative; boundary="Apple-Mail=_1DD56F13-A028-4679-9C79-6614E9D1E930" Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3774.400.31\)) Subject: Re: Can't tell the difference in operation between PATH_SCRIPT and NO_PATH_SCRIPT Date: Fri, 26 Jan 2024 12:21:39 -0500 In-Reply-To: Cc: zsh-users@zsh.org To: "Mark J. Reed" 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> X-Mailer: Apple Mail (2.3774.400.31) X-Seq: 29581 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: --Apple-Mail=_1DD56F13-A028-4679-9C79-6614E9D1E930 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 >=20 > 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. >=20 I=E2=80=99ve got lots of quibbles with how that section is written. It = is not for mere mortals.Take just the first sentence, for example: "The following flags are interpreted by the shell when invoked to = determine where the shell will read commands from:" =E2=80=9Cwhen invoked=E2=80=9D is bad jargon. The use of passive voice = is confusing and =E2=80=9Cto determine where the shell will read = commands from=E2=80=9D is just torturous wording. Instead: A user or script can use the appropriate command, usually /bin/zsh, to = launch a new z shell process. Optional flags passed to the command = control where the shell looks for new commands to interpret: --Apple-Mail=_1DD56F13-A028-4679-9C79-6614E9D1E930 Content-Transfer-Encoding: quoted-printable Content-Type: text/html; charset=utf-8

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=E2=80=99= ve got lots of quibbles with how that section is written. It is not for = mere mortals.Take just the first sentence, for = example:

"The following flags are = interpreted by the shell when invoked to determine where the shell will = read commands from:"

=E2=80=9Cwhen invoked=E2=80= =9D is bad jargon. The use of passive voice is confusing and =E2=80=9Cto = determine where the shell will read commands from=E2=80=9D is just = torturous = wording.

Instead:

A user or = script can use the appropriate command, usually /bin/zsh, to launch a = new z shell process. Optional flags passed to the command control where = the shell looks for new commands to = interpret:




= --Apple-Mail=_1DD56F13-A028-4679-9C79-6614E9D1E930--