Document workaround for bug#56627

* etc/PROBLEMS: Document problems with GTK tool bar icons on
some icon themes.  (bug#56627)

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index 924e1effa71d20f70d6e341cc0085727d9821010..56b5362611ea7a8bd71212c40e45a7222b8388b6 100644 (file)
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -1365,6 +1365,17 @@ command:
 
 ** Window-manager and toolkit-related problems
 
+*** Emacs built with GTK+ displays giant tool bar icons in some cases
+
+This is because some icon themes (such as the KDE Breeze icon theme)
+have several incorrectly sized icons, which also causes the toolbar to
+expand uncontrollably.  The fix is to switch to a different icon
+theme, or to use Emacs's own toolbar icons by placing:
+
+  (setq x-gtk-stock-map nil)
+
+in your early-init.el.
+
 *** Emacs built with GTK+ toolkit produces corrupted display on HiDPI screen
 
 This can happen if you set GDK_SCALE=2 in the environment or in your
@@ -3137,6 +3148,17 @@ file; for example:
 
 * Runtime problems specific to PGTK
 
+** Giant tool bar icons are displayed in some cases
+
+This is because some icon themes (such as the KDE Breeze icon theme)
+have several incorrectly sized icons, which also causes the toolbar to
+expand uncontrollably.  The fix is to switch to a different icon
+theme, or to use Emacs's own toolbar icons by placing:
+
+  (setq x-gtk-stock-map nil)
+
+in your early-init.el.
+
 ** Some modifier keys doesn't work if Emacs is started in a systemd unit file.
 
 Environment variables may be different if there is a difference in the