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

Previous Next

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Wed, 29 Mar 2017 15:05:01 UTC

Severity: wishlist

Tags: fixed

Found in version 24.5

Fixed in version 27.1

Done: Lars Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

Full log

Message #33 received at 26301 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Lars Ingebrigtsen <larsi <at> gnus.org>, Noam Postavsky <npostavs <at> gmail.com>
Cc: 26301 <at> debbugs.gnu.org
Subject: RE: 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.
This bug report was last modified 5 years and 352 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.