From 5ef5a15c9f941e4810329b17fee1b046c2f89a78 Mon Sep 17 00:00:00 2001
From: Consolatis <35009135+Consolatis@users.noreply.github.com>
Date: Tue, 23 Dec 2025 11:57:02 +0100
Subject: [PATCH] FAQ: add gtk4 compose section

---
 src/faq.md         | 9 +++++++++
 src/integration.md | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/faq.md b/src/faq.md
index 126bb42..48e26c1 100644
--- a/src/faq.md
+++ b/src/faq.md
@@ -21,6 +21,7 @@
     2. [Laptop Lid](#laptop-lid)
 9. [Applications](#applications)
     1. [gparted](#gparted)
+    2. [GTK4](#gtk4)
 
 # 1. Keybinds {#keybinds}
 
@@ -351,3 +352,11 @@ started labwc (not root) to fix this.
 If `xauth` and/or `xhost` are not installed, it is possible to run with
 `sudo -E gparted`.
 
+## 9.2 [GTK4]{#gtk4}
+
+### Q: My compose key stopped working
+
+This is due to a change in GTK4 which now requires input methods for compose.
+Either install a input method like ibus or fcitx5 or force GTK4 to use its
+built-in compose method by adding `GTK_IM_MODULE=simple` to
+`~/.config/labwc/environment`.
diff --git a/src/integration.md b/src/integration.md
index 2385840..22ab27c 100644
--- a/src/integration.md
+++ b/src/integration.md
@@ -380,7 +380,8 @@ depending on your system setup. There are at least two ways to fallback to a
 ## 12.2 Compose
 
 From version `4.20.0`, compose keys (e.g. typing "à" with "\`" + "a" in
-US-intl layout) do not work in GTK4 applications without using
+US-intl layout) do not work in GTK4 applications without manual configuration
+(`GTK_IM_MODULE=simple` in `~/.config/labwc/environment`) or using
 [input methods](#input-method) like Fcitx5 and IBus. See [#3068] for details.
 
 [#3068]: https://github.com/labwc/labwc/issues/3068