GNU bug report logs - #4110
23.1.50; Checkdoc should recognize "minor mode"

Previous Next

Package: emacs;

Reported by: Lennart Borgman <lennart.borgman <at> gmail.com>

Date: Mon, 10 Aug 2009 21:55:05 UTC

Severity: wishlist

Tags: confirmed, fixed

Fixed in version 28.1

Done: Stefan Kangas <stefan <at> marxist.se>

Bug is archived. No further changes may be made.

Full log

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Mauro Aranda <maurooaranda <at> gmail.com>
Cc: Lennart Borgman <lennart.borgman <at> gmail.com>, 4110 <at> debbugs.gnu.org
Subject: Re: bug#4110: 23.1.50; Checkdoc should recognize "minor mode"
Date: Fri, 27 Aug 2021 05:10:08 +0200

Mauro Aranda <maurooaranda <at> gmail.com> writes:

> The change to allow this should be pretty simple: just add "mode" to the
> list of suggested words.
>
> But I do wonder if instead checkdoc should be happy just with the symbol
> ending with "-mode".  IOW,  I tend to think that there is no ambiguity
> in "`my-mode'" in a docstring, even if my-mode is defined as a variable
> and as a function.
>
> Any opinions?

Yes, I think that's a good idea -- requiring "mode" before `my-mode'
seems excessive.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no
This bug report was last modified 3 years and 297 days ago.

Previous Next

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