[tepl] Amtk utils: clearer parameter name for bind_g_action_to_gtk_action()

[Sébastien Wilmet <swilmet src gnome org>]

commit 35050d073b6f97753d64bb443fe23af26ac66c9b
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Wed Nov 29 15:33:37 2017 +0100

    Amtk utils: clearer parameter name for bind_g_action_to_gtk_action()

 amtk/amtk-utils.c |   22 ++++++++++++----------
 amtk/amtk-utils.h |    2 +-
 2 files changed, 13 insertions(+), 11 deletions(-)
---
diff --git a/amtk/amtk-utils.c b/amtk/amtk-utils.c
index 8947687..0e97091 100644
--- a/amtk/amtk-utils.c
+++ b/amtk/amtk-utils.c
@@ -213,8 +213,8 @@ gtk_action_activate_cb (GtkAction *gtk_action,
 /**
  * amtk_utils_bind_g_action_to_gtk_action:
  * @g_action_map: a #GActionMap.
- * @detailed_g_action_name: a detailed #GAction name; the #GAction must be
- *   present in @g_action_map.
+ * @detailed_g_action_name_without_prefix: a detailed #GAction name without the
+ *   #GActionMap prefix; the #GAction must be present in @g_action_map.
  * @gtk_action_group: a #GtkActionGroup.
  * @gtk_action_name: a #GtkAction name present in @gtk_action_group.
  *
@@ -222,10 +222,12 @@ gtk_action_activate_cb (GtkAction *gtk_action,
  * when #GtkUIManager and #GtkAction are still used. Porting to #GAction should
  * be the first step.
  *
- * For @detailed_g_action_name, see the g_action_parse_detailed_name() function.
- * The `"app."` or `"win."` prefix (or any other #GActionMap prefix) must not be
- * included in @detailed_g_action_name. For example a valid
- * @detailed_g_action_name is `"open"` or `"insert-command::foobar"`.
+ * For @detailed_g_action_name_without_prefix, see the
+ * g_action_parse_detailed_name() function.  The `"app."` or `"win."` prefix (or
+ * any other #GActionMap prefix) must not be included in
+ * @detailed_g_action_name_without_prefix. For example a valid
+ * @detailed_g_action_name_without_prefix is `"open"` or
+ * `"insert-command::foobar"`.
  *
  * The same #GAction can be bound to several #GtkAction's (with different
  * parameter values for the #GAction), but the reverse is not true, one
@@ -246,7 +248,7 @@ gtk_action_activate_cb (GtkAction *gtk_action,
  */
 void
 amtk_utils_bind_g_action_to_gtk_action (GActionMap     *g_action_map,
-                                       const gchar    *detailed_g_action_name,
+                                       const gchar    *detailed_g_action_name_without_prefix,
                                        GtkActionGroup *gtk_action_group,
                                        const gchar    *gtk_action_name)
 {
@@ -257,11 +259,11 @@ amtk_utils_bind_g_action_to_gtk_action (GActionMap     *g_action_map,
        GError *error = NULL;
 
        g_return_if_fail (G_IS_ACTION_MAP (g_action_map));
-       g_return_if_fail (detailed_g_action_name != NULL);
+       g_return_if_fail (detailed_g_action_name_without_prefix != NULL);
        g_return_if_fail (GTK_IS_ACTION_GROUP (gtk_action_group));
        g_return_if_fail (gtk_action_name != NULL);
 
-       g_action_parse_detailed_name (detailed_g_action_name,
+       g_action_parse_detailed_name (detailed_g_action_name_without_prefix,
                                      &g_action_name,
                                      &target_value,
                                      &error);
@@ -278,7 +280,7 @@ amtk_utils_bind_g_action_to_gtk_action (GActionMap     *g_action_map,
        if (error != NULL)
        {
                g_warning ("Error when parsing detailed GAction name '%s': %s",
-                          detailed_g_action_name,
+                          detailed_g_action_name_without_prefix,
                           error->message);
 
                g_clear_error (&error);
diff --git a/amtk/amtk-utils.h b/amtk/amtk-utils.h
index 7e73050..ebb22fc 100644
--- a/amtk/amtk-utils.h
+++ b/amtk/amtk-utils.h
@@ -45,7 +45,7 @@ gchar *               amtk_utils_recent_chooser_menu_get_item_uri     (GtkRecentChooserMenu 
*menu
 
 G_GNUC_BEGIN_IGNORE_DEPRECATIONS
 void           amtk_utils_bind_g_action_to_gtk_action          (GActionMap     *g_action_map,
-                                                                const gchar    *detailed_g_action_name,
+                                                                const gchar    
*detailed_g_action_name_without_prefix,
                                                                 GtkActionGroup *gtk_action_group,
                                                                 const gchar    *gtk_action_name);