From: Po Lu <luangruo@yahoo.com>
Date: Fri, 11 Feb 2022 06:46:25 +0000 (+0800)
Subject: * etc/PROBLEMS: Document some limitations of Xwayland and PGTK.
X-Git-Tag: emacs-29.0.90~2375
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=20da50619fd5b65e6d0c18c48d10ab1ec9067b63;p=emacs.git

* etc/PROBLEMS: Document some limitations of Xwayland and PGTK.
---

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index 7c8c364c566..4e4ec6d353d 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -1768,7 +1768,16 @@ If setting GDK_DEBUG causes GTK to complain about not being built with
 support for debugging options, then there is nothing you can do,
 except switch to a free X server.
 
-* Runtime problems on character terminals
+*** 'set-mouse-position' does not move the pointer on Xwayland.
+
+This is because Wayland does not allow programs to warp the pointer.
+There is nothing that can be done about this problem, except to switch
+to an X session.
+
+Some versions of the Xwayland server will pretend to warp the pointer,
+so mouse-motion events might be sent to the position the mouse was
+supposed to have moved to, even though the cursor displays at the same
+on-screen position.
 
 *** With X forwarding, mouse highlighting can make Emacs slow.
 
@@ -1777,6 +1786,8 @@ remote X server, try this:
 
     (setq mouse-highlight nil)
 
+* Runtime problems on character terminals
+
 ** The meta key does not work on xterm.
 
 Typing M-x rings the terminal bell, and inserts a string like ";120~".
@@ -2896,6 +2907,11 @@ when started from the command line.
 Especially, PGTK Emacs needs environment variables LANG and
 GTK_IM_MODULE.
 
+** 'set-mouse-position' does nothing.
+
+GTK does not allow programs to warp the pointer anymore.  There is
+nothing that can be done about this problem.
+
 * Build-time problems
 
 ** Configuration