[goocanvas/introspection: 4/8] Add GI annotations to goocanvasitem.c

[John Stowers <jstowers src gnome org>]

commit c013eab873db84f5640b6fa5e7d7c0db21e03846
Author: Tristan Brindle <tristan fugro-fsi com au>
Date:   Tue May 17 11:31:57 2011 +0800

    Add GI annotations to goocanvasitem.c

 src/goocanvasitem.c |   26 ++++++++++++++------------
 1 files changed, 14 insertions(+), 12 deletions(-)
---
diff --git a/src/goocanvasitem.c b/src/goocanvasitem.c
index 57db899..07ff65d 100644
--- a/src/goocanvasitem.c
+++ b/src/goocanvasitem.c
@@ -536,7 +536,7 @@ goo_canvas_item_base_init (gpointer g_iface)
  * 
  * Returns the #GooCanvas containing the given #GooCanvasItem.
  * 
- * Returns: the #GooCanvas.
+ * Returns: (transfer none): the #GooCanvas.
  **/
 GooCanvas*
 goo_canvas_item_get_canvas (GooCanvasItem *item)
@@ -711,8 +711,8 @@ goo_canvas_item_get_n_children (GooCanvasItem       *item)
  * 
  * Gets the child item at the given stack position.
  * 
- * Returns: the child item at the given stack position, or %NULL if @child_num
- * is out of range.
+ * Returns: (transfer none): the child item at the given stack position, or
+ *  %NULL if @child_num is out of range.
  **/
 GooCanvasItem*
 goo_canvas_item_get_child (GooCanvasItem       *item,
@@ -730,7 +730,7 @@ goo_canvas_item_get_child (GooCanvasItem       *item,
  * 
  * Gets the parent of the given item.
  * 
- * Returns: the parent item, or %NULL if the item has no parent.
+ * Returns: (transfer none): the parent item, or %NULL if the item has no parent.
  **/
 GooCanvasItem*
 goo_canvas_item_get_parent  (GooCanvasItem *item)
@@ -1204,7 +1204,7 @@ goo_canvas_item_skew_y         (GooCanvasItem *item,
  * Gets the item's style. If the item doesn't have its own style it will return
  * its parent's style.
  * 
- * Returns: the item's style.
+ * Returns: (transfer none): the item's style.
  **/
 GooCanvasStyle*
 goo_canvas_item_get_style      (GooCanvasItem   *item)
@@ -1555,8 +1555,8 @@ goo_canvas_item_get_bounds  (GooCanvasItem   *item,
  *
  * It gets the items at the given point.
  * 
- * Returns: the @found_items list, with any more found items added onto
- *  the start of the list, leaving the top item first.
+ * Returns: (transfer none): the @found_items list, with any more found items 
+ *  added onto the start of the list, leaving the top item first.
  **/
 GList*
 goo_canvas_item_get_items_at (GooCanvasItem  *item,
@@ -1616,7 +1616,7 @@ goo_canvas_item_is_visible  (GooCanvasItem   *item)
  * 
  * Gets the model of the given canvas item.
  * 
- * Returns: the item's model, or %NULL if it has no model.
+ * Returns: (transfer none): the item's model, or %NULL if it has no model.
  **/
 GooCanvasItemModel*
 goo_canvas_item_get_model	  (GooCanvasItem   *item)
@@ -2294,13 +2294,14 @@ goo_canvas_item_class_install_child_property (GObjectClass *iclass,
  * goo_canvas_item_class_find_child_property:
  * @iclass: a #GObjectClass
  * @property_name: the name of the child property to find
- * @returns: the #GParamSpec of the child property or %NULL if @class has no
- *   child property with that name.
  *
  * This function is only intended to be used when implementing new canvas
  * items, specifically layout container items such as #GooCanvasTable.
  *
  * It finds a child property of a canvas item class by name.
+ *
+ * Returns: (type GObject.ParamSpec) (transfer none): the #GParamSpec of the
+ *  child property or %NULL if @class has no child property with that name.
  */
 GParamSpec*
 goo_canvas_item_class_find_child_property (GObjectClass *iclass,
@@ -2318,13 +2319,14 @@ goo_canvas_item_class_find_child_property (GObjectClass *iclass,
  * goo_canvas_item_class_list_child_properties:
  * @iclass: a #GObjectClass
  * @n_properties: location to return the number of child properties found
- * @returns: a newly allocated array of #GParamSpec*. The array must be 
- *           freed with g_free().
  *
  * This function is only intended to be used when implementing new canvas
  * items, specifically layout container items such as #GooCanvasTable.
  *
  * It returns all child properties of a canvas item class.
+ *
+ * @returns: (array length=n_properties) (transfer full): a newly allocated
+ *  array of #GParamSpec*. The array must be freed with g_free().
  */
 GParamSpec**
 goo_canvas_item_class_list_child_properties (GObjectClass *iclass,