unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over creating menu by hand
@ 2021-12-29 21:08 Stefan Kangas
  2021-12-29 21:33 ` Lars Ingebrigtsen
  2021-12-29 21:57 ` bug#52880: [External] : " Drew Adams
  0 siblings, 2 replies; 6+ messages in thread
From: Stefan Kangas @ 2021-12-29 21:08 UTC (permalink / raw)
  To: 52880

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.





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over creating menu by hand
  2021-12-29 21:08 bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over creating menu by hand Stefan Kangas
@ 2021-12-29 21:33 ` Lars Ingebrigtsen
  2021-12-29 21:57   ` bug#52880: [External] : " Drew Adams
  2021-12-29 22:43   ` Stefan Kangas
  2021-12-29 21:57 ` bug#52880: [External] : " Drew Adams
  1 sibling, 2 replies; 6+ messages in thread
From: Lars Ingebrigtsen @ 2021-12-29 21:33 UTC (permalink / raw)
  To: Stefan Kangas; +Cc: 52880

Stefan Kangas <stefan@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





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#52880: [External] : bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over creating menu by hand
  2021-12-29 21:08 bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over creating menu by hand Stefan Kangas
  2021-12-29 21:33 ` Lars Ingebrigtsen
@ 2021-12-29 21:57 ` Drew Adams
  1 sibling, 0 replies; 6+ messages in thread
From: Drew Adams @ 2021-12-29 21:57 UTC (permalink / raw)
  To: Stefan Kangas, 52880@debbugs.gnu.org

> 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.

^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#52880: [External] : bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over creating menu by hand
  2021-12-29 21:33 ` Lars Ingebrigtsen
@ 2021-12-29 21:57   ` Drew Adams
  2021-12-29 22:43   ` Stefan Kangas
  1 sibling, 0 replies; 6+ messages in thread
From: Drew Adams @ 2021-12-29 21:57 UTC (permalink / raw)
  To: Lars Ingebrigtsen, Stefan Kangas; +Cc: 52880@debbugs.gnu.org

> 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.





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over creating menu by hand
  2021-12-29 21:33 ` Lars Ingebrigtsen
  2021-12-29 21:57   ` bug#52880: [External] : " Drew Adams
@ 2021-12-29 22:43   ` Stefan Kangas
  2021-12-30 14:43     ` Lars Ingebrigtsen
  1 sibling, 1 reply; 6+ messages in thread
From: Stefan Kangas @ 2021-12-29 22:43 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 52880

Lars Ingebrigtsen <larsi@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.





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over creating menu by hand
  2021-12-29 22:43   ` Stefan Kangas
@ 2021-12-30 14:43     ` Lars Ingebrigtsen
  0 siblings, 0 replies; 6+ messages in thread
From: Lars Ingebrigtsen @ 2021-12-30 14:43 UTC (permalink / raw)
  To: Stefan Kangas; +Cc: 52880

Stefan Kangas <stefan@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





^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2021-12-30 14:43 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-12-29 21:08 bug#52880: "(elisp) Menu Keymaps") - recommend easy-menu over creating menu by hand Stefan Kangas
2021-12-29 21:33 ` Lars Ingebrigtsen
2021-12-29 21:57   ` bug#52880: [External] : " Drew Adams
2021-12-29 22:43   ` Stefan Kangas
2021-12-30 14:43     ` Lars Ingebrigtsen
2021-12-29 21:57 ` bug#52880: [External] : " Drew Adams

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).