[gtk/ebassi/gidocgen: 185/483] menubutton: Add property annotations

[Emmanuele Bassi <ebassi src gnome org>]

commit 539a540437873a0fe1ceb03488ab231b37548647
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu Feb 25 12:23:28 2021 -0500

    menubutton: Add property annotations
    
    Connect properties, getters, and setters with annotations

 gtk/gtkmenubutton.c | 52 ++++++++++++++++++++++++++--------------------------
 gtk/gtkmenubutton.h |  9 ++++++---
 2 files changed, 32 insertions(+), 29 deletions(-)
---
diff --git a/gtk/gtkmenubutton.c b/gtk/gtkmenubutton.c
index cb3d9f02ef..a2cc304605 100644
--- a/gtk/gtkmenubutton.c
+++ b/gtk/gtkmenubutton.c
@@ -32,8 +32,8 @@
  * [property@Gtk.MenuButton:icon-name] property) or a label (set with the
  * [property@Gtk.MenuButton:label] property). If neither is explicitly set,
  * a [class@Gtk.Image] is automatically created, using an arrow image oriented
- * according to [property@Gtk.MenuButton:direction] or the generic “open-menu-symbolic”
- * icon if the direction is not set.
+ * according to [property@Gtk.MenuButton:direction] or the generic
+ * “open-menu-symbolic” icon if the direction is not set.
  *
  * The positioning of the popup is determined by the
  * [property@Gtk.MenuButton:direction] property of the menu button.
@@ -376,7 +376,7 @@ gtk_menu_button_class_init (GtkMenuButtonClass *klass)
   widget_class->grab_focus = gtk_menu_button_grab_focus;
 
   /**
-   * GtkMenuButton:menu-model:
+   * GtkMenuButton:menu-model: (attributes org.gtk.Property.get=gtk_menu_button_get_menu_model 
org.gtk.Property.set=gtk_menu_button_set_menu_model)
    *
    * The `GMenuModel` from which the popup will be created.
    *
@@ -391,7 +391,7 @@ gtk_menu_button_class_init (GtkMenuButtonClass *klass)
                            GTK_PARAM_READWRITE);
 
   /**
-   * GtkMenuButton:direction:
+   * GtkMenuButton:direction: (attributes org.gtk.Property.get=gtk_menu_button_get_direction 
org.gtk.Property.set=gtk_menu_button_set_direction)
    *
    * The `GtkArrowType` representing the direction in which the
    * menu or popover will be popped out.
@@ -405,7 +405,7 @@ gtk_menu_button_class_init (GtkMenuButtonClass *klass)
                          GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
 
   /**
-   * GtkMenuButton:popover:
+   * GtkMenuButton:popover: (attributes org.gtk.Property.get=gtk_menu_button_get_popover 
org.gtk.Property.set=gtk_menu_button_set_popover)
    *
    * The `GtkPopover` that will be popped up when the button is clicked.
    */
@@ -417,7 +417,7 @@ gtk_menu_button_class_init (GtkMenuButtonClass *klass)
                            G_PARAM_READWRITE);
 
   /**
-   * GtkMenuButton:icon-name:
+   * GtkMenuButton:icon-name: (attributes org.gtk.Property.get=gtk_menu_button_get_icon_name 
org.gtk.Property.set=gtk_menu_button_set_icon_name)
    *
    * The name of the icon used to automatically populate the button.
    */
@@ -429,7 +429,7 @@ gtk_menu_button_class_init (GtkMenuButtonClass *klass)
                            GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
 
   /**
-   * GtkMenuButton:label:
+   * GtkMenuButton:label: (attributes org.gtk.Property.get=gtk_menu_button_get_label 
org.gtk.Property.set=gtk_menu_button_set_label)
    *
    * The label for the button.
    */
@@ -441,7 +441,7 @@ gtk_menu_button_class_init (GtkMenuButtonClass *klass)
                            GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
 
   /**
-   * GtkMenuButton:use-underline:
+   * GtkMenuButton:use-underline: (attributes org.gtk.Property.get=gtk_menu_button_get_use_underline 
org.gtk.Property.set=gtk_menu_button_set_use_underline)
    *
    * If set an underscore in the text indicates a mnemonic.
    */
