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.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 10707 invoked from network); 18 Jul 2021 22:27:53 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 18 Jul 2021 22:27:53 -0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20200801; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:Content-Type:Subject:Cc:To:From:Date: References:In-Reply-To:Message-Id:Mime-Version:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=uaWD7pjQi9hH6Cedtgpi6w3cj8uSNUGKPXpb/2MKv3U=; b=CLdGCbH2jqicc1rSs5c0fHHZUm zeQE/HYKM2t7h4sy/xm8yvqF+XFNyetjxkiDRY27hl/8Oq3GZOl/XH7t8TdOPsvCAdPVzMN28h1Jp Qw0In7Nm0JX1wvVsqfPvTCUGzeqN/HDTW5SM7LXPYJF6dPz5Db5zhc3gSKblrHyf9c7xKcq0hQVcm ZCU9xKNQXxXdocQzO7vawgH3b3ai74PtOuXUgONJfHg1qgEhUc6ctM8xl0AUv7fEyvLlKa4AZYTjW k9LkR39UCPTH9+UYQr+AS/om28+XyMWRC3TdLLxbSYvOvaZS6t8hufxI0ybo1n8flfNa54Q84vAtP veYBnTbg==; Received: from authenticated user by zero.zsh.org with local id 1m5FGK-000Bbs-BS; Sun, 18 Jul 2021 22:27:52 +0000 Received: from authenticated user by zero.zsh.org with esmtpsa (TLS1.3:TLS_AES_256_GCM_SHA384:256) id 1m5FG6-000BJV-GI; Sun, 18 Jul 2021 22:27:39 +0000 Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailauth.nyi.internal (Postfix) with ESMTP id 292EB27C0054; Sun, 18 Jul 2021 18:27:36 -0400 (EDT) Received: from imap2 ([10.202.2.52]) by compute3.internal (MEProxy); Sun, 18 Jul 2021 18:27:36 -0400 X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddrvdelgddtjecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepofgfggfkjghffffhvffutgesthdtre dtreerjeenucfhrhhomhepnfgrfihrvghntggvpgggvghljoiiqhhuvgiiuceolhgrrhhr hihvseiishhhrdhorhhgqeenucggtffrrghtthgvrhhnpeejffduteelveetleekvdeuff euffegheehhfdvtddvfeegtedvfffhveevgedvtdenucffohhmrghinhepshgtrhhiphht rdhtthenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpe hlrghrrhihvhdomhgvshhmthhprghuthhhphgvrhhsohhnrghlihhthidqudduhedukeej jedtgedqudduledvjeefkeehqdhlrghrrhihvheppeiishhhrdhorhhgsehfrghsthhmrg hilhdrtghomh X-ME-Proxy: Received: by mailuser.nyi.internal (Postfix, from userid 501) id 8322BA03981; Sun, 18 Jul 2021 18:27:35 -0400 (EDT) X-Mailer: MessagingEngine.com Webmail Interface User-Agent: Cyrus-JMAP/3.5.0-alpha0-533-gf73e617b8a-fm-20210712.002-gf73e617b Mime-Version: 1.0 Message-Id: <9255181c-83e2-4edd-8d36-4a2fcd5433b0@www.fastmail.com> In-Reply-To: <20210708225357.58B28287@volny.cz> References: <20210708225357.58B28287@volny.cz> Date: Sun, 18 Jul 2021 18:27:15 -0400 From: =?UTF-8?Q?Lawrence_Vel=C3=A1zquez?= To: zsh-workers@zsh.org Cc: zeurkous@volny.cz Subject: =?UTF-8?Q?Re:_twice_revised_patch:_zshmisc(1)_clarify_non-successful_exi?= =?UTF-8?Q?t_statuses?= Content-Type: text/plain X-Seq: 49171 Archived-At: X-Loop: zsh-workers@zsh.org Errors-To: zsh-workers-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-workers-request@zsh.org X-no-archive: yes List-Id: List-Help: List-Subscribe: List-Unsubscribe: List-Post: List-Owner: List-Archive: On Thu, Jul 8, 2021, at 4:53 PM, zeurkous@volny.cz wrote: > # One person branded me earlier wording of a sentence ``ungrammatical''; > # while me doesn't necessarily agree, me sees no harm in the proposed > # change and this has hence been incorporated. Thanks, I appreciate it. > --- Doc/Zsh/..v/5.8/exec.yo Mon Dec 4 14:09:35 2017 > +++ Doc/Zsh/exec.yo Thu Jul 8 20:13:50 2021 > @@ -14,10 +14,21 @@ > > vindex(path, use of) > Otherwise, the shell searches each element of tt($path) for a > -directory containing an executable file by that name. If the > -search is unsuccessful, the shell prints an error message and returns > -a nonzero exit status. > +directory containing an executable file by that name. > > +If execution fails: an error message is printed, and one of the > +following values is returned. > + > +startsitem() > +sitem(127)(The search was unsuccessful. The error message is > +`tt(command not found:) var(cmd)'.) > +sitem(126)(The executable file has insufficient permissions, is a > +directory or special file, or is not a script and is in a format > +unrecognized by the operating system. The exact conditions and error > +message are operating system-dependent; see > +manref(execve)(2).) > +endsitem() > + > If execution fails because the file is not in executable format, > and the file is not a directory, it is assumed to be a shell > script. tt(/bin/sh) is spawned to execute it. If the program > @@ -29,10 +40,6 @@ > If no external command is found but a function tt(command_not_found_handler) > exists the shell executes this function with all > command line arguments. The return status of the function becomes the > -status of the command. If the function wishes to mimic the > -behaviour of the shell when the command is not found, it should > -print the message `tt(command not found:) var(cmd)' to standard error > -and return status 127. Note that the handler is executed in a > +status of the command. Note that the handler is executed in a > subshell forked to execute an external command, hence changes to > directories, shell parameters, etc. have no effect on the main shell. > - Anyone have further feedback and/or is up for committing this? -- vq