git: 61df1b78f906 - stable/13 - sh(1): Replace recommendation of use of -e with a note
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Sat, 15 Mar 2025 14:01:55 UTC
The branch stable/13 has been updated by michaelo:
URL: https://cgit.FreeBSD.org/src/commit/?id=61df1b78f90681c015fade9b81b40ae1f379e1df
commit 61df1b78f90681c015fade9b81b40ae1f379e1df
Author: Michael Osipov <michaelo@FreeBSD.org>
AuthorDate: 2024-05-03 07:57:06 +0000
Commit: Michael Osipov <michaelo@FreeBSD.org>
CommitDate: 2025-03-15 14:01:42 +0000
sh(1): Replace recommendation of use of -e with a note
This partially reverts b14cfdf665bb8b7b2898a4ee5b073ab87f8ea3d0 and has
been discussed in D42719.
Reviewed by: jrm (mentor), otis (mentor), mandree, ziaee (manpages)
MFC after: 1 week
Differential Revision: https://reviews.freebsd.org/D45073
(cherry picked from commit 7bd8da72c5814b486ae7f492286fe3ac0a5bf03d)
---
bin/sh/sh.1 | 10 ++++------
1 file changed, 4 insertions(+), 6 deletions(-)
diff --git a/bin/sh/sh.1 b/bin/sh/sh.1
index 93504c00aab7..4cdc5b8d6239 100644
--- a/bin/sh/sh.1
+++ b/bin/sh/sh.1
@@ -33,7 +33,7 @@
.\"
.\" from: @(#)sh.1 8.6 (Berkeley) 5/4/95
.\"
-.Dd November 20, 2024
+.Dd March 8, 2025
.Dt SH 1
.Os
.Sh NAME
@@ -240,11 +240,9 @@ If a shell function is executed and its exit status is explicitly
tested, all commands of the function are considered to be tested as
well.
.Pp
-It is recommended to check for failures explicitly
-instead of relying on
-.Fl e
-because it tends to behave in unexpected ways,
-particularly in larger scripts.
+Note that many commands return non-zero values to convey information other
+than errors, which can cause unexpected program termination with
+.Fl e .
.It Fl f Li noglob
Disable pathname expansion.
.It Fl h Li trackall