bug#7466: 24.0.50; (emacs) `Menu Mouse Clicks' conflicts with code obsolescence

[Stefan Monnier]

>> The footnote on this manual page tells you how to put the mouse-3 menu
>> on mouse-3 instead of on C-mouse-3 (the default).  It tells you to bind
>> `mouse-popup-menubar-stuff'.
>> 
>> But in mouse.el, that function (as well as the other mouse-3 menu
>> functions) has been declared obsolete since 23.1.
>> 
>> There is no comment in the code indicating what now replaces these
>> functions - what to use instead.

C-h f mouse-major-mode-menu RET tells me

   This function is obsolete since 23.1;
   use `mouse-menu-major-mode-map' instead.

So for me it does say what replaces it.

> Good question.  I see from bzr that Juanma marked the function as
> obsolete.  Do you know what this is all about?

It's mostly about what C-h k returns:

Before my patch "C-h k mouse-3" returns "mouse-3 runs mouse-major-mode-menu"
whereas after my patch it pops up the menu, lets you choose an entry from
it and then gives you the name and docstring of the function
corresponding to the entry you selected.


        Stefan