From: Po Lu <luangruo@yahoo.com>
Date: Sun, 7 Aug 2022 05:49:59 +0000 (+0800)
Subject: * etc/PROBLEMS: Document window manager focus problems.
X-Git-Tag: emacs-29.0.90~1616^2~526
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=e0616f2d3cbc559560bf15346dd8a1824603bd80;p=emacs.git

* etc/PROBLEMS: Document window manager focus problems.
---

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index ed2bc1ae051..aaecc41f6e8 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -1229,6 +1229,17 @@ you should use an Emacs input method instead.
 
 ** X keyboard problems
 
+*** `x-focus-frame' fails to activate the frame.
+
+Some window managers prevent `x-focus-frame' from activating the given
+frame when Emacs is in the background.
+
+Emacs tries to work around this problem by default, but the workaround
+does not work on all window managers.  You can try different
+workarounds by changing the value of `x-allow-focus-stealing' (see its
+doc string for more details).  The value `imitate-pager' may be
+required on some versions of KWin.
+
 *** You "lose characters" after typing Compose Character key.
 
 This is because the Compose Character key is defined as the keysym