GNU bug report logs - #34073
26.1; Missing documentation for minor mode hook behavior

Previous Next

Package: emacs;

Reported by: Piotr Kaznowski <piotr.kaznowski <at> gmail.com>

Date: Mon, 14 Jan 2019 15:01:03 UTC

Severity: minor

Tags: fixed

Found in version 26.1

Fixed in version 28.1

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

Bug is archived. No further changes may be made.

Full log

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Noam Postavsky <npostavs <at> gmail.com>
Cc: 34073 <at> debbugs.gnu.org, Piotr Kaznowski <piotr.kaznowski <at> gmail.com>
Subject: Re: bug#34073: 26.1;
 Missing documentation for minor mode hook behavior
Date: Wed, 10 Jul 2019 00:43:21 +0200

Noam Postavsky <npostavs <at> gmail.com> writes:

> Maybe define-minor-mode could mention this in the mode's docstring, like
> it does for the ARG?

It subtly alludes to this in this bit:

--
BODY contains code to execute each time the mode is enabled or disabled.
  It is executed after toggling the mode, and before running MODE-hook.
--

But that's not the documentation somebody who wonders when hooks are run
would look -- that macro is for people who implement modes, not people
who just wants to run some hooks...

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

Previous Next

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