[cogl] doc: Use Returns: to annotate return values
- From: Damien Lespiau <dlespiau src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [cogl] doc: Use Returns: to annotate return values
- Date: Wed, 2 Jan 2013 14:15:21 +0000 (UTC)
commit 9718f31717b3a0e01b7c4c69cea138f39d23c0e0
Author: Damien Lespiau <damien lespiau intel com>
Date: Sat Dec 29 19:17:35 2012 +0000
doc: Use Returns: to annotate return values
gtk-doc complains that having a sentence starting by Return is a bit
ambiguous and it'd rather see 'Returns:' spelled out.
Fixes 2 warnings:
warning: Free-form return value description in $symbol. Use `Returns:'
to avoid ambiguities
cogl/cogl-matrix.h | 2 +-
cogl/cogl-sdl.h | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
---
diff --git a/cogl/cogl-matrix.h b/cogl/cogl-matrix.h
index 72ce06d..3284a3b 100644
--- a/cogl/cogl-matrix.h
+++ b/cogl/cogl-matrix.h
@@ -764,7 +764,7 @@ cogl_debug_matrix_print (const CoglMatrix *matrix);
/**
* cogl_gtype_matrix_get_type:
*
- * Returns the GType for the registered "CoglMatrix" boxed type. This
+ * Returns: the GType for the registered "CoglMatrix" boxed type. This
* can be used for example to define GObject properties that accept a
* #CoglMatrix value.
*/
diff --git a/cogl/cogl-sdl.h b/cogl/cogl-sdl.h
index b6841f6..c255348 100644
--- a/cogl/cogl-sdl.h
+++ b/cogl/cogl-sdl.h
@@ -209,7 +209,7 @@ cogl_sdl_idle (CoglContext *context);
* cogl_sdl_onscreen_get_window:
* @onscreen: A #CoglOnscreen
*
- * Returns the underlying SDL_Window associated with an onscreen framebuffer.
+ * Returns: the underlying SDL_Window associated with an onscreen framebuffer.
*
* Since: 2.0
* Stability: unstable
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]