[gimp] libgimpwidgets: add a bunch of (transfer) values.



commit f7fbdc89b13b302b16d0f7d829f25e60a9ef8d93
Author: Jehan <jehan girinstud io>
Date:   Wed Jul 31 23:48:32 2019 +0200

    libgimpwidgets: add a bunch of (transfer) values.

 libgimpwidgets/gimpmemsizeentry.c | 2 +-
 libgimpwidgets/gimppageselector.c | 2 +-
 libgimpwidgets/gimppreview.c      | 8 ++++----
 libgimpwidgets/gimpruler.c        | 2 +-
 libgimpwidgets/gimpsizeentry.c    | 6 +++---
 5 files changed, 10 insertions(+), 10 deletions(-)
---
diff --git a/libgimpwidgets/gimpmemsizeentry.c b/libgimpwidgets/gimpmemsizeentry.c
index b90b755662..442561f161 100644
--- a/libgimpwidgets/gimpmemsizeentry.c
+++ b/libgimpwidgets/gimpmemsizeentry.c
@@ -297,7 +297,7 @@ gimp_memsize_entry_get_value (GimpMemsizeEntry *entry)
  * gimp_memsize_entry_get_spinbutton:
  * @entry: a #GimpMemsizeEntry
  *
- * Returns: the entry's #GtkSpinbutton.
+ * Returns: (transfer none): the entry's #GtkSpinbutton.
  *
  * Since: 3.0
  **/
diff --git a/libgimpwidgets/gimppageselector.c b/libgimpwidgets/gimppageselector.c
index da528c6bfd..fd40635845 100644
--- a/libgimpwidgets/gimppageselector.c
+++ b/libgimpwidgets/gimppageselector.c
@@ -597,7 +597,7 @@ gimp_page_selector_set_page_thumbnail (GimpPageSelector *selector,
  * @selector: Pointer to a #GimpPageSelector.
  * @page_no: The number of the page to get the thumbnail for.
  *
- * Returns: The page's thumbnail, or %NULL if none is set. The returned
+ * Returns: (transfer none): The page's thumbnail, or %NULL if none is set. The returned
  *          pixbuf is owned by #GimpPageSelector and must not be
  *          unref'ed when no longer needed.
  *
diff --git a/libgimpwidgets/gimppreview.c b/libgimpwidgets/gimppreview.c
index 9aed07ec13..9980442137 100644
--- a/libgimpwidgets/gimppreview.c
+++ b/libgimpwidgets/gimppreview.c
@@ -786,7 +786,7 @@ gimp_preview_untransform (GimpPreview *preview,
  * gimp_preview_get_frame:
  * @preview: a #GimpPreview widget
  *
- * Return value: a pointer to the #GtkAspectFrame used in the @preview.
+ * Return value: (transfer none): a pointer to the #GtkAspectFrame used in the @preview.
  *
  * Since: 3.0
  **/
@@ -802,7 +802,7 @@ gimp_preview_get_frame (GimpPreview  *preview)
  * gimp_preview_get_grid:
  * @preview: a #GimpPreview widget
  *
- * Return value: a pointer to the #GtkGrid used in the @preview.
+ * Return value: (transfer none): a pointer to the #GtkGrid used in the @preview.
  *
  * Since: 3.0
  **/
@@ -823,7 +823,7 @@ gimp_preview_get_grid (GimpPreview  *preview)
  * For example if you want to receive mouse events from the area. In
  * such cases, use gimp_preview_get_area().
  *
- * Return value: a pointer to the #GimpPreviewArea used in the @preview.
+ * Return value: (transfer none): a pointer to the #GimpPreviewArea used in the @preview.
  *
  * Since: 2.4
  **/
@@ -957,7 +957,7 @@ gimp_preview_get_default_cursor (GimpPreview *preview)
  * contains the update toggle. Derived widgets can use this function
  * if they need to add controls to this area.
  *
- * Return value: the #GtkHBox at the bottom of the preview.
+ * Return value: (transfer none): the #GtkHBox at the bottom of the preview.
  *
  * Since: 2.4
  **/
diff --git a/libgimpwidgets/gimpruler.c b/libgimpwidgets/gimpruler.c
index 730dfc3880..63f6502e19 100644
--- a/libgimpwidgets/gimpruler.c
+++ b/libgimpwidgets/gimpruler.c
@@ -616,7 +616,7 @@ gimp_ruler_set_unit (GimpRuler *ruler,
  * gimp_ruler_get_unit:
  * @ruler: a #GimpRuler
  *
- * Return value: the unit currently used in the @ruler widget.
+ * Return value: (transfer none): the unit currently used in the @ruler widget.
  *
  * Since: 2.8
  **/
diff --git a/libgimpwidgets/gimpsizeentry.c b/libgimpwidgets/gimpsizeentry.c
index 5d435293ab..3bf70659e2 100644
--- a/libgimpwidgets/gimpsizeentry.c
+++ b/libgimpwidgets/gimpsizeentry.c
@@ -559,7 +559,7 @@ gimp_size_entry_get_unit_combo (GimpSizeEntry *gse)
  *
  * Attaches a #GtkLabel to the #GimpSizeEntry (which is a #GtkGrid).
  *
- * Returns: A pointer to the new #GtkLabel widget.
+ * Returns: (transfer full): A pointer to the new #GtkLabel widget.
  **/
 GtkWidget *
 gimp_size_entry_attach_label (GimpSizeEntry *gse,
@@ -1235,7 +1235,7 @@ gimp_size_entry_refval_callback (GtkAdjustment *adjustment,
  * Returns the #GimpUnit the user has selected in the #GimpSizeEntry's
  * #GimpUnitComboBox.
  *
- * Returns: The sizeentry's unit.
+ * Returns: (transfer none): The sizeentry's unit.
  **/
 GimpUnit
 gimp_size_entry_get_unit (GimpSizeEntry *gse)
@@ -1662,7 +1662,7 @@ gimp_size_entry_set_activates_default (GimpSizeEntry *gse,
  * if you want to set tooltips using gimp_help_set_help_data() you
  * can use this function to get a pointer to the spinbuttons.
  *
- * Return value: a #GtkWidget pointer that you can attach a tooltip to.
+ * Return value: (transfer none): a #GtkWidget pointer that you can attach a tooltip to.
  **/
 GtkWidget *
 gimp_size_entry_get_help_widget (GimpSizeEntry *gse,


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]