From 0a5702457b4074c72b201fb0eeb68b89763c7874 Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Sun, 12 Dec 2010 22:44:50 +0000 Subject: 28510: add (z+c+) and (z+C+) parameter flags --- Doc/Zsh/expn.yo | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'Doc') diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo index aadc72dfc..5768b82df 100644 --- a/Doc/Zsh/expn.yo +++ b/Doc/Zsh/expn.yo @@ -1006,6 +1006,17 @@ errors are silently ignored. item(tt(z))( Split the result of the expansion into words using shell parsing to find the words, i.e. taking into account any quoting in the value. +Comments are not treated specially but as ordinary strings, similar +to interactive shells with the tt(INTERACTIVE_COMMENTS) option unset. + +The flag can take option letters between a following pair of +`tt(PLUS())' characters. tt(LPAR()z+PLUS()c+PLUS()RPAR()) causes +comments to be parsed as a string and retained; any field in the +resulting array beginning with an unquoted comment character is a +comment. tt(LPAR()z+PLUS()C+PLUS()RPAR()) causes comments to be parsed +and removed. The rule for comments is standard: anything between a word +starting with the third charcter of tt($HISTCHARS), default tt(#), up to +the next newline is a comment. Note that this is done very late, as for the `tt((s))' flag. So to access single words in the result, one has to use nested expansions as -- cgit 1.4.1