[gtk+/gi-annotations: 13/31] Update GI annotations in 'Buttons and Toggles'
- From: Pavel Holejsovsky <pholejs src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+/gi-annotations: 13/31] Update GI annotations in 'Buttons and Toggles'
- Date: Mon, 17 Jan 2011 05:51:56 +0000 (UTC)
commit 5434e2b4eb8df8381c5486399f1739a7bc0b2937
Author: Pavel Holejsovsky <pholejs src gnome org>
Date: Sat Jan 15 20:32:38 2011 +0100
Update GI annotations in 'Buttons and Toggles'
'Buttons and Toggles' group from GTK+ manual are: GtkButton,
GtkCheckButton, GtkRadioButton, GtkToggleButton, GtkLinkButton,
GtkScaleButton, GtkVolumeButton, GtkSwitch.
gtk/gtkbutton.c | 6 +++---
gtk/gtkradiobutton.c | 25 +++++++++++++------------
gtk/gtkscalebutton.c | 7 ++++---
3 files changed, 20 insertions(+), 18 deletions(-)
---
diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c
index d86ca46..3d3bd86 100644
--- a/gtk/gtkbutton.c
+++ b/gtk/gtkbutton.c
@@ -301,7 +301,7 @@ gtk_button_class_init (GtkButtonClass *klass)
GTK_PARAM_READWRITE));
/**
- * GtkButton::image:
+ * GtkButton:image:
*
* The child widget to appear next to the button text.
*
@@ -2240,8 +2240,8 @@ gtk_button_set_alignment (GtkButton *button,
/**
* gtk_button_get_alignment:
* @button: a #GtkButton
- * @xalign: return location for horizontal alignment
- * @yalign: return location for vertical alignment
+ * @xalign: (out): return location for horizontal alignment
+ * @yalign: (out): return location for vertical alignment
*
* Gets the alignment of the child in the button.
*
diff --git a/gtk/gtkradiobutton.c b/gtk/gtkradiobutton.c
index 4044b3e..2ec2098 100644
--- a/gtk/gtkradiobutton.c
+++ b/gtk/gtkradiobutton.c
@@ -175,7 +175,7 @@ gtk_radio_button_class_init (GtkRadioButtonClass *class)
/**
* GtkRadioButton::group-changed:
- * @style: the object which received the signal
+ * @button: the object which received the signal
*
* Emitted when the group of radio buttons that a radio button belongs
* to changes. This is emitted when a radio button switches from
@@ -267,8 +267,8 @@ gtk_radio_button_get_property (GObject *object,
/**
* gtk_radio_button_set_group:
* @radio_button: a #GtkRadioButton.
- * @group: (transfer none) (element-type GtkRadioButton): an existing radio
- * button group, such as one returned from gtk_radio_button_get_group().
+ * @group: (element-type GtkRadioButton): an existing radio button
+ * group, such as one returned from gtk_radio_button_get_group().
*
* Sets a #GtkRadioButton's group. It should be noted that this does not change
* the layout of your interface in any way, so if you are changing the group,
@@ -403,8 +403,8 @@ gtk_radio_button_join_group (GtkRadioButton *radio_button,
/**
* gtk_radio_button_new:
- * @group: (allow-none): an existing radio button group, or %NULL if you are
- * creating a new group.
+ * @group: (element-type GtkRadioButton) (allow-none): an existing
+ * radio button group, or %NULL if you are creating a new group.
*
* Creates a new #GtkRadioButton. To be of any practical value, a widget should
* then be packed into the radio button.
@@ -426,13 +426,13 @@ gtk_radio_button_new (GSList *group)
/**
* gtk_radio_button_new_with_label:
- * @group: (allow-none): an existing radio button group, or %NULL if you are
- * creating a new group.
+ * @group: (element-type GtkRadioButton) (allow-none): an existing
+ * radio button group, or %NULL if you are creating a new group.
* @label: the text label to display next to the radio button.
*
* Creates a new #GtkRadioButton with a text label.
*
- * Returns: (transfer full): a new radio button.
+ * Returns: a new radio button.
*/
GtkWidget*
gtk_radio_button_new_with_label (GSList *group,
@@ -451,7 +451,8 @@ gtk_radio_button_new_with_label (GSList *group,
/**
* gtk_radio_button_new_with_mnemonic:
- * @group: (allow-none): the radio button group
+ * @group: (element-type GtkRadioButton) (allow-none): the radio button
+ * group
* @label: the text of the button, with an underscore in front of the
* mnemonic character
*
@@ -460,7 +461,7 @@ gtk_radio_button_new_with_label (GSList *group,
* gtk_label_new_with_mnemonic(), so underscores in @label indicate the
* mnemonic for the button.
*
- * Returns: (transfer full): a new #GtkRadioButton
+ * Returns: a new #GtkRadioButton
*/
GtkWidget*
gtk_radio_button_new_with_mnemonic (GSList *group,
@@ -487,7 +488,7 @@ gtk_radio_button_new_with_mnemonic (GSList *group,
* @radio_group_member. As with gtk_radio_button_new(), a widget
* should be packed into the radio button.
*
- * Returns: (transfer full): a new radio button.
+ * Returns: (transfer none): a new radio button.
*/
GtkWidget*
gtk_radio_button_new_from_widget (GtkRadioButton *radio_group_member)
@@ -528,7 +529,7 @@ gtk_radio_button_new_with_label_from_widget (GtkRadioButton *radio_group_member,
* will be created using gtk_label_new_with_mnemonic(), so underscores
* in @label indicate the mnemonic for the button.
*
- * Returns: (transfer full): a new #GtkRadioButton
+ * Returns: (transfer none): a new #GtkRadioButton
**/
GtkWidget*
gtk_radio_button_new_with_mnemonic_from_widget (GtkRadioButton *radio_group_member,
diff --git a/gtk/gtkscalebutton.c b/gtk/gtkscalebutton.c
index 7be5660..a688705 100644
--- a/gtk/gtkscalebutton.c
+++ b/gtk/gtkscalebutton.c
@@ -559,8 +559,9 @@ gtk_scale_button_dispose (GObject *object)
* @max: the maximum value of the scale (usually 100)
* @step: the stepping of value when a scroll-wheel event,
* or up/down arrow event occurs (usually 2)
- * @icons: (allow-none): a %NULL-terminated array of icon names, or %NULL if
- * you want to set the list later with gtk_scale_button_set_icons()
+ * @icons: (allow-none) (array zero-terminated=1): a %NULL-terminated
+ * array of icon names, or %NULL if you want to set the list
+ * later with gtk_scale_button_set_icons()
*
* Creates a #GtkScaleButton, with a range between @min and @max, with
* a stepping of @step.
@@ -640,7 +641,7 @@ gtk_scale_button_set_value (GtkScaleButton *button,
/**
* gtk_scale_button_set_icons:
* @button: a #GtkScaleButton
- * @icons: a %NULL-terminated array of icon names
+ * @icons: (array zero-terminated=1): a %NULL-terminated array of icon names
*
* Sets the icons to be used by the scale button.
* For details, see the #GtkScaleButton:icons property.
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]