about summary refs log tree commit diff
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
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)
-rw-r--r--ChangeLog5
-rw-r--r--Doc/Zsh/compsys.yo10
2 files changed, 15 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index f8c804eee..ad718d4ea 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2001-05-09  Sven Wischnowsky  <wischnow@zsh.org>
+
+	* 14279: Doc/Zsh/compsys.yo: add description of how to add a
+	auto-removable suffix when using a ->state action with _values
+
 2001-05-08  Bart Schaefer  <schaefer@zsh.org>
 
 	* 14275: configure.in, acconfig.h: Fix 14270 so that it works
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).