bug#73108: 29.2; easy-menu-define

bug#73108: 29.2; easy-menu-define

[Francis Wright]

[-- Attachment #1: Type: text/plain, Size: 579 bytes --]

The docstring and the Elisp manual both state that easy-menu-define "defines SYMBOL as a function for popping up the menu" but it doesn't. It defines SYMBOL as a variable whose value is the menu, which could be used for popping up the menu. This behaviour is useful and I use it, so I suggest that the documentation should be corrected.

Thanks, Francis

In GNU Emacs 29.2 (build 2, x86_64-w64-mingw32) of 2024-01-18 built on AVALON
Windowing system distributor 'Microsoft Corp.', version 10.0.22631
System Description: Microsoft Windows 10 Home (v10.0.2009.22631.4037)


[-- Attachment #2: Type: text/html, Size: 1666 bytes --]

bug#73108: 29.2; easy-menu-define

[Eli Zaretskii]

> From: Francis Wright <f.j.wright@live.co.uk>
> Date: Sat, 7 Sep 2024 16:47:17 +0000
> 
> The docstring and the Elisp manual both state that easy-menu-define "defines SYMBOL as a function for
> popping up the menu" but it doesn't.

Are you sure?

  emacs -Q
  M-x load-library RET bookmark RET
  M-: (symbol-function 'bookmark-menu) RET
    => #[257 "\301^A\3009\203^W\0\302\300\303N\304\"...

Adding Stefan in case he has comments.

bug#73108: 29.2; easy-menu-define

[Francis Wright]

[-- Attachment #1: Type: text/plain, Size: 887 bytes --]

Looking again, SYMBOL appears to be both a variable and a function, so I was wrong. Sorry! But it might be helpful to add to the documentation that SYMBOL also defines a variable.

Francis
________________________________
From: Eli Zaretskii <eliz@gnu.org>
Sent: 07 September 2024 6:19 PM
To: Francis Wright <f.j.wright@live.co.uk>
Cc: 73108@debbugs.gnu.org <73108@debbugs.gnu.org>
Subject: Re: bug#73108: 29.2; easy-menu-define

> From: Francis Wright <f.j.wright@live.co.uk>
> Date: Sat, 7 Sep 2024 16:47:17 +0000
>
> The docstring and the Elisp manual both state that easy-menu-define "defines SYMBOL as a function for
> popping up the menu" but it doesn't.

Are you sure?

  emacs -Q
  M-x load-library RET bookmark RET
  M-: (symbol-function 'bookmark-menu) RET
    => #[257 "\301^A\3009\203^W\0\302\300\303N\304\"...

Adding Stefan in case he has comments.

[-- Attachment #2: Type: text/html, Size: 2017 bytes --]

bug#73108: 29.2; easy-menu-define

[Eli Zaretskii]

> From: Francis Wright <f.j.wright@live.co.uk>
> CC: "73108@debbugs.gnu.org" <73108@debbugs.gnu.org>
> Date: Sat, 7 Sep 2024 17:35:09 +0000
> 
> Looking again, SYMBOL appears to be both a variable and a function, so I was wrong. Sorry! But it might be
> helpful to add to the documentation that SYMBOL also defines a variable.

Done.