From 6b5934a18e76d6f33002586500bfb08a8ef78431 Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Mon, 6 Sep 2010 16:11:46 +0100 Subject: [PATCH] Add some more introspection annotations --- cogl/cogl-material.h | 2 +- cogl/cogl-offscreen.h | 11 ++++++----- cogl/cogl-types.h | 2 +- 3 files changed, 8 insertions(+), 7 deletions(-) diff --git a/cogl/cogl-material.h b/cogl/cogl-material.h index ef5b76a9b..11ce4e54c 100644 --- a/cogl/cogl-material.h +++ b/cogl/cogl-material.h @@ -945,7 +945,7 @@ cogl_material_layer_get_type (CoglMaterialLayer *layer); * should call cogl_material_layer_get_type() first in order check it is of * type %COGL_MATERIAL_LAYER_TYPE_TEXTURE before calling this function. * - * Return value: a #CoglHandle for the texture inside the layer + * Return value: (transfer none): a #CoglHandle for the texture inside the layer */ CoglHandle cogl_material_layer_get_texture (CoglMaterialLayer *layer); diff --git a/cogl/cogl-offscreen.h b/cogl/cogl-offscreen.h index 6cfba881b..c70eb999d 100644 --- a/cogl/cogl-offscreen.h +++ b/cogl/cogl-offscreen.h @@ -55,8 +55,9 @@ G_BEGIN_DECLS * * Note: This does not work with sliced Cogl textures. * - * Returns: a #CoglHandle for the new offscreen buffer or %COGL_INVALID_HANDLE - * if it wasn't possible to create the buffer. + * Return value: (transfer full): a #CoglHandle for the new offscreen + * buffer or %COGL_INVALID_HANDLE if it wasn't possible to create the + * buffer. */ CoglHandle cogl_offscreen_new_to_texture (CoglHandle handle); @@ -80,9 +81,9 @@ gboolean cogl_is_offscreen (CoglHandle handle); * * Increments the reference count on the offscreen buffer. * - * Returns: For convenience it returns the given CoglHandle + * Return value: (transfer none): For convenience it returns the given CoglHandle * - * Deprecated: 1.2: cogl_handle_ref should be used in new code. + * Deprecated: 1.2: cogl_handle_ref() should be used in new code. */ CoglHandle cogl_offscreen_ref (CoglHandle handle) G_GNUC_DEPRECATED; @@ -93,7 +94,7 @@ CoglHandle cogl_offscreen_ref (CoglHandle handle) G_GNU * Decreases the reference count for the offscreen buffer and frees it when * the count reaches 0. * - * Deprecated: 1.2: cogl_handle_unref should be used in new code. + * Deprecated: 1.2: cogl_handle_unref() should be used in new code. */ void cogl_offscreen_unref (CoglHandle handle) G_GNUC_DEPRECATED; diff --git a/cogl/cogl-types.h b/cogl/cogl-types.h index 0e654acda..fef08ae38 100644 --- a/cogl/cogl-types.h +++ b/cogl/cogl-types.h @@ -68,7 +68,7 @@ cogl_handle_get_type (void) G_GNUC_CONST; * * Increases the reference count of @handle by 1 * - * Returns: the handle, with its reference count increased + * Return value: (transfer none): the handle, with its reference count increased */ CoglHandle cogl_handle_ref (CoglHandle handle);