From 00b3085b969f46370f7cde28e9dfa10026b884c7 Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Fri, 6 Mar 2015 09:50:01 +0000 Subject: 34657: document the effect of substring subscripting better --- ChangeLog | 5 +++++ Doc/Zsh/params.yo | 12 +++++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index 74295288f..4f9f92886 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2015-03-06 Peter Stephenson + + * 34657: Doc/Zsh/params.yo: document the effect of substring + subscripting better. + 2015-03-05 Peter Stephenson * 34654: Completion/Redhat/Command/_rpm: complete absolute file diff --git a/Doc/Zsh/params.yo b/Doc/Zsh/params.yo index d044f8749..7b127bc68 100644 --- a/Doc/Zsh/params.yo +++ b/Doc/Zsh/params.yo @@ -187,7 +187,17 @@ from the end of the array tt(foo), and Subscripting may also be performed on non-array values, in which case the subscripts specify a substring to be extracted. For example, if tt(FOO) is set to `tt(foobar)', then -`tt(echo $FOO[2,5])' prints `tt(ooba)'. +`tt(echo $FOO[2,5])' prints `tt(ooba)'. Note that +some forms of subscripting described below perform pattern matching, +and in that case the substring extends from the start of the match +of the first subscript to the end of the match of the second +subscript. For example, + +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. subsect(Array Element Assignment) -- cgit 1.4.1