[cogl/wip/cogl-1.14: 114/177] doc: Use Returns: to annotate return values



commit 8a20089fa8c95698ff01b30bca58c9dae3d7501c
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
    
    (cherry picked from commit 9718f31717b3a0e01b7c4c69cea138f39d23c0e0)

 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 7525f8f..094de20 100644
--- a/cogl/cogl-matrix.h
+++ b/cogl/cogl-matrix.h
@@ -783,7 +783,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]