Add some more introspection annotations

This commit is contained in:
Emmanuele Bassi 2010-09-06 16:11:46 +01:00
parent fd0cd2e55c
commit 6b5934a18e
3 changed files with 8 additions and 7 deletions

View File

@ -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.</note>
*
* 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);

View File

@ -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;

View File

@ -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);