* Frank Terbeck <bts@bts.grml.org> [2008-02-06 12:25]:
> > And `help' is completing with brackets attached.
> > Culprit's the leading colon.
> Um, I just tried the completion. What is your problem with the way it
> currently works? I don't see any 'brackets attached'.
When completing, I get

     % grml-x -<TAB>
     Completing - option
     [...]
     -help         -- [display help]
     [...]

because in _grml-x there's defined:

    '-help:[display help]'

And according to the manual and my understanding, the colon's wrong
here.
    ,----[ man 1 zshcompsys | less -p '^\s+_arguments' ]-
    | optspec[explanation]
    | An  explanation  string may be appended to any of
    | the preceding forms of optspec by enclosing it in
    | brackets, as in ‘-q[query operation]’.
    | Just checked out the hg Repository again.
    | whereas a colon is, afaics, used to separate for messages and
    | actions.
    `----

Just checked out the hg Repository again.

> check_com() *would* be available for completions, too. I mean, in what
> environment are you using compsys *without* being in an interactive
> shell?
Right.

> However, I tend to agree with you. Leave check_com() out.
I guess, I did mean it the same way, but you obviously managed to
explain it in a  more understandable way.

---------------
P.S.: I marginally changed the diff concerning the brackets, because I
just found a 'typo'. It's the bracket at the end.

  % -mode   -- resolution-mode for xserver (<width>x<height> - % e.g. 1024x768)]