More [key]=value tweaks

Some rephrasings.

Update typeset -p for associative arrays to use new syntax.

ChangeLog

@@ -1,3 +1,9 @@
+2017-09-14  Peter Stephenson  <p.w.stephenson@ntlworld.com>
+
+	* Doc/Zsh/expn.yo, Doc/ZSh/params.yo, Src/params.c,
+	Test/B02typeset.ztst, Test/V10private.ztst: typeset -p output
+	for associative arrays and some rephrasings.
+
 2017-09-13  Peter Stephenson  <p.w.stephenson@ntlworld.com>
 
 	* unposted: typo in proceeding Doc noticed by Oliver.

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

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

Src/params.c

@@ -5564,9 +5564,7 @@ printparamvalue(Param p, int printflags)
 {
     char *t, **u;
 
-    if (printflags & PRINT_KV_PAIR)
-	putchar(' ');
-    else
+    if (!(printflags & PRINT_KV_PAIR))
 	putchar('=');
 
     /* How the value is displayed depends *
@@ -5721,7 +5719,11 @@ printparamnode(HashNode hn, int printflags)
 	zputs(p->node.nam, stdout);
 	putchar('\n');
     } else {
+	if (printflags & PRINT_KV_PAIR)
+	    putchar('[');
 	quotedzputs(p->node.nam, stdout);
+	if (printflags & PRINT_KV_PAIR)
+	    printf("]=");
 
 	printparamvalue(p, printflags);
     }

Test/B02typeset.ztst

@@ -763,6 +763,7 @@
  for key in ${(ok)keyvalhash}; do
    print -l $key $keyvalhash[$key]
  done
+ typeset -p keyvalhash
 0:Substitution in [key]=val syntax
 >*
 >?not_globbed?
@@ -776,3 +777,4 @@
 >another value
 >the key
 >the value
+>typeset -A keyvalhash=( ['*']='?not_globbed?' ['another key']='another value' ['the key']='the value' )

Test/V10private.ztst

@@ -123,7 +123,7 @@
  print ${(kv)hash_test}
 0:private hides value from surrounding scope in nested scope
 >typeset -a hash_test=( top level )
->typeset -A hash_test=( in function )
+>typeset -A hash_test=( [in]=function )
 >typeset -g -a hash_test=( top level )
 >array-local top level
 >top level