Re: Use glob patterns while reading a file

[Peter Stephenson <p.stephenson@samsung.com>]

Certainly $(<...) was always intended to make it easier to get hold of a
single file, so has never done globbing (which would logically imply
multios, if the option is on), although I'm not aware of any fundamental
reason why it would break anything if it did (the implementation is
actually rather different from normal redirection as the file is simply
read in bodily).

However, the documentation does say it's equivalent to using the cat
command, which isn't true if var(foo) has globbing characters in it ---
I presume when the manual entry was written nobody considered it might.

The sentence after is also a bit unclear --- I'm not sure which the two
cases referred to are, but I presume they're unquoted $(...) with a
normal command and unquoted $(<...).  As the case of double quotes is
mentioned (although in the negative) in between, this doesn't seem
ideal.

It doesn't explicitly say what happens if the expressions is quoted,
though it does imply the final newlines are removed in any case so I
suppose there's enough to go on.

Any number of trailing newlines are removed, not just one.  I suppose
"any trailing newlines" (plural) does cover that.

pws

diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo
index c791097..fbcf5d1 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)