diff options
author | jilles <jilles@FreeBSD.org> | 2011-06-24 22:08:26 +0000 |
---|---|---|
committer | jilles <jilles@FreeBSD.org> | 2011-06-24 22:08:26 +0000 |
commit | 76e2eec6e1b5cd6ff5d24d6629a89ad35414c6c2 (patch) | |
tree | c6fb2d4351e23b9856985b38e6423cce7ad6a92a /bin | |
parent | 97be6feacb7ff2fabc0576a8d100d3c75e5e7645 (diff) | |
download | FreeBSD-src-76e2eec6e1b5cd6ff5d24d6629a89ad35414c6c2.zip FreeBSD-src-76e2eec6e1b5cd6ff5d24d6629a89ad35414c6c2.tar.gz |
sh(1): Improve documentation of shell patterns:
* Shell patterns are also for ${var#pat} and the like.
* An '!' by itself will not trigger pathname generation so do not call it a
meta-character, even though it has a special meaning directly after an
'['.
* Character ranges are locale-dependent.
* A '^' will complement a character class like '!' but is non-standard.
MFC after: 1 week
Diffstat (limited to 'bin')
-rw-r--r-- | bin/sh/sh.1 | 15 |
1 files changed, 10 insertions, 5 deletions
diff --git a/bin/sh/sh.1 b/bin/sh/sh.1 index bb101336..4a9fe06 100644 --- a/bin/sh/sh.1 +++ b/bin/sh/sh.1 @@ -1629,15 +1629,15 @@ There are two restrictions on this: first, a pattern cannot match a string containing a slash, and second, a pattern cannot match a string starting with a period unless the first character of the pattern is a period. -The next section describes the patterns used for both -Pathname Expansion and the +The next section describes the patterns used for +Pathname Expansion, +the four varieties of parameter expansion for substring processing and the .Ic case command. .Ss Shell Patterns A pattern consists of normal characters, which match themselves, and meta-characters. The meta-characters are -.Ql \&! , .Ql * , .Ql \&? , and @@ -1667,7 +1667,7 @@ matches a .Ql \&[ rather than introducing a character class. A character class matches any of the characters between the square brackets. -A range of characters may be specified using a minus sign. +A locale-dependent range of characters may be specified using a minus sign. A named class of characters (see .Xr wctype 3 ) may be specified by surrounding the name with @@ -1680,12 +1680,17 @@ is a shell pattern that matches a single letter. The character class may be complemented by making an exclamation point .Pq Ql !\& the first character of the character class. +A caret +.Pq Ql ^ +has the same effect but is non-standard. .Pp To include a .Ql \&] in a character class, make it the first character listed (after the -.Ql \&! , +.Ql \&! +or +.Ql ^ , if any). To include a .Ql - , |