summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNoam Postavsky <npostavs@gmail.com>2017-01-07 09:26:08 -0500
committerNoam Postavsky <npostavs@gmail.com>2017-01-12 10:18:56 -0500
commitb0ade0df21d4cde8537c29f81eb10bdcf1cdfbfc (patch)
tree6558497c24c9faf7131ceae239d505185cf3478b
parent3c69f2c5bb1ec7775b0ac1b18550affbc249586a (diff)
downloademacs-b0ade0df21d4cde8537c29f81eb10bdcf1cdfbfc.tar.gz
Clarify that easy-menu-add is a nop (Bug#25382)
* lisp/emacs-lisp/easymenu.el (easy-menu-add): Make it into an alias of `ignore', like `easy-menu-remove'.
-rw-r--r--lisp/emacs-lisp/easymenu.el15
1 files changed, 8 insertions, 7 deletions
diff --git a/lisp/emacs-lisp/easymenu.el b/lisp/emacs-lisp/easymenu.el
index 603bbcd9426..4fc9a783a5e 100644
--- a/lisp/emacs-lisp/easymenu.el
+++ b/lisp/emacs-lisp/easymenu.el
@@ -489,7 +489,7 @@ To implement dynamic menus, either call this from
;; XEmacs needs the following two functions to add and remove menus.
;; In Emacs this is done automatically when switching keymaps, so
-;; here easy-menu-remove is a noop.
+;; here easy-menu-remove and easy-menu-add are a noops.
(defalias 'easy-menu-remove 'ignore
"Remove MENU from the current menu bar.
Contrary to XEmacs, this is a nop on Emacs since menus are automatically
@@ -497,15 +497,16 @@ Contrary to XEmacs, this is a nop on Emacs since menus are automatically
\(fn MENU)")
-(defun easy-menu-add (_menu &optional _map)
+(defalias 'easy-menu-add #'ignore
"Add the menu to the menubar.
-On Emacs, menus are already automatically activated when the
-corresponding keymap is activated. On XEmacs this is needed to
-actually add the menu to the current menubar.
+On Emacs this is a nop, because menus are already automatically
+activated when the corresponding keymap is activated. On XEmacs
+this is needed to actually add the menu to the current menubar.
You should call this once the menu and keybindings are set up
-completely and menu filter functions can be expected to work."
- )
+completely and menu filter functions can be expected to work.
+
+\(fn MENU &optional MAP)")
(defun add-submenu (menu-path submenu &optional before in-menu)
"Add submenu SUBMENU in the menu at MENU-PATH.