From e859ee1a4b150d1b293982dd93b75498f15880f5 Mon Sep 17 00:00:00 2001 From: Sven Wischnowsky Date: Wed, 9 May 2001 08:55:58 +0000 Subject: [PATCH] add description of how to add a auto-removable suffix when using a ->state action with _values (14279) --- ChangeLog | 5 +++++ Doc/Zsh/compsys.yo | 10 ++++++++++ 2 files changed, 15 insertions(+) diff --git a/ChangeLog b/ChangeLog index f8c804eee..ad718d4ea 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2001-05-09 Sven Wischnowsky + + * 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 * 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).