From bdb309cbd676ea2b710b57154b68c190e9e5fa9a Mon Sep 17 00:00:00 2001
From: Emmanuele Bassi <ebassi@linux.intel.com>
Date: Mon, 14 Feb 2011 18:36:51 +0000
Subject: [PATCH] annotations: Use caller-allocates for color getters

This should avoid a separate initialization of a ClutterColor in
language bindings.
---
 clutter/clutter-box.c             | 2 +-
 clutter/clutter-colorize-effect.c | 2 +-
 clutter/clutter-rectangle.c       | 4 ++--
 clutter/clutter-stage.c           | 2 +-
 clutter/clutter-text.c            | 4 ++--
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/clutter/clutter-box.c b/clutter/clutter-box.c
index 6dd6a1557..7050209a5 100644
--- a/clutter/clutter-box.c
+++ b/clutter/clutter-box.c
@@ -978,7 +978,7 @@ clutter_box_set_color (ClutterBox         *box,
 /**
  * clutter_box_get_color:
  * @box: a #ClutterBox
- * @color: (out): return location for a #ClutterColor
+ * @color: (out caller-allocates): return location for a #ClutterColor
  *
  * Retrieves the background color of @box
  *
diff --git a/clutter/clutter-colorize-effect.c b/clutter/clutter-colorize-effect.c
index 133b6ad2a..d96d0040c 100644
--- a/clutter/clutter-colorize-effect.c
+++ b/clutter/clutter-colorize-effect.c
@@ -365,7 +365,7 @@ clutter_colorize_effect_set_tint (ClutterColorizeEffect *effect,
 /**
  * clutter_colorize_effect_get_tint:
  * @effect: a #ClutterColorizeEffect
- * @tint: (out): return location for the color used
+ * @tint: (out caller-allocates): return location for the color used
  *
  * Retrieves the tint used by @effect
  *
diff --git a/clutter/clutter-rectangle.c b/clutter/clutter-rectangle.c
index 110d5f8d3..e45e0c443 100644
--- a/clutter/clutter-rectangle.c
+++ b/clutter/clutter-rectangle.c
@@ -356,7 +356,7 @@ clutter_rectangle_new_with_color (const ClutterColor *color)
 /**
  * clutter_rectangle_get_color:
  * @rectangle: a #ClutterRectangle
- * @color: (out): return location for a #ClutterColor
+ * @color: (out caller-allocates): return location for a #ClutterColor
  *
  * Retrieves the color of @rectangle.
  */
@@ -476,7 +476,7 @@ clutter_rectangle_set_border_width (ClutterRectangle *rectangle,
 /**
  * clutter_rectangle_get_border_color:
  * @rectangle: a #ClutterRectangle
- * @color: (out): return location for a #ClutterColor
+ * @color: (out caller-allocates): return location for a #ClutterColor
  *
  * Gets the color of the border used by @rectangle and places
  * it into @color.
diff --git a/clutter/clutter-stage.c b/clutter/clutter-stage.c
index 1334b2189..57b66e103 100644
--- a/clutter/clutter-stage.c
+++ b/clutter/clutter-stage.c
@@ -1685,7 +1685,7 @@ clutter_stage_set_color (ClutterStage       *stage,
 /**
  * clutter_stage_get_color:
  * @stage: A #ClutterStage
- * @color: (out): return location for a #ClutterColor
+ * @color: (out caller-allocates): return location for a #ClutterColor
  *
  * Retrieves the stage color.
  */
diff --git a/clutter/clutter-text.c b/clutter/clutter-text.c
index 9162e2463..835806cee 100644
--- a/clutter/clutter-text.c
+++ b/clutter/clutter-text.c
@@ -3782,7 +3782,7 @@ clutter_text_set_selection_color (ClutterText        *self,
 /**
  * clutter_text_get_selection_color:
  * @self: a #ClutterText
- * @color: return location for a #ClutterColor
+ * @color: (out caller-allocates): return location for a #ClutterColor
  *
  * Retrieves the color of the selection of a #ClutterText actor.
  *
@@ -4126,7 +4126,7 @@ clutter_text_set_color (ClutterText        *self,
 /**
  * clutter_text_get_color:
  * @self: a #ClutterText
- * @color: (out): return location for a #ClutterColor
+ * @color: (out caller-allocates): return location for a #ClutterColor
  *
  * Retrieves the text color as set by clutter_text_set_color().
  *