master 20da50619f: * etc/PROBLEMS: Document some limitations of Xwayland and PGTK.

[Po Lu]

branch: master
commit 20da50619fd5b65e6d0c18c48d10ab1ec9067b63
Author: Po Lu <luangruo@yahoo.com>
Commit: Po Lu <luangruo@yahoo.com>

    * etc/PROBLEMS: Document some limitations of Xwayland and PGTK.
---
 etc/PROBLEMS | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index 7c8c364c56..4e4ec6d353 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