diff options
| author | jilles <jilles@FreeBSD.org> | 2014-01-03 22:56:23 +0000 |
|---|---|---|
| committer | jilles <jilles@FreeBSD.org> | 2014-01-03 22:56:23 +0000 |
| commit | 98001789f4b3d64223a76091fb72c7c826543fe4 (patch) | |
| tree | ece06fa6c5ce98b50ae14d2868d332c35b912bf5 /bin/sh | |
| parent | 840ff10994803b60618b1dc2d5b9bafe095566f8 (diff) | |
| download | FreeBSD-src-98001789f4b3d64223a76091fb72c7c826543fe4.zip FreeBSD-src-98001789f4b3d64223a76091fb72c7c826543fe4.tar.gz | |
sh(1): Discourage use of -e.
Also, do not say that ! before a pipeline is an operator, because it is
syntactically a keyword.
Diffstat (limited to 'bin/sh')
| -rw-r--r-- | bin/sh/sh.1 | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/bin/sh/sh.1 b/bin/sh/sh.1 index 22e6ba6..dc1716c 100644 --- a/bin/sh/sh.1 +++ b/bin/sh/sh.1 @@ -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 |
