; * etc/PROBLEMS: Document problem with GPM mouse display (bug#74220).

(cherry picked from commit d78a4c0f4cb534dd5b1dc8cfe91f34b6d2c996d3)

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index ee72a04f493c327aec92f24043bc2df851851226..e0683bc2f5bf0b6ee6ed30a00359729c6c0c079c 100644 (file)
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -2815,6 +2815,19 @@ set the 'visible-cursor' variable to nil in your ~/.emacs:
 Still other way is to change the "cvvis" capability to send the
 "\E[?25h\E[?0c" command.
 
+*** GNU/Linux: GPM mouse does not display but still otherwise works.
+
+This happens on Linux kernel versions from 6.7 to 6.13.  On these
+versions, the Linux kernel does not allow programs to draw the mouse
+pointer unless they have superuser permissions.  The GPM daemon
+normally has such permissions and it draws the mouse pointer for other
+programs such as your shell and many ncurses based programs, but not
+for Emacs.
+
+To solve this, you need to change your kernel to a version with this bug
+fixed, such as 6.14.  See associated Linux kernel fix:
+https://lore.kernel.org/regressions/20250110142122.1013222-1-gnoack@google.com/
+
 ** FreeBSD
 
 *** FreeBSD: Getting a Meta key on the console.