1
0
Fork 0
mirror of git://git.code.sf.net/p/zsh/code synced 2025-01-01 17:24:50 +01:00

unposted: ${(Z)}: Convert documentation to a description block.

This commit is contained in:
Daniel Shahaf 2020-03-19 01:54:38 +00:00
parent 65f8e90f0d
commit 68d2a1bc22
2 changed files with 20 additions and 4 deletions

View file

@ -1,5 +1,8 @@
2020-03-20 Daniel Shahaf <d.s@daniel.shahaf.name>
* unposted: Doc/Zsh/expn.yo: ${(Z)}: Convert documentation to
a description block.
* unposted: Util/ztst-syntax.vim: internal: ztst.vim: Make
sure syntax elements are only hidden if they're followed by
something visible

View file

@ -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(:))(