shortcutmanager: Add some more docs

diff --git a/gtk/gtkshortcutmanager.c b/gtk/gtkshortcutmanager.c
index 71a1b35eb12ead8553b72a48d8f1b99ecb2e2413..c6530c0efe968c93fd84e9519e86e2e2a5936103 100644 (file)
--- a/gtk/gtkshortcutmanager.c
+++ b/gtk/gtkshortcutmanager.c
@@ -30,6 +30,13 @@
  *
  * The GtkShortcutManager interface is used to implement
  * shortcut scopes.
+ *
+ * This is important for #GtkNative widgets that have their own surface,
+ * since the event controllers that are used to implement managed and
+ * global scopes are limited to the same native.
+ *
+ * Examples for widgets implementing #GtkShortcutManager are #GtkWindow
+ * and #GtkPopover.
  */
 
 G_DEFINE_INTERFACE (GtkShortcutManager, gtk_shortcut_manager, G_TYPE_OBJECT)