; Describe xt-mouse problems with Evil mode

* etc/PROBLEMS: Describe a workaround for xt-mouse problems with
Evil mode.  (Bug#29143)

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index a67771d474db4f181a537ea90c5e94fc1aa4e15f..bb699af9df5c39b1ca305bd24eb92da3220c80c4 100644 (file)
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -1466,6 +1466,18 @@ this, you can remove the X resource or put this in your init file:
 
   (xterm-remove-modify-other-keys)
 
+** Emacs's xterm-mouse doesn't work well in Evil mode.
+
+Specifically, clicking mouse-1 doesn't work as expected: instead of
+moving point where you click, it highlights the region between the
+line beginning and the click location, and displays error messages
+about unbound keys in the echo area.
+
+To work around this, put this in your .emacs file:
+
+  (with-eval-after-load 'evil-maps
+    (define-key evil-motion-state-map [down-mouse-1] nil))
+
 ** Emacs spontaneously displays "I-search: " at the bottom of the screen.
 
 This means that Control-S/Control-Q (XON/XOFF) "flow control" is being