about summary refs log tree commit diff
path: root/Doc/Zsh
diff options
context:
space:
mode:
authorSven Wischnowsky <wischnow@users.sourceforge.net>2001-05-09 08:55:58 +0000
committerSven Wischnowsky <wischnow@users.sourceforge.net>2001-05-09 08:55:58 +0000
commite859ee1a4b150d1b293982dd93b75498f15880f5 (patch)
tree188cc42b3adf2ebc256a4ef887fdcab4b3b5ca1a /Doc/Zsh
parentbb7ea947662fae0242c3e5d542e6b76a5dcb8cbd (diff)
downloadzsh-e859ee1a4b150d1b293982dd93b75498f15880f5.tar.gz
zsh-e859ee1a4b150d1b293982dd93b75498f15880f5.tar.xz
zsh-e859ee1a4b150d1b293982dd93b75498f15880f5.zip
add description of how to add a auto-removable suffix when using a ->state action with _values (14279)
Diffstat (limited to 'Doc/Zsh')
-rw-r--r--Doc/Zsh/compsys.yo10
1 files changed, 10 insertions, 0 deletions
diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index 79574d321..0a203a7aa 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -4002,6 +4002,16 @@ when using an action of the form `tt(->)var(string)'.  With this
 function the tt(context) parameter will be set to the name of the
 value whose argument is to be completed.
 
+Note also that tt(_values) normally adds the character used as the
+separator between values as a auto-removable suffix so that users don't
+have to type it themselves.  But when using a `tt(->)var(string)' action
+tt(_values) can't do that because the matches for the argument will be
+generated by the calling function.  To get the usual behaviour, the
+implementor of the calling function has to add the suffix directly by
+passing the options `tt(-qS) var(x)' (where var(x) is the separator
+character specified with the tt(-s) option of tt(_values)) to the
+function generating the matches or to the tt(compadd) builtin.
+
 Like tt(_arguments), tt(_values) supports the tt(-C) option in
 which case you have to make the parameter tt(curcontext) local instead 
 of tt(context) (as described above).