GNU bug report logs - #10754
define-minor-mode and doc of derived mode

Previous Next

Package: emacs;

Reported by: Glenn Morris <rgm <at> gnu.org>

Date: Tue, 7 Feb 2012 18:04:02 UTC

Severity: wishlist

Found in version 24.0.93

Fixed in version 27.1

Done: Glenn Morris <rgm <at> gnu.org>

Bug is archived. No further changes may be made.

Full log

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

From: Stefan Monnier <monnier <at> IRO.UMontreal.CA>
To: John Shahid <jvshahid <at> gmail.com>
Cc: Eli Zaretskii <eliz <at> gnu.org>, drew.adams <at> oracle.com, 10754 <at> debbugs.gnu.org
Subject: Re: bug#10754: define-minor-mode and doc of derived mode
Date: Wed, 20 Jun 2018 17:55:38 -0400

>> I think in the long term (asymptotically), the arg is unneeded.
>> But if we add the arg, the long term will be that *all* calls will use
>> the arg, so we'll never be able to get rid of it.
> I'm worried about minor modes that don't even mention the argument.

I suspect that it's a misfeature which would be fixed by always adding
that paragraph.

> Not sure if that should be a concern since they should be documenting the
> ARG in the first place.

Exactly.

> I can provide examples, but the Emacs codebase has a few of those.

The only problematic case would be if adding this paragraph would be harmful.


        Stefan
This bug report was last modified 6 years and 194 days ago.

Previous Next

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