From caf6190251af8e27d9cd6689dc2223f42546a770 Mon Sep 17 00:00:00 2001 From: Tanaka Akira Date: Mon, 6 Sep 1999 11:18:26 +0000 Subject: manual/7652-for-pws-3 --- Doc/Zsh/compsys.yo | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) (limited to 'Doc/Zsh/compsys.yo') diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo index 8f235710b..abf4d592b 100644 --- a/Doc/Zsh/compsys.yo +++ b/Doc/Zsh/compsys.yo @@ -1121,6 +1121,48 @@ as `tt(another number)' and gets an optional argument decribed as `tt(2)', and `tt(3)'. The tt(_values) function will complete lists of these values separated by commas. +To decide if the descriptions for the values (not those for the +arguments) should be printed, the configuration key +tt(describe_values) is used in the same way as the key +tt(describe_options) is used by the tt(_arguments) function. +) +item(tt(_values))( +This is used to complete values (strings) and their arguments or +lists of such values. If the first argument is the option `tt(-s)', +the second argument is used as the character that separates multiple +values. + +The first argument (after the option and separator character if they +are given) is used as a string to print as a description before +listing the values. + +All other arguments describe the possible values and their +arguments in the same format used for the description of options by +the tt(_arguments) function (see above). The only difference is that +there is no required minus or plus sign at the beginning and that +values can have only one argument. + +Example: + +example(_values -s , '...' \ + '*foo[bar]' \ + '(two)*one[number]:first count:' \ + 'two[another number]::second count:(1 2 3)') + +This describes three possible values: `tt(foo)', `tt(one)', and +`tt(two)'. The first one is described as `tt(bar)', gets no argument +and may appear more than once. The second one is described as +`tt(number)', may appear more than once, and gets one mandatory +argument described as `tt(first count)' for which no action is +specified so that it will not be completed automatically. The +`tt((one))' at the beginning says that if the value `tt(one)' is on +the line, the value `tt(two)' will not be considered to be a possible +completion any more. Finally, the last value (`tt(two)') is described +as `tt(another number)' and gets an optional argument decribed as +`tt(second count)' which will be completed from the strings `tt(1)', +`tt(2)', and `tt(3)'. The tt(_values) function will complete lists of +these values separated by commas. + To decide if the descriptions for the values (not those for the arguments) should be printed, the configuration key tt(describe_values) is used in the same way as the key -- cgit 1.4.1