master 393a3eef26: Document workaround for bug#56627

[Po Lu]

branch: master
commit 393a3eef260479f83d162c8550ee179ee0faf923
Author: Po Lu <luangruo@yahoo.com>
Commit: Po Lu <luangruo@yahoo.com>

    Document workaround for bug#56627
    
    * etc/PROBLEMS: Document problems with GTK tool bar icons on
    some icon themes.  (bug#56627)
---
 etc/PROBLEMS | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index 924e1effa7..56b5362611 100644
--- 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