_describe usage

_describe usage

[Boyd Adamson]

Hi,

I'm working on my first completion code for a non-trivial command, and I
don't understand what _describe is doing (or how to get it to do what I
want).

What I want is to see something like this in menu selection:
fruit
apple   banana
animal
cat     dog   

I've tried a couple of approaches. My reading of the man page seems to
imply I can do this:

    rts=(apple banana)
    srts=(cat dog)
    _describe "fruit" rts -- "animal" srts

But that gets me this:

jarrah:/# scrgadm -a -j blah -t <tab>
fruit
        apple   banana

and if I menuselect to the blank position under "fruit" I get "cat" on
the commmand line!

I also tried this:

    rts=(apple banana)
    srts=(cat dog)
    _describe "fruit" rts 
    _describe "animal" srts 

But then I see:

jarrah:/# scrgadm -a -j blah -t <tab>
fruit
animal
apple   banana  cat     dog   


What am I doing wrong?

Re: _describe usage

[Oliver Kiddle]

Boyd Adamson wrote:
> I've tried a couple of approaches. My reading of the man page seems to
> imply I can do this:
> 
>     rts=(apple banana)
>     srts=(cat dog)
>     _describe "fruit" rts -- "animal" srts

You can't specify a different description for the second group (after
`--'). Only other completion options like suffixes.

> I also tried this:
> 
>     rts=(apple banana)
>     srts=(cat dog)
>     _describe "fruit" rts 
>     _describe "animal" srts 

That would work if you specify a different tag for the two sets of
completions:
  _describe -t fruits fruit rts
  _describe -t animals animal srts

Otherwise, both fruits and animals are added with the tag `values'. It
is the tag rather than the description which determines the grouping of
matches.

Oliver