From 5a7fb0b39b7059e6ff3c9a9e7641c80cf3a48459 Mon Sep 17 00:00:00 2001 From: Po Lu Date: Thu, 10 Aug 2023 15:31:03 +0800 Subject: [PATCH] Document that `set-mouse-color' does not work everywhere * etc/PROBLEMS (Miscellaneous Problems): Mention where `set-mouse-color' does not work. --- etc/PROBLEMS | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/etc/PROBLEMS b/etc/PROBLEMS index 4c75cfc62b6..a2d3d687998 100644 --- a/etc/PROBLEMS +++ b/etc/PROBLEMS @@ -575,6 +575,20 @@ This can happen with CVS versions 1.12.8 and 1.12.9. Upgrade to CVS ** Miscellaneous problems +*** 'set-mouse-color' and the '-ms' command line argument do not work. + +Systems where the default cursors are not simple 1 bit-per-pixel +bitmaps usually forbid recoloring the cursor, since it is unclear +which colors should replace those already present within each cursor +image. For example, 'set-mouse-color' and '-ms' have no function on X +systems with GNOME, KDE, and other recent desktop environments +employing cursor images containing colors and partial transparency. + +Changing the cursor color is also impossible on MS-Windows and PGTK +systems. In the former case, it is because the prerequisite code has +yet to be written. In the latter, it is because GTK does not provide +for changing the color of cursor images. + *** Display artifacts on GUI frames on X-based systems. This is known to be caused by using double-buffering (which is enabled -- 2.39.2