bug#26301: 24.5; `define-derived-mode': different signatures for doc string & manual

[Michael Heerdegen]

Drew Adams <drew.adams@oracle.com> writes:

> > > However, in that case, KEYWORDS is the _wrong_ name.
> >
> > In a similar case, `define-globalized-minor-mode' uses the name KEYS
> > (it's the name of the &rest arg though).
>
> If each of the args in the &rest list is a KEY then that's fine.

No, that's not the case.

> Dunno whether our convention allows [KEYWORD VALUE]...
> (i.e., with the ... after the optional indication).

Yes, or even [[KEYWORD VALUE]...]?

I don't know if we have an official convention at all.  In this case
here, since &rest is following this specification, I think eldoc will be
confused in any case since it can't distinguish between keyword-value
pairs and the following &rest BODY.

Michael.