sh(1): Discourage use of -e.

Also, do not say that ! before a pipeline is an operator, because it is
syntactically a keyword.
This commit is contained in:
Jilles Tjoelker 2014-01-03 22:56:23 +00:00
parent faacdbd9cf
commit b14cfdf665
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=260246

View File

@ -32,7 +32,7 @@
.\" from: @(#)sh.1 8.6 (Berkeley) 5/4/95
.\" $FreeBSD$
.\"
.Dd November 1, 2013
.Dd January 3, 2014
.Dt SH 1
.Os
.Sh NAME
@ -235,10 +235,16 @@ or
.Dq Li ||
operator; or if the command is a pipeline preceded by the
.Ic !\&
operator.
keyword.
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.
.It Fl f Li noglob
Disable pathname expansion.
.It Fl h Li trackall