From ebc27890dad7f8332e5962f1026d5ce1fbe7cac3 Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Sun, 3 Aug 2014 20:31:21 +0100 Subject: user/19006: document position of RC_EXPAND_PARAM in parameter subst --- ChangeLog | 5 +++++ Doc/Zsh/expn.yo | 13 +++++++++---- 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 + + * users/19006: Doc/Zsh/expn.yo: document position of + RC_EXPAND_PARAM handling during parameter substitution. + 2014-08-01 Peter Stephenson * 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. -- cgit 1.4.1