# HG changeset patch
# User David Kastrup <dak@gnu.org>
# Date 1116603059 0
# Node ID efeaec0ce9c4a5504a01818330ebb3edc3d50625
# Parent  ff0c29a49703153880a8271154f6e8ff07cc83a1
(easy-menu-add): Correct docstring since
easy-menu-add is not a nop on Emacs; and clarify when to call it.

diff -r ff0c29a49703 -r efeaec0ce9c4 lisp/ChangeLog
--- a/lisp/ChangeLog	Fri May 20 14:30:34 2005 +0000
+++ b/lisp/ChangeLog	Fri May 20 15:30:59 2005 +0000
@@ -1,3 +1,8 @@
+2005-05-20  David Kastrup  <dak@gnu.org>
+
+	* emacs-lisp/easymenu.el (easy-menu-add): Correct docstring since
+	easy-menu-add is not a nop on Emacs; and clarify when to call it.
+
 2005-05-20  Carsten Dominik  <dominik@science.uva.nl>
 
 	* textmodes/org.el (org-agenda-toggle-time-grid): New command.
diff -r ff0c29a49703 -r efeaec0ce9c4 lisp/emacs-lisp/easymenu.el
--- a/lisp/emacs-lisp/easymenu.el	Fri May 20 14:30:34 2005 +0000
+++ b/lisp/emacs-lisp/easymenu.el	Fri May 20 15:30:59 2005 +0000
@@ -471,11 +471,15 @@
 
 (defun easy-menu-add (menu &optional map)
   "Add the menu to the menubar.
-This is a nop on Emacs since menus are automatically activated when the
-corresponding keymap is activated.  On XEmacs this is needed to actually
-add the menu to the current menubar.
-Maybe precalculate equivalent key bindings.
-Do it only if `easy-menu-precalculate-equivalent-keybindings' is on."
+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.
+
+This also precalculates equivalent key bindings when
+`easy-menu-precalculate-equivalent-keybindings' is on.
+
+You should call this once the menu and keybindings are set up
+completely and menu filter functions can be expected to work."
   (when easy-menu-precalculate-equivalent-keybindings
     (if (and (symbolp menu) (not (keymapp menu)) (boundp menu))
 	(setq menu (symbol-value menu)))