From 68d2a1bc2235a8b88399252e801025b663d6e9be Mon Sep 17 00:00:00 2001 From: Daniel Shahaf Date: Thu, 19 Mar 2020 01:54:38 +0000 Subject: unposted: ${(Z)}: Convert documentation to a description block. --- Doc/Zsh/expn.yo | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) (limited to 'Doc') diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo index c129b4228..2a66ab997 100644 --- a/Doc/Zsh/expn.yo +++ b/Doc/Zsh/expn.yo @@ -1377,16 +1377,29 @@ i.e. tt("${(@s.:.)line}"). item(tt(Z:)var(opts)tt(:))( As tt(z) but takes a combination of option letters between a following pair of delimiter characters. With no options the effect is identical -to tt(z). tt(LPAR()Z+PLUS()c+PLUS()RPAR()) +to tt(z). The following options are available: + +startitem() +item(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 +comment. +) +item(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 character of tt($HISTCHARS), default tt(#), up to -the next newline is a comment. tt(LPAR()Z+PLUS()n+PLUS()RPAR()) causes +the next newline is a comment. +) +item(tt(LPAR()Z+PLUS()n+PLUS()RPAR()))( +causes unquoted newlines to be treated as ordinary whitespace, else they are treated as if they are shell code delimiters and converted to -semicolons. Options are combined within the same set of delimiters, +semicolons. +) +enditem() + +Options are combined within the same set of delimiters, e.g. tt(LPAR()Z+PLUS()Cn+PLUS()RPAR()). ) item(tt(_:)var(flags)tt(:))( -- cgit 1.4.1