diff options
Diffstat (limited to 'Etc/completion-style-guide')
| -rw-r--r-- | Etc/completion-style-guide | 30 |
1 files changed, 28 insertions, 2 deletions
diff --git a/Etc/completion-style-guide b/Etc/completion-style-guide index 71b5c9a5c..a626c79fe 100644 --- a/Etc/completion-style-guide +++ b/Etc/completion-style-guide @@ -27,7 +27,7 @@ by giving it to functions like `_tags' via the `-C' options, as in: local context ... ... - _arguments ... '-foo:foo:->foo' + _arguments ... '-foo:foo:->foo' && return 0 ... if [[ "$state" = foo ]]; then _tags -C "$context" ... @@ -47,7 +47,7 @@ reported back to functions you call. E.g.: local curcontext="$curcontext" ... ... - _arguments -C ... 'foo:foo:->foo' + _arguments -C ... 'foo:foo:->foo' && return 0 ... if [[ "$state" = foo ]]; then _tags ... @@ -60,6 +60,32 @@ value changed by `_arguments' and `_values' is only used in your function (and make sure to initialise it to its old value as in the example). +All this only works if the specifications given to `_arguments' define +options and arguments that are completely separate. If there is more +than one `->state' action and more than one of them might be needed +for the same word, you'll have to use a loop: + + local state context line i expl ret=1 + ... + _arguments \ + '::arg1:->arg1' \ + '*:args:->rest' && return 0 + + while (( $#state )); do + case "$state[1]" in + arg1) _wanted -C "$context[1]" foo expl 'foo' compadd - foo1 foo2 && ret=0;; + rest) _wanted -C "$context[1]" bar expl 'bar' compadd - bar1 bar2 && ret=0;; + esac + shift 1 state + shift 1 context + done + + return ret + +As you can see, `state' and `context' are really arrays. In this +example, completion for the first argument has to complete both `foo's +and `bar's. + Then, before adding the matches, see if matches of that type are requested by the user in the current context. If you will add only one type of matches, this is very simple. You can use the function |