From 5a7fb0b39b7059e6ff3c9a9e7641c80cf3a48459 Mon Sep 17 00:00:00 2001
From: Po Lu <luangruo@yahoo.com>
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.5