[Emacs-diffs] emacs-25 30989a0: Mention GTK+ problems in etc/PROBLEMS

[Eli Zaretskii]

branch: emacs-25
commit 30989a0ae1923b4466cf4902a5ac009fc1d2fdad
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Mention GTK+ problems in etc/PROBLEMS
    
    * etc/PROBLEMS (GDK_SCALE, GDK_DPI_SCALE): Mention the possible
    problems this could create and the workaround.  (Bug#23587)
---
 etc/PROBLEMS |   15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index 8733095..31f38e3 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -940,6 +940,21 @@ into Meta.  This is because of the great importance of 
Meta in Emacs.
 
 ** Window-manager and toolkit-related problems
 
+*** 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
+'.xinitrc' file.  (This setting is usually accompanied by
+GDK_DPI_SCALE=0.5.)  Emacs can not support these settings correctly,
+as it doesn't use GTK+ exclusively.  The result is that sometimes
+widgets like the scroll bar are displayed incorrectly, and frames
+could be displayed "cropped" to only part of the stuff that should be
+displayed.
+
+The workaround is to explicitly disable these settings when invoking
+Emacs, for example (from a Posix shell prompt):
+
+  $ GDK_SCALE=1 GDK_DPI_SCALE=1 emacs
+
 *** Metacity: Resizing Emacs or ALT-Tab causes X to be unresponsive.
 
 This happens sometimes when using Metacity.  Resizing Emacs or ALT-Tab:bing