sh(1): Document the case command better.
authorPeter Avalos <pavalos@dragonflybsd.org>
Sun, 21 Aug 2011 22:02:29 +0000 (15:02 -0700)
committerPeter Avalos <pavalos@dragonflybsd.org>
Sun, 21 Aug 2011 22:02:29 +0000 (15:02 -0700)
Obtained-from:  FreeBSD 223517

bin/sh/sh.1

index 5740113..add56f1 100644 (file)
@@ -34,7 +34,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"    from: @(#)sh.1  8.6 (Berkeley) 5/4/95
-.\" $FreeBSD: src/bin/sh/sh.1,v 1.171 2011/06/18 23:43:28 jilles Exp $
+.\" $FreeBSD: src/bin/sh/sh.1,v 1.172 2011/06/24 20:23:50 jilles Exp $
 .\"
 .Dd August 21, 2011
 .Dt SH 1
@@ -1005,11 +1005,22 @@ described later),
 separated by
 .Ql \&|
 characters.
+Tilde expansion, parameter expansion, command substitution,
+arithmetic expansion and quote removal are applied to the word.
+Then, each pattern is expanded in turn using tilde expansion,
+parameter expansion, command substitution and arithmetic expansion and
+the expanded form of the word is checked against it.
+If a match is found, the corresponding list is executed.
 If the selected list is terminated by the control operator
 .Ql ;&
 instead of
 .Ql ;; ,
-execution continues with the next list.
+execution continues with the next list,
+continuing until a list terminated with
+.Ql ;;
+or the end of the
+.Ic case
+command.
 The exit code of the
 .Ic case
 command is the exit code of the last command executed in the list or