@@ -453,7 +453,7 @@ gtk_menu_button_class_init (GtkMenuButtonClass *klass)
                            GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
 
   /**
-   * GtkMenuButton:has-frame:
+   * GtkMenuButton:has-frame: (attributes org.gtk.Property.get=gtk_menu_button_get_has_frame 
org.gtk.Property.set=gtk_menu_button_set_has_frame)
    *
    * Whether the button has a frame.
    */
@@ -580,7 +580,7 @@ menu_deactivate_cb (GtkMenuButton *self)
 }
 
 /**
- * gtk_menu_button_set_menu_model:
+ * gtk_menu_button_set_menu_model: (attributes org.gtk.Method.set_property=menu-model)
  * @menu_button: a `GtkMenuButton`
  * @menu_model: (nullable): a `GMenuModel`, or %NULL to unset and disable the
  *   button
@@ -593,8 +593,8 @@ menu_deactivate_cb (GtkMenuButton *self)
  * [ctor@Gtk.PopoverMenu.new_from_model]. Actions will be connected
  * as documented for this function.
  *
- * If [property@Gtk.MenuButton:popover] is already set, it will be dissociated
- * from the @menu_button, and the property is set to %NULL.
+ * If [property@Gtk.MenuButton:popover] is already set, it will be
+ * dissociated from the @menu_button, and the property is set to %NULL.
  */
 void
 gtk_menu_button_set_menu_model (GtkMenuButton *menu_button,
@@ -627,7 +627,7 @@ gtk_menu_button_set_menu_model (GtkMenuButton *menu_button,
 }
 
 /**
- * gtk_menu_button_get_menu_model:
+ * gtk_menu_button_get_menu_model: (attributes org.gtk.Method.get_property=menu-model)
  * @menu_button: a `GtkMenuButton`
  *
  * Returns the `GMenuModel` used to generate the popup.
@@ -675,7 +675,7 @@ popover_destroy_cb (GtkMenuButton *menu_button)
 }
 
 /**
- * gtk_menu_button_set_direction:
+ * gtk_menu_button_set_direction: (attributes org.gtk.Method.set_property=direction)
  * @menu_button: a `GtkMenuButton`
  * @direction: a `GtkArrowType`
  *
@@ -716,7 +716,7 @@ gtk_menu_button_set_direction (GtkMenuButton *menu_button,
 }
 
 /**
- * gtk_menu_button_get_direction:
+ * gtk_menu_button_get_direction: (attributes org.gtk.Method.get_property=direction)
  * @menu_button: a `GtkMenuButton`
  *
  * Returns the direction the popup will be pointing at when popped up.
@@ -758,7 +758,7 @@ gtk_menu_button_dispose (GObject *object)
 }
 
 /**
- * gtk_menu_button_set_popover:
+ * gtk_menu_button_set_popover: (attributes org.gtk.Method.set_property=popover)
  * @menu_button: a `GtkMenuButton`
  * @popover: (nullable): a `GtkPopover`, or %NULL to unset and disable the button
  *
@@ -815,7 +815,7 @@ gtk_menu_button_set_popover (GtkMenuButton *menu_button,
 }
 
 /**
- * gtk_menu_button_get_popover:
+ * gtk_menu_button_get_popover: (attributes org.gtk.Method.get_property=popover)
  * @menu_button: a `GtkMenuButton`
  *
  * Returns the `GtkPopover` that pops out of the button.
@@ -834,7 +834,7 @@ gtk_menu_button_get_popover (GtkMenuButton *menu_button)
 }
 
 /**
- * gtk_menu_button_set_icon_name:
+ * gtk_menu_button_set_icon_name: (attributes org.gtk.Method.set_property=icon-name)
  * @menu_button: a `GtkMenuButton`
  * @icon_name: the icon name
  *
@@ -851,7 +851,7 @@ gtk_menu_button_set_icon_name (GtkMenuButton *menu_button,
 }
 
 /**
- * gtk_menu_button_get_icon_name:
+ * gtk_menu_button_get_icon_name: (attributes org.gtk.Method.get_property=icon-name)
  * @menu_button: a `GtkMenuButton`
  *
  * Gets the name of the icon shown in the button.
@@ -867,7 +867,7 @@ gtk_menu_button_get_icon_name (GtkMenuButton *menu_button)
 }
 
 /**
- * gtk_menu_button_set_label:
+ * gtk_menu_button_set_label: (attributes org.gtk.Method.set_property=label)
  * @menu_button: a `GtkMenuButton`
  * @label: the label
  *
@@ -903,7 +903,7 @@ gtk_menu_button_set_label (GtkMenuButton *menu_button,
 }
 
 /**
- * gtk_menu_button_get_label:
+ * gtk_menu_button_get_label: (attributes org.gtk.Method.get_property=label)
  * @menu_button: a `GtkMenuButton`
  *
  * Gets the label shown in the button
@@ -928,7 +928,7 @@ gtk_menu_button_get_label (GtkMenuButton *menu_button)
 }
 
 /**
- * gtk_menu_button_set_has_frame:
+ * gtk_menu_button_set_has_frame: (attributes org.gtk.Method.set_property=has-frame)
  * @menu_button: a `GtkMenuButton`
  * @has_frame: whether the button should have a visible frame
  *
@@ -948,7 +948,7 @@ gtk_menu_button_set_has_frame (GtkMenuButton *menu_button,
 }
 
 /**
- * gtk_menu_button_get_has_frame:
+ * gtk_menu_button_get_has_frame: (attributes org.gtk.Method.get_property=has-frame)
  * @menu_button: a `GtkMenuButton`
  *
  * Returns whether the button has a frame.
@@ -1032,7 +1032,7 @@ gtk_menu_button_set_create_popup_func (GtkMenuButton                *menu_button
 }
 
 /**
- * gtk_menu_button_set_use_underline:
+ * gtk_menu_button_set_use_underline: (attributes org.gtk.Method.set_property=use-underline)
  * @menu_button: a `GtkMenuButton`
  * @use_underline: %TRUE if underlines in the text indicate mnemonics
  *
@@ -1055,10 +1055,10 @@ gtk_menu_button_set_use_underline (GtkMenuButton *menu_button,
 }
 
 /**
- * gtk_menu_button_get_use_underline:
+ * gtk_menu_button_get_use_underline: (attributes org.gtk.Method.get_property=use-underline)
  * @menu_button: a `GtkMenuButton`
  *
- * Returns whether an dwembedded underline in the text indicates a
+ * Returns whether an embedded underline in the text indicates a
  * mnemonic.
  *
  * Returns: %TRUE whether an embedded underline in the text indicates
diff --git a/gtk/gtkmenubutton.h b/gtk/gtkmenubutton.h
index e9011f93fd..efe985fcb7 100644
--- a/gtk/gtkmenubutton.h
+++ b/gtk/gtkmenubutton.h
@@ -41,9 +41,12 @@ typedef struct _GtkMenuButton        GtkMenuButton;
  * @menu_button: the #GtkMenuButton
  * @user_data: User data passed to gtk_menu_button_set_create_popup_func()
  *
- * User-provided callback function to create a popup for @menu_button on demand.
- * This function is called when the popup of @menu_button is shown, but none has
- * been provided via gtk_menu_button_set_popover() or gtk_menu_button_set_menu_model().
+ * User-provided callback function to create a popup for a
+ * `GtkMenuButton` on demand.
+ *
+ * This function is called when the popup of @menu_button is shown,
+ * but none has been provided via [method@Gtk.MenuButton.set_popover]
+ * or [method@Gtk.MenuButton.set_menu_model].
  */
 typedef void  (*GtkMenuButtonCreatePopupFunc) (GtkMenuButton *menu_button,
                                                gpointer       user_data);