keybindings: Add meta_display_add_custom_keybinding_full().

This provides an additional argument to specify MetaKeybindingFlags.
With it we can limit auto-repeat to specific keybindings.

Fix some related gtkdoc issues also.

Author: mtwebster

debian/libmuffin0.symbols

@@ -2129,6 +2129,7 @@ libmuffin.so.0 libmuffin0 #MINVER#
  meta_direction_get_type@Base 5.3.0
  meta_disable_unredirect_for_display@Base 5.3.0
  meta_display_add_custom_keybinding@Base 5.3.0
+ meta_display_add_custom_keybinding_full@Base 6.8.0
  meta_display_add_ignored_crossing_serial@Base 5.3.0
  meta_display_add_keybinding@Base 5.3.0
  meta_display_begin_grab_op@Base 5.3.0

src/core/keybindings.c

@@ -1061,8 +1061,8 @@ meta_display_add_keybinding (MetaDisplay         *display,
  *
  * Use meta_display_remove_custom_keybinding() to remove the binding.
  *
- * Returns: %TRUE if the keybinding was added successfully,
- *          otherwise %FALSE
+ * Returns: the corresponding keybinding action if the keybinding was
+ *          added successfully, otherwise %META_KEYBINDING_ACTION_NONE
  */
 guint
 meta_display_add_custom_keybinding (MetaDisplay         *display,
@@ -1081,6 +1081,42 @@ meta_display_add_custom_keybinding (MetaDisplay         *display,
   return new_action;
 }
 
+/**
+ * meta_display_add_custom_keybinding_full:
+ * @display: a #MetaDisplay
+ * @name: the binding's unique name
+ * @bindings: (allow-none) (array zero-terminated=1): array of parseable keystrokes
+ * @flags: a #MetaKeyBindingFlags
+ * @callback: function to run when the keybinding is invoked
+ * @user_data: the data to pass to @handler
+ * @free_data: function to free @user_data
+ *
+ * Like meta_display_add_custom_keybinding(), but accepts
+ * #MetaKeyBindingFlags to control the binding behavior.
+ *
+ * Use meta_display_remove_custom_keybinding() to remove the binding.
+ *
+ * Returns: the corresponding keybinding action if the keybinding was
+ *          added successfully, otherwise %META_KEYBINDING_ACTION_NONE
+ */
+guint
+meta_display_add_custom_keybinding_full (MetaDisplay         *display,
+                                         const char          *name,
+                                         const char         **bindings,
+                                         MetaKeyBindingFlags  flags,
+                                         MetaKeyHandlerFunc   handler,
+                                         gpointer             user_data,
+                                         GDestroyNotify       free_data)
+{
+  guint new_action = next_dynamic_keybinding_action ();
+
+  if (!add_keybinding_internal (display, name, NULL, bindings, flags, new_action,
+                                handler, 0, user_data, free_data))
+    return META_KEYBINDING_ACTION_NONE;
+
+  return new_action;
+}
+
 /**
  * meta_display_remove_keybinding:
  * @display: the #MetaDisplay

src/meta/display.h

@@ -174,6 +174,15 @@ guint meta_display_add_custom_keybinding    (MetaDisplay         *display,
                                                 gpointer             user_data,
                                                 GDestroyNotify       free_data);
 
+META_EXPORT
+guint meta_display_add_custom_keybinding_full (MetaDisplay         *display,
+                                                  const char          *name,
+                                                  const char         **bindings,
+                                                  MetaKeyBindingFlags  flags,
+                                                  MetaKeyHandlerFunc   callback,
+                                                  gpointer             user_data,
+                                                  GDestroyNotify       free_data);
+
 META_EXPORT
 gboolean meta_display_remove_keybinding (MetaDisplay         *display,
                                          const char          *name);

src/meta/prefs.h

@@ -495,6 +495,7 @@ typedef enum _MetaKeyBindingAction
  * @META_KEY_BINDING_BUILTIN: built-in
  * @META_KEY_BINDING_IS_REVERSED: is reversed
  * @META_KEY_BINDING_NON_MASKABLE: always active
+ * @META_KEY_BINDING_IGNORE_AUTOREPEAT: do not repeat if held down
  * @META_KEY_BINDING_NO_AUTO_GRAB: not grabbed automatically
  */
 typedef enum