summaryrefslogtreecommitdiff
path: root/gtk/gtkshortcuttrigger.h
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2021-03-01 01:51:18 -0500
committerEmmanuele Bassi <ebassi@gnome.org>2021-03-11 16:37:37 +0000
commiteb675e3e7e5be3551ebb6b09e3fece3e2649f4e2 (patch)
tree2d0429b04b6c0b20a51ea52e63fc761dc7292a72 /gtk/gtkshortcuttrigger.h
parent3f201aeb217001dbb42f3c28f2816ea9acd4b634 (diff)
downloadgtk+-eb675e3e7e5be3551ebb6b09e3fece3e2649f4e2.tar.gz
shortcuttrigger: Tweak docs
Diffstat (limited to 'gtk/gtkshortcuttrigger.h')
-rw-r--r--gtk/gtkshortcuttrigger.h18
1 files changed, 11 insertions, 7 deletions
diff --git a/gtk/gtkshortcuttrigger.h b/gtk/gtkshortcuttrigger.h
index eeda11939e..8fae538f29 100644
--- a/gtk/gtkshortcuttrigger.h
+++ b/gtk/gtkshortcuttrigger.h
@@ -75,7 +75,7 @@ GdkKeyMatch gtk_shortcut_trigger_trigger (GtkShortcutTrig
/**
* GtkNeverTrigger:
*
- * A #GtkShortcutTrigger that never triggers.
+ * A `GtkShortcutTrigger` that never triggers.
*/
GDK_AVAILABLE_IN_ALL
GDK_DECLARE_INTERNAL_TYPE (GtkNeverTrigger, gtk_never_trigger, GTK, NEVER_TRIGGER, GtkShortcutTrigger)
@@ -88,8 +88,7 @@ GtkShortcutTrigger * gtk_never_trigger_get (void);
/**
* GtkKeyvalTrigger:
*
- * A #GtkShortcutTrigger that triggers when a specific keyval
- * and (optionally) modifiers are pressed.
+ * A `GtkShortcutTrigger` that triggers when a specific keyval and modifiers are pressed.
*/
GDK_AVAILABLE_IN_ALL
@@ -108,8 +107,10 @@ guint gtk_keyval_trigger_get_keyval (GtkKeyvalTrigge
/**
* GtkMnemonicTrigger:
*
- * A #GtkShortcutTrigger that triggers when a specific mnemonic
- * is pressed.
+ * A `GtkShortcutTrigger` that triggers when a specific mnemonic is pressed.
+ *
+ * Mnemonics require a *mnemonic modifier* (typically <kbd>Alt</kbd>) to be
+ * pressed together with the mnemonic key.
*/
GDK_AVAILABLE_IN_ALL
GDK_DECLARE_INTERNAL_TYPE (GtkMnemonicTrigger, gtk_mnemonic_trigger, GTK, MNEMONIC_TRIGGER, GtkShortcutTrigger)
@@ -124,8 +125,11 @@ guint gtk_mnemonic_trigger_get_keyval (GtkMnemonicTrig
/**
* GtkAlternativeTrigger:
*
- * A #GtkShortcutTrigger that triggers when either of two
- * #GtkShortcutTriggers trigger.
+ * A `GtkShortcutTrigger` that combines two triggers.
+ *
+ * The `GtkAlternativeTrigger` triggers when either of two trigger.
+ *
+ * This can be cascaded to combine more than two triggers.
*/
GDK_AVAILABLE_IN_ALL