bug#7684: 24.0.50; doc of `x-popup-menu'

[Drew Adams]

Both the doc string and node `Pop-Up Menus' of the Elisp manual omit
mentioning this fact, which should be documented:
 
If you use a list of menu keymaps as the value of MENU, then the title
string (so-called "overall prompt string") of the first keymap is used
as the menu title.
 
Example:
 
(defun foo (event)
  (interactive "e")
  (x-popup-menu event `((keymap "Title"
                                (help "Help" ,@menu-bar-help-menu))
                        (keymap "Ignored"
                                (edit "Edit" ,@menu-bar-edit-menu)))))
 
(global-set-key [mouse-3] 'foo)
 
Click mouse-3.  The menu title is "Title", which is the title string for
the first keymap.  The title strings of any other keymaps
(e.g. "Ignored") are ignored.  This should be stated in the doc.
 

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2010-12-13 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4) --no-opt --cflags
-Ic:/imagesupport/include'