diff options
Diffstat (limited to 'Doc/Zsh')
-rw-r--r-- | Doc/Zsh/compwid.yo | 11 | ||||
-rw-r--r-- | Doc/Zsh/mod_computil.yo | 17 |
2 files changed, 26 insertions, 2 deletions
diff --git a/Doc/Zsh/compwid.yo b/Doc/Zsh/compwid.yo index fc2285e40..b5ebb4f8e 100644 --- a/Doc/Zsh/compwid.yo +++ b/Doc/Zsh/compwid.yo @@ -184,6 +184,17 @@ When completing inside quotes, this contains the quotation character (i.e. either a single quote, a double quote, or a backtick). Otherwise it is unset. ) +item(tt(all_quotes))( +The tt(-q) option of the tt(compset) builtin command (see below) +allows breaking a quoted string into separate words and completing one +of these words. This key allows to test which types of quoted strings +are currently broken into parts this way. Its value contains one +character for each quoting level. The characters are a single quote or +a double quote for strings quoted with these characters and a +backslash for strings not starting with a quote character. The first +character in the value always corresponds to the innermost quoting +level. +) item(tt(nmatches))( The number of matches generated and accepted by the completion code so far, excluding those matches that are only accepted by ignoring the diff --git a/Doc/Zsh/mod_computil.yo b/Doc/Zsh/mod_computil.yo index cc0abc38e..541f81605 100644 --- a/Doc/Zsh/mod_computil.yo +++ b/Doc/Zsh/mod_computil.yo @@ -1,16 +1,29 @@ texinode(The computil Module)(The deltochar Module)(The complist Module)(Zsh Modules) sect(The computil Module) cindex(completion, utility) -The tt(computil) module adds four builtin commands that are used by +The tt(computil) module adds several builtin commands that are used by some of the completion functions in the shell function based completions system (see ifzman(zmanref(zshcompsys))\ ifnzman(noderef(Completion System)) -). Except for tt(compdisplay) these builtin commands are very +). Except for tt(compquote) and tt(compdisplay) these builtin +commands are very specialised and thus not very interesting when writing your own completion functions. In short, these builtin commands are: startitem() +item(tt(compquote) var(names) ...)( +There may be reasons to write completion functions that have to add +the matches using the tt(-Q) option to tt(compadd) and do the quoting +themselves. Instead of interpreting the first character of the +tt(all_quotes) key of the tt(compstate) special association and using +the tt(q) flag for parameter expansions, one can use this builtin +command. The arguements are the names of scalar or array parameters +and the values of these parameters are quoted as needed for the +innermost quoting level. + +The return value is non-zero in case of an error and zero otherwise. +) item(tt(compdisplay) var(name) var(string) var(defs) ...)( The var(defs) are strings which should be of the form `var(str)tt(:)var(descr)' (the intended use is that the var(descr) |