Re: `xterm-mouse-mode' has a bogus Custom group

[Luc Teirlinck]

Nick Roberts wrote:

   Its a bit more quirky than that, mouse-save-then-kill doesn't kill
   text if you click with mouse-3 twice (this is not a
   double-click). Also xterm mouse functionality is still available
   for double/triple mouse clicks by holding down the SHIFT key while
   pressing the mouse button. Maybe the previous documentation was
   deliberately vague for that reason.

The situation is obviously so messy that going for 100 percent
accurate documentation seems hopeless.  I include patches below whose
main difference docwise is that they include the word basically to
indicate that no 100 percent accuracy is claimed: "Basically, only
non-modified single clicks are supported."

The new patch for xt-mouse includes a more fundamental non-doc change,
which I could, of course, easily leave out if it would be deemed
undesirable: get rid of the "Mouse" which appears in the mode line if
the mode is activated.

The way I understand it, if you want Emacs to handle simple mouse
clicks while running in an xterm, you can simply enable the mode
unconditionally.  While you are using a window system, the mode does
nothing anyway.  Except for putting the confusing "Mouse" in the mode
line.  Also, this is the kind of thing you either enable permanently
or not at all.  It does not seem to be the kind of stuff that you
dis/enable all the time.  Hence, even while running Emacs in an xterm,
the "Mouse" just seems too waste precious space in the mode line.

===File ~/xt-mouse-diff-b===================================
*** xt-mouse.el 03 Apr 2005 19:34:53 -0500      1.25
--- xt-mouse.el 06 Apr 2005 14:47:20 -0500      
***************
*** 156,165 ****
  With prefix arg, turn XTerm mouse mode on iff arg is positive.
  
  Turn it on to use Emacs mouse commands, and off to use xterm mouse commands.
! This works in terminal emulators compatible with xterm.  Only single clicks
! are supported.  When turned on, the normal xterm mouse functionality is still
! available by holding down the SHIFT key while pressing the mouse button."
!   nil " Mouse" nil :global t :group 'mouse
    (if xterm-mouse-mode
        ;; Turn it on
        (unless window-system
--- 156,167 ----
  With prefix arg, turn XTerm mouse mode on iff arg is positive.
  
  Turn it on to use Emacs mouse commands, and off to use xterm mouse commands.
! This works in terminal emulators compatible with xterm.  It only
! works for simple uses of the mouse.  Basically, only non-modified
! single clicks are supported.  When turned on, the normal xterm
! mouse functionality for such clicks is still available by holding
! down the SHIFT key while pressing the mouse button."
!   :global t :group 'mouse
    (if xterm-mouse-mode
        ;; Turn it on
        (unless window-system
============================================================

===File ~/man-frames.texi-diff-b============================
*** frames.texi 04 Apr 2005 16:06:35 -0500      1.77
--- frames.texi 06 Apr 2005 14:33:02 -0500      
***************
*** 1056,1064 ****
  Some terminal emulators under X support mouse clicks in the terminal
  window.  In a terminal emulator which is compatible with @code{xterm},
  you can use @kbd{M-x xterm-mouse-mode} to enable simple use of the
! mouse---only single clicks are supported.  The normal @code{xterm} mouse
! functionality is still available by holding down the @kbd{SHIFT} key
! when you press the mouse button.
  
  @ignore
     arch-tag: 7dcf3a31-a43b-45d4-a900-445b10d77e49
--- 1056,1064 ----
  Some terminal emulators under X support mouse clicks in the terminal
  window.  In a terminal emulator which is compatible with @code{xterm},
  you can use @kbd{M-x xterm-mouse-mode} to enable simple use of the
! mouse---basically, only non-modified single clicks are supported.  The normal
! @code{xterm} mouse functionality for such clicks is still available by
! holding down the @kbd{SHIFT} key when you press the mouse button.
  
  @ignore
     arch-tag: 7dcf3a31-a43b-45d4-a900-445b10d77e49
============================================================