From ab7be4238ca89b5dca482a1c3b3fd013b105750e Mon Sep 17 00:00:00 2001
From: Peter Stephenson
Date: Thu, 14 Sep 2017 21:43:37 +0100
Subject: More [key]=value tweaks
Some rephrasings.
Update typeset -p for associative arrays to use new syntax.
---
Doc/Zsh/expn.yo | 7 ++++---
Doc/Zsh/params.yo | 9 ++++++---
2 files changed, 10 insertions(+), 6 deletions(-)
(limited to 'Doc/Zsh')
diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo
index a61738f84..d5e5838df 100644
--- a/Doc/Zsh/expn.yo
+++ b/Doc/Zsh/expn.yo
@@ -1025,9 +1025,10 @@ ifnzman(noderef(Filename Expansion))\
ifzman(the section FILENAME EXPANSION below).
)
item(tt(e))(
-Perform em(parameter expansion), em(command substitution) and
-em(arithmetic expansion) on the result. Such expansions can be
-nested but too deep recursion may have unpredictable effects.
+Perform single word shell expansions, namely em(parameter expansion),
+em(command substitution) and em(arithmetic expansion), on the
+result. Such expansions can be nested but too deep recursion may have
+unpredictable effects.
)
item(tt(f))(
Split the result of the expansion at newlines. This is a shorthand
diff --git a/Doc/Zsh/params.yo b/Doc/Zsh/params.yo
index 33e9fd69a..2534d1c72 100644
--- a/Doc/Zsh/params.yo
+++ b/Doc/Zsh/params.yo
@@ -102,13 +102,16 @@ may be in any order. Note that this syntax is strict: tt([) and tt(]=) must
not be quoted, while var(key) may not consist of the unquoted string
tt(]=), but is otherwise treated as a simple string. Furthermore, all
elements must match this form or an error is generated; likewise, if the
-first entry does not match this form any later entry that does is taken
+first entry does not match this form, any later entry that does is taken
as a simple value rather than a key / value pair. The enhanced forms of
subscript expression that may be used when directly subscripting a
variable name, described in the section Array Subscripts below, are not
available. Both var(key) and var(value) undergo all forms of expansion
-allowed for single word substitutions (this does not include filename
-generation).
+allowed for single word shell expansions (this does not include filename
+generation); these are as performed by the parameter expansion flag
+tt(LPAR()e+RPAR()) as described in
+ifzman(zmanref(zshparam))\
+ifnzman(nodref(Parameter Expansion)).
If no parameter var(name) exists, an ordinary array parameter is created.
If the parameter var(name) exists and is a scalar, it is replaced by a new
--
cgit 1.4.1