GNU bug report logs - #52880
"(elisp) Menu Keymaps") - recommend easy-menu over creating menu by hand

Previous Next

To reply to this bug, email your comments to 52880 AT debbugs.gnu.org.

Toggle the display of automated, internal messages from the tracker.

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

From: Stefan Kangas <stefan <at> marxist.se>
To: bug-gnu-emacs <at> gnu.org
Subject: "(elisp) Menu Keymaps") - recommend easy-menu over creating menu by
 hand
Date: Wed, 29 Dec 2021 13:08:17 -0800

Severity: wishlist

The node (info "(elisp) Menu Keymaps") should recommend easy-menu over
creating a menu by hand.  Instead of "Easy Menu" being the last thing in
that node, it should be the first.

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Stefan Kangas <stefan <at> marxist.se>
Cc: 52880 <at> debbugs.gnu.org
Subject: Re: bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over
 creating menu by hand
Date: Wed, 29 Dec 2021 22:33:09 +0100

Stefan Kangas <stefan <at> marxist.se> writes:

> The node (info "(elisp) Menu Keymaps") should recommend easy-menu over
> creating a menu by hand.  Instead of "Easy Menu" being the last thing in
> that node, it should be the first.

Makes sense to me.

I'm also wondering whether we should come up with a new name for
`easy-menu-define' -- I think it's an unfortunate name that makes it
seem like a hacky "easy" way to define menus, instead of the primary
method, which it is.

But it might not be worth the bother.

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

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

From: Drew Adams <drew.adams <at> oracle.com>
To: Stefan Kangas <stefan <at> marxist.se>, "52880 <at> debbugs.gnu.org"
 <52880 <at> debbugs.gnu.org>
Subject: RE: [External] : bug#52880: "(elisp) Menu Keymaps") - recommend
 easy-menu over creating menu by hand
Date: Wed, 29 Dec 2021 21:57:51 +0000

> The node (info "(elisp) Menu Keymaps") should recommend easy-menu over
> creating a menu by hand.  Instead of "Easy Menu" being the last thing in
> that node, it should be the first.

Why?

I disagree.

It should do as it does now, present defining
menus in general terms first: "How to make a
keymap that defines a menu".  It starts by
telling you that "A keymap acts as a menu if"
it has a prompt string. And in continues by
telling you the easiest way to construct a
keymap with a prompt string.  And so on.

Node Easy Menu tells you that you can _add_ a
menu to a keymap.  It doesn't tell you that a
keymap can _be_ a menu.  Which means that it
doesn't tell you what an Emacs menu is.
(And yet it's a subnode of node Menu Keymaps.)

Node Easy Menu doesn't lead to anything.  It
has no "next" node for a reason.  The other
nodes under Menu Keymaps build on each other.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: Lars Ingebrigtsen <larsi <at> gnus.org>, Stefan Kangas <stefan <at> marxist.se>
Cc: "52880 <at> debbugs.gnu.org" <52880 <at> debbugs.gnu.org>
Subject: RE: [External] : bug#52880: "(elisp) Menu Keymaps") - recommend
 easy-menu over creating menu by hand
Date: Wed, 29 Dec 2021 21:57:53 +0000

> I'm also wondering whether we should come up with a new name for
> `easy-menu-define' -- I think it's an unfortunate name that makes it
> seem like a hacky "easy" way to define menus, instead of the primary
> method, which it is.

That's what it is: a hacky "easy" way to define
(some) menus.  (And the quotes are appropriate.)

Do you pretend that just the node Easy Menu is
sufficient, and just replace all of these nodes?

 Menu Keymaps
 Mouse Menus
 Keyboard Menus
 Menu Example
 Menu Bar
 Tool Bar
 Modifying Menus

I don't think so.  Far from it.

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

From: Stefan Kangas <stefan <at> marxist.se>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 52880 <at> debbugs.gnu.org
Subject: Re: bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over
 creating menu by hand
Date: Wed, 29 Dec 2021 14:43:05 -0800

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

> I'm also wondering whether we should come up with a new name for
> `easy-menu-define' -- I think it's an unfortunate name that makes it
> seem like a hacky "easy" way to define menus, instead of the primary
> method, which it is.

Could `defvar-menu' work?  It would go well with `defvar-keymap', if
nothing else.

> But it might not be worth the bother.

We could just make the old name into an alias, without making it
obsolete.

Or make the new name into an alias, which is even less invasive.

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Stefan Kangas <stefan <at> marxist.se>
Cc: 52880 <at> debbugs.gnu.org
Subject: Re: bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over
 creating menu by hand
Date: Thu, 30 Dec 2021 15:43:39 +0100

Stefan Kangas <stefan <at> marxist.se> writes:

> Could `defvar-menu' work?  It would go well with `defvar-keymap', if
> nothing else.

Yes, that'd be a good name, I think.  

>> But it might not be worth the bother.
>
> We could just make the old name into an alias, without making it
> obsolete.
>
> Or make the new name into an alias, which is even less invasive.

If we introduce something like `defvar-menu', then perhaps we should
consider changing the syntax slightly, but I guess it's fine as it is...

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

Previous Next

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