summary refs log tree commit diff
path: root/Doc/Zsh
diff options
context:
space:
mode:
authorBarton E. Schaefer <schaefer@zsh.org>2015-07-06 16:18:49 -0700
committerBarton E. Schaefer <schaefer@zsh.org>2015-07-06 16:35:25 -0700
commitef3db713d5d3668e8f99e3262d2470e7058829d4 (patch)
treea96762307024557ab4e21c3e6250c09c920ba8f8 /Doc/Zsh
parenta9add3de545d71be3d882f94714e4d2857b0ef15 (diff)
downloadzsh-ef3db713d5d3668e8f99e3262d2470e7058829d4.tar.gz
zsh-ef3db713d5d3668e8f99e3262d2470e7058829d4.tar.xz
zsh-ef3db713d5d3668e8f99e3262d2470e7058829d4.zip
35709: explain :s/// modifier contexts.
Diffstat (limited to 'Doc/Zsh')
-rw-r--r--Doc/Zsh/expn.yo13
1 files changed, 13 insertions, 0 deletions
diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo
index 7d4e6fccb..1e1fc522f 100644
--- a/Doc/Zsh/expn.yo
+++ b/Doc/Zsh/expn.yo
@@ -319,6 +319,19 @@ forms of expansion.
 Note that if a `tt(&)' is used within glob qualifiers an extra backslash
 is needed as a tt(&) is a special character in this case.
 
+Also note that the order of expansions affects the interpretation of
+var(l) and var(r).  When used in a history expansion, which occurs before
+any other expansions, var(l) and var(r) are treated as literal strings
+(except as explained for tt(HIST_SUBST_PATTERN) below).  When used in
+parameter expansion, the replacement of var(r) into the parameter's value
+is done first, and then any additional process, parameter, command,
+arithmetic, or brace references are applied, which may evaluate those
+substitutions and expansions more than once if var(l) appears more than
+once in the starting value.  When used in a glob qualifier, any
+substitutions or expansions are performed once at the time the qualifier
+is parsed, even before the `tt(:s)' expression itself is divided into
+var(l) and var(r) sides.
+
 If the option tt(HIST_SUBST_PATTERN) is set, var(l) is treated as
 a pattern of the usual form described in
 ifzman(the section FILENAME GENERATION below)\