patch: zshmisc(1) clarify non-successful exit statuses

[<zeurkous@xxxxxxxx>]

#?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