unposted (cf. 40617): clarify description of ${(A)name=value} and ${(AA)name=value}

2 files changed, 8 insertions, 5 deletions

diff --git a/ChangeLog b/ChangeLog
index 8a0e059a2..8a069b209 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2017-02-23  Barton E. Schaefer  <schaefer@zsh.org>
 
+	* unposted (cf. 40617): Doc/Zsh/expn.yo: clarify description of
+	the ${(A)name=value} and ${(AA)name=value} parameter flag uses.
+
 	* 40624 (cf. Danek Duvall, 40563): Src/signals.c: conditionally
 	handle WIFCONTINUED to properly set SP_RUNNING process status
 
diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo
index cf4f69ea2..43ecd3155 100644
--- a/Doc/Zsh/expn.yo
+++ b/Doc/Zsh/expn.yo
@@ -955,15 +955,15 @@ This is distinct from em(field splitting) by the tt(f), tt(s)
 or tt(z) flags, which still applies within each array element.
 )
 item(tt(A))(
-Create an array parameter with `tt(${)...tt(=)...tt(})',
+Assign as an array parameter with `tt(${)...tt(=)...tt(})',
 `tt(${)...tt(:=)...tt(})' or `tt(${)...tt(::=)...tt(})'.
-If this flag is repeated (as in `tt(AA)'), create an associative
+If this flag is repeated (as in `tt(AA)'), assign an associative
 array parameter.  Assignment is made before sorting or padding;
 if field splitting is active, the var(word) part is split before
 assignment.  The var(name) part may be a subscripted range for
-ordinary arrays; the var(word) part em(must) be converted to
-an array, for example by using `tt(${(AA)=)var(name)tt(=)...tt(})'
-to activate field splitting, when creating an associative array.
+ordinary arrays; when assigning an associative array, the var(word)
+part em(must) be converted to an array, for example by using
+`tt(${(AA)=)var(name)tt(=)...tt(})' to activate field splitting.
 )
 item(tt(a))(
 Sort in array index order; when combined with `tt(O)' sort in reverse