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

["Drew Adams" <drew.adams@oracle.com>]

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

Still true, in the latest Windows build:

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-07-11 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt --cflags
-Ic:/build/include'

Likewise, this is still true:

> And I find nothing in NEWS or NEWS.23 (or NEWS.22) about
> "mouse-3" or "popup".  Grepping the Lisp sources didn't help either.

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

It does not tell you "how to put the mouse-3 menu on mouse-3 instead of on
C-mouse-3".  It is not specific wrt doing what that now-obsolete variable did.
Likewise, wrt doing what the other mouse-3 menu functions (also made obsolete)
did.

Several things have been declared obsolete, and there is not even a comment in
the code indicating what to do in their stead.  And nothing in NEWS.  And the
doc still refers to what is obsolete - "since 23.1", as you point out.