bug#43869: 28.0.50; reference to non existent variable in manual sect 23.3.3

bug#43869: 28.0.50; reference to non existent variable in manual sect 23.3.3

[mvar]

in section 23.3.3 "Defining Minor Modes" of the emacs manual

https://www.gnu.org/software/emacs/manual/html_node/elisp/Defining-Minor-Modes.html#Defining-Minor-Modes

there's a reference to a variable "hungry-mode-map" that does not exist
anywhere in the page & provided example.

excerpt from the page:

Here is an example of using define-minor-mode:

(define-minor-mode hungry-mode
  "Toggle Hungry mode.
Interactively with no argument, this command toggles the mode.
A positive prefix argument enables the mode, any other prefix
argument disables it.  From Lisp, argument omitted or nil enables
the mode, `toggle' toggles the state.

When Hungry mode is enabled, the control delete key
gobbles all preceding whitespace except the last.
See the command \\[hungry-electric-delete]."
 ;; The initial value.
 nil
 ;; The indicator for the mode line.
 " Hungry"
 ;; The minor mode bindings.
 '(([C-backspace] . hungry-electric-delete)))

This defines a minor mode named “Hungry mode”, a command named hungry-
mode to toggle it,
a variable named hungry-mode which indicates whether the mode is
enabled, and a variable
named hungry-mode-map which holds the keymap that is active when the
mode is enabled. 

bug#43869: 28.0.50; reference to non existent variable in manual sect 23.3.3

[Eli Zaretskii]

> From: mvar <mvar.40k@gmail.com>
> Date: Thu, 8 Oct 2020 22:01:09 +0300
> 
> in section 23.3.3 "Defining Minor Modes" of the emacs manual
> 
> https://www.gnu.org/software/emacs/manual/html_node/elisp/Defining-Minor-Modes.html#Defining-Minor-Modes
> 
> there's a reference to a variable "hungry-mode-map" that does not exist
> anywhere in the page & provided example.

That's because 'define-minor-mode' defines that map automatically.

bug#43869: 28.0.50; reference to non existent variable in manual sect 23.3.3

[mvar]

reading the page i was under the impression that it needs to be defined
separately as a variable and then passed in the minor mode definition as
a parameter.Looks like i missed the italics on the "mode"-map at the beginning of the page:

 If keymap is a keymap or an alist, this also defines the variable
 mode-map.

*sigh* you may close this, sorry for the trouble

bug#43869: 28.0.50; reference to non existent variable in manual sect 23.3.3

[Lars Ingebrigtsen]

mvar <mvar.40k@gmail.com> writes:

> *sigh* you may close this, sorry for the trouble

No trouble.  :-)

Closing.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no