From 7292c063e8fe38c9212bfb47880934effc052ae1 Mon Sep 17 00:00:00 2001
From: Peter Stephenson
Date: Wed, 14 Nov 2018 14:22:10 +0000
Subject: 43620: More care documenting command substitution including $(<...)
---
Doc/Zsh/expn.yo | 13 ++++++++++---
1 file changed, 10 insertions(+), 3 deletions(-)
(limited to 'Doc')
diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo
index c79109700..a212d742d 100644
--- a/Doc/Zsh/expn.yo
+++ b/Doc/Zsh/expn.yo
@@ -1683,10 +1683,17 @@ any trailing newlines deleted.
If the substitution is not enclosed in double quotes, the
output is broken into words using the tt(IFS) parameter.
vindex(IFS, use of)
+
The substitution `tt($LPAR()cat) var(foo)tt(RPAR())' may be replaced
-by the equivalent but faster `tt($LPAR()<)var(foo)tt(RPAR())'.
-In either case, if the option tt(GLOB_SUBST) is set,
-the output is eligible for filename generation.
+by the faster `tt($LPAR()<)var(foo)tt(RPAR())'. In this case var(foo)
+undergoes single word shell expansions (em(parameter expansion),
+em(command substitution) and em(arithmetic expansion)), but not
+filename generation.
+
+If the option tt(GLOB_SUBST) is set, the result of any unquoted command
+substitution, including the special form just mentioned, is eligible for
+filename generation.
+
texinode(Arithmetic Expansion)(Brace Expansion)(Command Substitution)(Expansion)
sect(Arithmetic Expansion)
cindex(arithmetic expansion)
--
cgit 1.4.1