summary refs log tree commit diff
diff options
context:
space:
mode:
authorPeter Stephenson <p.w.stephenson@ntlworld.com>2014-08-03 20:31:21 +0100
committerPeter Stephenson <p.w.stephenson@ntlworld.com>2014-08-03 20:31:21 +0100
commitebc27890dad7f8332e5962f1026d5ce1fbe7cac3 (patch)
treeb3f0a897e32af8d9eccfa78e4143d17c9eede877
parentb79ef8caaf00d5fb26fa968fd2789a3f969ab22c (diff)
downloadzsh-ebc27890dad7f8332e5962f1026d5ce1fbe7cac3.tar.gz
zsh-ebc27890dad7f8332e5962f1026d5ce1fbe7cac3.tar.xz
zsh-ebc27890dad7f8332e5962f1026d5ce1fbe7cac3.zip
user/19006: document position of RC_EXPAND_PARAM in parameter subst
-rw-r--r--ChangeLog5
-rw-r--r--Doc/Zsh/expn.yo13
2 files changed, 14 insertions, 4 deletions
diff --git a/ChangeLog b/ChangeLog
index 0c7bffe2f..85b1ec23e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2014-08-03  Peter Stephenson  <p.w.stephenson@ntlworld.com>
+
+	* users/19006: Doc/Zsh/expn.yo: document position of
+	RC_EXPAND_PARAM handling during parameter substitution.
+
 2014-08-01  Peter Stephenson  <p.stephenson@samsung.com>
 
 	* 32932: Src/glob.c, Src/utils.c: add hmkarray() and
diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo
index ff9f2b177..727901346 100644
--- a/Doc/Zsh/expn.yo
+++ b/Doc/Zsh/expn.yo
@@ -1407,16 +1407,21 @@ item(tt(19.) em(Ordering))(
 If the result is still an array and one of the `tt((o))' or `tt((O))' flags
 was present, the array is reordered.
 )
-item(tt(20.) em(Re-evaluation))(
+item(tt(20.) tt(RC_EXPAND_PARAM))(
+At this point the decision is made whether any resulting array elements
+are to be combined element by element with surrounding text, as given
+by either the tt(RC_EXPAND_PARAM) option or the `tt(^)' flag.
+)
+item(tt(21.) em(Re-evaluation))(
 Any `tt((e))' flag is applied to the value, forcing it to be re-examined
 for new parameter substitutions, but also for command and arithmetic
 substitutions.
 )
-item(tt(21.) em(Padding))(
+item(tt(22.) em(Padding))(
 Any padding of the value by the `tt(LPAR()l.)var(fill)tt(.RPAR())' or
 `tt(LPAR()r.)var(fill)tt(.RPAR())' flags is applied.
 )
-item(tt(22.) em(Semantic joining))(
+item(tt(23.) em(Semantic joining))(
 In contexts where expansion semantics requires a single word to
 result, all words are rejoined with the first character of tt(IFS)
 between.  So in `tt(${LPAR()P)tt(RPAR()${LPAR()f)tt(RPAR()lines}})'
@@ -1425,7 +1430,7 @@ joined again before the tt(P) flag can be applied.
 
 If a single word is not required, this rule is skipped.
 )
-item(tt(23.) em(Empty argument removal))(
+item(tt(24.) em(Empty argument removal))(
 If the substitution does not appear in double quotes, any resulting
 zero-length argument, whether from a scalar or an element of an array,
 is elided from the list of arguments inserted into the command line.