GNU bug report logs - #9819
24.0.50; Docstring of `define-minor-mode' and KEYMAP

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Glenn Morris <rgm <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#9819: closed (24.0.50; Docstring of `define-minor-mode' and
 KEYMAP)
Date: Mon, 24 Oct 2011 17:40:02 +0000

[Message part 1 (text/plain, inline)]

Your message dated Mon, 24 Oct 2011 13:37:28 -0400
with message-id <wg4nyy9tpj.fsf <at> fencepost.gnu.org>
and subject line Re: bug#9819: 24.0.50; Docstring of `define-minor-mode' and KEYMAP
has caused the debbugs.gnu.org bug report #9819,
regarding 24.0.50; Docstring of `define-minor-mode' and KEYMAP
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
9819: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=9819
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Deniz Dogan <deniz <at> dogan.se>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.0.50; Docstring of `define-minor-mode' and KEYMAP
Date: Fri, 21 Oct 2011 00:57:49 +0200

I read in the docstring of `define-minor-mode':

<quote>
Optional KEYMAP is the default keymap bound to the mode keymap.
  If non-nil, it should be a variable name (whose value is a keymap),
  or an expression that returns either a keymap or a list of
  arguments for `easy-mmode-define-keymap'.  If KEYMAP is not a symbol,
  this also defines the variable MODE-map.

  [...]

:keymap MAP	Same as the KEYMAP argument.
</quote>

The way I interpret that is: if I don't pass a KEYMAP argument, it will
define a variable named `MODE-map'.  However, this doesn't happen when I
use this code:

<quote>
(define-minor-mode helo-track-minor-mode
  "Global minor mode for tracking activity in helo buffers."
  :init-value nil
  :lighter ""
  :global t
  :group 'helo
  [...]
</quote>

Am I misunderstanding the docstring or is this a bug?

Deniz

[Message part 3 (message/rfc822, inline)]

From: Glenn Morris <rgm <at> gnu.org>
To: 9819-done <at> debbugs.gnu.org
Subject: Re: bug#9819: 24.0.50; Docstring of `define-minor-mode' and KEYMAP
Date: Mon, 24 Oct 2011 13:37:28 -0400

Version: 24.0.91

I have tried to clarify the doc-string.

Previous Next

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