[gtk/wip/compose-parser: 15/15] imcontext: Improve the docs

[Matthias Clasen <matthiasc src gnome org>]

commit 4390f8102bb40a351cec1f6065e369a87ed7a09d
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue Jul 13 07:10:01 2021 -0400

    imcontext: Improve the docs
    
    Add more details about supported input methods.

 gtk/gtkimcontextsimple.c | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
---
diff --git a/gtk/gtkimcontextsimple.c b/gtk/gtkimcontextsimple.c
index 68253797d9..7183205646 100644
--- a/gtk/gtkimcontextsimple.c
+++ b/gtk/gtkimcontextsimple.c
@@ -40,6 +40,8 @@
  *
  * `GtkIMContextSimple` is an input method supporting table-based input methods.
  *
+ * ## Compose sequences
+ *
  * `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
@@ -49,6 +51,10 @@
  * If none of these files is found, `GtkIMContextSimple` uses a built-in table
  * of compose sequences that is derived from the X11 Compose files.
  *
+ * Note that compose sequences typically start with the Compose_key, which is
+ * often not available as a dedicated key on keyboards. Keyboard layouts may
+ * map this keysym to other keys, such as the right Control key.
+ *
  * ## Unicode characters
  *
  * `GtkIMContextSimple` also supports numeric entry of Unicode characters
@@ -60,6 +66,15 @@
  *     Ctrl-Shift-u 1 2 3 Enter
  *
  * yields U+0123 LATIN SMALL LETTER G WITH CEDILLA, i.e. ģ.
+ *
+ * ## Dead keys
+ *
+ * `GtkIMContextSimple` supports dead keys. For example, typing
+ *
+ *     dead_acute a
+ *
+ *  yields U+00E! LATIN SMALL LETTER_A WITH ACUTE, i.e. á. Note that this
+ *  depends on the keyboard layout including dead keys.
  */
 
 struct _GtkIMContextSimplePrivate