git: 7bd8da72c581 - main - sh(1): Replace recommendation of use of -e with a note

The branch main has been updated by michaelo:

URL: https://cgit.FreeBSD.org/src/commit/?id=7bd8da72c5814b486ae7f492286fe3ac0a5bf03d

commit 7bd8da72c5814b486ae7f492286fe3ac0a5bf03d
Author:     Michael Osipov <michaelo@FreeBSD.org>
AuthorDate: 2024-05-03 07:57:06 +0000
Commit:     Michael Osipov <michaelo@FreeBSD.org>
CommitDate: 2025-03-08 16:13:25 +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
---
 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 768193905c49..5458f5f6f37c 100644
--- a/bin/sh/sh.1
+++ b/bin/sh/sh.1
@@ -31,7 +31,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd February 27, 2025
+.Dd March 8, 2025
 .Dt SH 1
 .Os
 .Sh NAME
@@ -238,11 +238,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