From: Po Lu <luangruo@yahoo.com>
Date: Fri, 27 May 2022 06:38:44 +0000 (+0800)
Subject: * etc/PROBLEMS: Document problems with PGTK input methods.
X-Git-Tag: emacs-29.0.90~1910^2~399
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=34e4eba07ed491d3c01902023df6f15c968117cf;p=emacs.git

* etc/PROBLEMS: Document problems with PGTK input methods.
---

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index 4224171298e..018efcf3024 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -3025,6 +3025,23 @@ GTK_IM_MODULE.
 GTK does not allow programs to warp the pointer anymore.  There is
 nothing that can be done about this problem.
 
+** Certain keys such as 'C-S-u' are not reported correctly.
+
+Some keys with modifiers such as Shift and Control might not be
+reported correctly due to incorrectly written GTK input method
+modules.  This is known to happen to 'C-S-u' and 'C->', which are
+misreported as 'C-u' and '>'.
+
+To disable the use of GTK input methods, evaluate:
+
+  (pgtk-use-im-context nil)
+
+This will also cause system input methods and features such as the
+Compose key to stop working.
+
+On X Windows, users should not use Emacs configured with PGTK, since
+this and many other problems do not exist on the regular X builds.
+
 * Build-time problems
 
 ** Configuration