From e85906ebc970be9c5114f10dd5869c5cdaca9a65 Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Tue, 10 Mar 2015 12:19:26 +0000 Subject: users/19985: improve doc of subscripting substrings further --- ChangeLog | 5 +++++ Doc/Zsh/params.yo | 12 +++++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index bdb177cfb..9f523eb76 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2015-03-10 Peter Stephenson + + * users/19985: Doc/Zsh/params.yo: improve doc of substring + subscripting further. + 2015-03-09 Daniel Shahaf * 34673: Functions/VCS_Info/Backends/VCS_INFO_get_data_git: diff --git a/Doc/Zsh/params.yo b/Doc/Zsh/params.yo index 7b127bc68..2f789209e 100644 --- a/Doc/Zsh/params.yo +++ b/Doc/Zsh/params.yo @@ -197,7 +197,17 @@ example(string="abcdefghijklm" print ${string[+LPAR()r+RPAR()d?,+LPAR()r+RPAR()h?]}) prints `tt(defghi)'. This is an obvious generalisation of the -rule for single-character matches. +rule for single-character matches. For a single subscript, +only a single character is referenced (not the range of characters +covered by the match). + +Note that in substring operations the second subscript is handled +differently by the tt(r) and tt(R) subscript flags: the former takes the +shortest match as the length and the latter the longest match. Hence +in the former case a tt(*) at the end is redundant while in +the latter case it matches the whole remainder of the string. This +does not affect the result of the single subscript case as here the +length of the match is irrelevant. subsect(Array Element Assignment) -- cgit 1.4.1