From: Jan Tojnar <jtojnar@gmail.com>
Date: Thu, 20 Oct 2022 14:19:13 +0000 (+0200)
Subject: imcontextsimple: Document that Compose file support is incomplete
X-Git-Tag: archive/raspbian/4.12.3+ds-1+rpi1~1^2^2^2~22^2~9^2~151^2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=cf701d5db44ed7c1a532b1106816da7ab1078fa1;p=gtk4.git

imcontextsimple: Document that Compose file support is incomplete

And that `include "%L"` does something different as introduced in
https://gitlab.gnome.org/GNOME/gtk/-/commit/3b4b1c68781aad61fc6b91c9dff75b5790b4d8e4

Note that user can still use `include "/.%L"` as a workaround.
---

diff --git a/gtk/gtkimcontextsimple.c b/gtk/gtkimcontextsimple.c
index bd492402ad..c9ff583614 100644
--- a/gtk/gtkimcontextsimple.c
+++ b/gtk/gtkimcontextsimple.c
@@ -46,8 +46,9 @@
  * `GtkIMContextSimple` reads compose sequences from the first of the
  * following files that is found: ~/.config/gtk-4.0/Compose, ~/.XCompose,
  * /usr/share/X11/locale/$locale/Compose (for locales that have a nontrivial
- * Compose file). The syntax of these files is described in the Compose(5)
- * manual page.
+ * Compose file). A subset of the file syntax described in the Compose(5)
+ * manual page is supported. Additionally, `include "%L"` loads GTK’s built-in
+ * table of compose sequences rather than the locale-specific one from X11.
  *
  * If none of these files is found, `GtkIMContextSimple` uses a built-in table
  * of compose sequences that is derived from the X11 Compose files.