[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#26301: 24.5; `define-derived-mode': different signatures for doc str
From: |
Drew Adams |
Subject: |
bug#26301: 24.5; `define-derived-mode': different signatures for doc string & manual |
Date: |
Sat, 27 Jul 2019 09:54:45 -0700 (PDT) |
> \(fn CHILD PARENT NAME [DOCSTRING] [KEYWORDS...] &rest BODY)
>
> So I've now done this and adjusted the rest of the doc string
> accordingly.
Sounds good. That's what I suggested, but with the
addition of the `...' (good).
However, in that case, KEYWORDS is the _wrong_ name.
It is not _keywords_, which is presumably a _list_
of keywords (or more exactly, keyword key-value
pairs), that is repeated. What is optional is not
a list of lists. What is optional is a list of
keywords (or more exactly...).
The name should be KEYWORD or KEYWORD-ENTRY or
KEYWORD-PAIR or some such. It should not be
KEYWORDS.