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 4397 invoked from network); 11 Apr 2021 12:15:47 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 11 Apr 2021 12:15:47 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1618143347; b=Cm51UMN1hD/jayjNO2o5NGDSRVhQZasFISa9uVcgm5dgElp2QjjXN5OLKpXu59GQHArx9+KSg4 gjLW8TJCIRhlfZaGLlQwpKdBpE6bTII4MmNQWbItinOqsw8UyQEk3wQpB+zDmT3ooe/8jV7nPH ahU2+Ie+Vu6sDZbpHh9vewvBOKvtHYztyueZFDAEUKZPoGfnkooMUka4mjr5O89ssELN1Kr0YY k9zWD4Eihk09vcKZG/HRcA4zHlZBOjHvnQciqyHsg1RKmBDXND+4PYskkpEeviPFOW/JcSmy+Y 4W0DptZDl88IfPgu7Ve4BpcZQJtIzhfe0X6JdyOgodHdjA==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (gmmr1.centrum.cz) smtp.remote-ip=46.255.225.252; dkim=pass header.d=volny.cz header.s=mail header.a=rsa-sha256; dmarc=pass header.from=volny.cz; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20200801; t=1618143347; bh=aXfPqxWfDXGxjwzFofRnbeVUOGqEJiJag29fPVUstOk=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:Content-Type:Message-ID: MIME-Version:From:Date:Subject:To:DKIM-Signature:DKIM-Signature; b=AkswsMHvROenPs1CgmTRlRcSnV+M2E1UuyoBFyIcMkmnsQvRq5DY6pXEbOtjR0qmptrGOr2Q2D GZ9p4jEGkpyFzoMOfOrzeSiU3uCeRx/5IXmHZaBUI1Yjz871qGLrTXLAJcgr5gTIzfYWw4qqjg OS19aZLjMwMm8zy2F0K6f/BYg6AztizkA6KQ/6JWZMuDiG3gzwzXtgqbQpCWTP5B7Q8DRkQi2+ FJMf6Gvh4k9/1vx8q60w9kwC9JwA/BseJH69EIHoy9Ejcb1xPjic8ZFKb+iqmtWYm0FXCUIsUd zFS4i6Ntzuh1OpMdHw2zE3F0ax/xRzn8LMJ5hKt9IyxkGw==; 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-Transfer-Encoding: Content-Type:Message-Id:MIME-Version:From:Date:Subject:To:Reply-To:Cc: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References; bh=7qFg/L6sPjwAo6ZXpxT/h6PYnW4Z26wPwTADNVv6V7M=; b=ytmfkfMO/aK67qHyPbhJeYNTBe 1obLYiAZFy8HnEHfi5En7yyfT30Aro63mi3neXy9YakRFxfJAk8HDM/iTDr/MLK1VOZeIRtZcQxGa Rwy12Ngk5uV9+/WBd8xp/MkKgmVE2ms8/5anKny/60ut0x6/o8mnzbQ2DTQwiy0ilO0ndXs36iGUn PTYzVRlYLJNaIjzmKSLWcU7Up33r0HsbkbS6PApYoFFf14L4b4g73X+NyUSU9dlCyyfGj8jE2jinY +UvFSUNmiuyI3amLeyNI3h6aGXIodfedS+Jz+ef0vzxVO1yXvQXo34mNxMoLoz4C5D17mIqc/ednz 0y5XBuwA==; Received: from authenticated user by zero.zsh.org with local id 1lVZ0A-000Gqc-VN; Sun, 11 Apr 2021 12:15:43 +0000 Authentication-Results: zsh.org; iprev=pass (gmmr1.centrum.cz) smtp.remote-ip=46.255.225.252; dkim=pass header.d=volny.cz header.s=mail header.a=rsa-sha256; dmarc=pass header.from=volny.cz; arc=none Received: from gmmr1.centrum.cz ([46.255.225.252]:34499) by zero.zsh.org with esmtps (TLS1:DHE-RSA-AES256-SHA:256) id 1lVYzp-000Gb5-GI; Sun, 11 Apr 2021 12:15:23 +0000 Received: from gmmr-1.centrum.cz (unknown [10.255.254.14]) by gmmr1.centrum.cz (Postfix) with ESMTP id EFD308008D7E for ; Sun, 11 Apr 2021 14:15:20 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=volny.cz; s=mail; t=1618143321; bh=7qFg/L6sPjwAo6ZXpxT/h6PYnW4Z26wPwTADNVv6V7M=; h=To:Subject:Date:From:From; b=WM59LwGg8UGL8QoAtmbUcvF29k1GErf0RSeusf8ZG9ssWUHCYEAxuJBAjxueY/5RW B+iLf1uVHM2/jxwT65FThIPwRq3Ck2Stkzscr8LDzdqchMsTwBWWqrrwGhmXSbZBt8 2iNCBDhsoDJgCgLxQpDTw6NuIo7EoJnqOLsu6fv8= Received: from vm2.excello.cz (vm2.excello.cz [IPv6:2001:67c:15a0:4000::b]) by gmmr-1.centrum.cz (Postfix) with QMQP id EDC3C30008807 for ; Sun, 11 Apr 2021 14:15:20 +0200 (CEST) Received: from vm2.excello.cz by vm2.excello.cz (VF-Scanner: Clear:RC:0(2a00:da80:1:502::7):SC:0(-3.999998/5.0):CC:0:; processed in 0.2 s); 11 Apr 2021 12:15:20 +0000 X-VF-Scanner-ID: 20210411121520.763668.2177.vm2.excello.cz.0 Received: from gmmr-2.centrum.cz (2a00:da80:1:502::7) by out1.virusfree.cz with ESMTPS (TLSv1.3, TLS_AES_256_GCM_SHA384); 11 Apr 2021 14:15:20 +0200 Received: from mail1002.cent (unknown [10.255.254.38]) by gmmr-2.centrum.cz (Postfix) with ESMTP id B44CD20055F6D for ; Sun, 11 Apr 2021 14:15:20 +0200 (CEST) Received: by mail1002.cent (Postfix, from userid 33) id ACCC42004B342; Sun, 11 Apr 2021 14:15:20 +0200 (CEST) To: Subject: =?utf-8?q?patch=3A_zshmisc=281=29_clarify_non=2Dsuccessful_exit_statuses?= Received: from 46.135.84.18 by mail1002.centrum.cz (centrum.cz multimail) with HTTP Date: Sun, 11 Apr 2021 14:15:20 +0200 From: X-Mailer: Centrum Email 5.3 X-Priority: 3 X-Original-From: MIME-Version: 1.0 Message-Id: <20210411141520.4ABA89D5@volny.cz> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Seq: 48496 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: #?patch # # These patches add, to the zshmisc(1) manual page, clarity about the # exit status on exec failure. # # Me understands that, strictly considered, only Doc/Zsh/exec.yo needs # updating; however, as me doesn't have yodl, me updated Doc/zshmisc.1 # as well. # # Hope this is useful (it is to me), # # --zeurkous, Sun Apr 11 11:12:21 UTC 2021. # --- Doc/Zsh/..v/5.8/exec.yo Mon Dec 4 14:09:35 2017 +++ Doc/Zsh/exec.yo Sun Apr 11 10:42:15 2021 @@ -16,7 +16,10 @@ 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. +127. + +If execution fails because of insufficient permissions, or because the +file is a directory, the shell prints an error message and returns 126. 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 --- Doc/..v/5.8/zshmisc.1 Fri Feb 14 22:13:03 2020 +++ Doc/zshmisc.1 Sun Apr 11 10:55:17 2021 @@ -1,4 +1,4 @@ -.TH "ZSHMISC" "1" "February 14, 2020" "zsh 5\&.8" +.TH "ZSHMISC" "1" "April 11, 2021" "zsh 5\&.8" .SH "NAME" zshmisc \- everything and then some .\" Yodl file: Zsh/grammar.yo @@ -1171,7 +1171,10 @@ Otherwise, the shell searches each element of \fB$path\fP 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\&. +127\&. +.PP +If execution fails because of insufficient permissions, or because the +file is a directory, the shell prints an error message and returns 126\&. .PP 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