GNU bug report logs - #43713
26.3; doc of `define-generic-mode'

Previous Next

Package: emacs;

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

Date: Tue, 29 Sep 2020 19:56:01 UTC

Severity: minor

Tags: fixed

Found in version 26.3

Fixed in version 28.1

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

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 43713 in the body.
You can then email your comments to 43713 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#43713; Package emacs. (Tue, 29 Sep 2020 19:56:02 GMT) Full text and rfc822 format available.
Acknowledgement sent to Drew Adams <drew.adams <at> oracle.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Tue, 29 Sep 2020 19:56:02 GMT) Full text and rfc822 format available.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 26.3; doc of `define-generic-mode'
Date: Tue, 29 Sep 2020 12:55:00 -0700 (PDT)

The doc string says nothing at all about what a generic mode is.

(elisp) `Generic Modes' says only this:

  "Generic modes" are simple major modes with basic support for comment
  syntax and Font Lock mode.

Is that all users need to know about a generic mode?

Can we at least say something like that in the doc string?



In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.18362
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#43713; Package emacs. (Wed, 30 Sep 2020 01:53:02 GMT) Full text and rfc822 format available.

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 43713 <at> debbugs.gnu.org
Subject: Re: bug#43713: 26.3; doc of `define-generic-mode'
Date: Wed, 30 Sep 2020 03:52:32 +0200

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

> The doc string says nothing at all about what a generic mode is.
>
> (elisp) `Generic Modes' says only this:
>
>   "Generic modes" are simple major modes with basic support for comment
>   syntax and Font Lock mode.
>
> Is that all users need to know about a generic mode?
>
> Can we at least say something like that in the doc string?

I've now done so in Emacs 28.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no
Added tag(s) fixed. Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Wed, 30 Sep 2020 01:53:02 GMT) Full text and rfc822 format available.
bug marked as fixed in version 28.1, send any further explanations to 43713 <at> debbugs.gnu.org and Drew Adams <drew.adams <at> oracle.com> Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Wed, 30 Sep 2020 01:53:02 GMT) Full text and rfc822 format available.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Wed, 28 Oct 2020 11:24:05 GMT) Full text and rfc822 format available.
This bug report was last modified 4 years and 293 days ago.

Previous Next

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