From: Po Lu <luangruo@yahoo.com>
Date: Thu, 10 Aug 2023 07:31:03 +0000 (+0800)
Subject: Document that `set-mouse-color' does not work everywhere
X-Git-Tag: emacs-29.1.90~230
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=5a7fb0b39b7059e6ff3c9a9e7641c80cf3a48459;p=emacs.git

Document that `set-mouse-color' does not work everywhere

* etc/PROBLEMS (Miscellaneous Problems): Mention where
`set-mouse-color' does not work.
---

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