From 8c1708ec935112a9a482c7dd2ba52a367540d137 Mon Sep 17 00:00:00 2001
From: Damien Lespiau <damien.lespiau@intel.com>
Date: Sun, 30 Dec 2012 16:24:44 +0000
Subject: [PATCH] doc: Fix argument syntax of existing commment blocks

Fixes:
  Parsing comment block file : parameter expecter

by correctly declaring parameters.

(cherry picked from commit 2fe9bc2017fa966ab445674a530aac0c17204040)
---
 cogl/cogl-matrix.h   |  6 +++---
 cogl/cogl-object.h   |  4 ++--
 cogl/cogl-renderer.h |  2 +-
 cogl/cogl-texture.h  | 18 +++++++++---------
 4 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/cogl/cogl-matrix.h b/cogl/cogl-matrix.h
index 094de2079..90f3ea957 100644
--- a/cogl/cogl-matrix.h
+++ b/cogl/cogl-matrix.h
@@ -132,9 +132,9 @@ cogl_matrix_init_identity (CoglMatrix *matrix);
 /**
  * cogl_matrix_init_translation:
  * @matrix: A 4x4 transformation matrix
- * @tx x coordinate of the translation vector
- * @ty y coordinate of the translation vector
- * @tz z coordinate of the translation vector
+ * @tx: x coordinate of the translation vector
+ * @ty: y coordinate of the translation vector
+ * @tz: z coordinate of the translation vector
  *
  * Resets matrix to the (tx, ty, tz) translation matrix:
  *
diff --git a/cogl/cogl-object.h b/cogl/cogl-object.h
index da43bb39b..87fdce2b8 100644
--- a/cogl/cogl-object.h
+++ b/cogl/cogl-object.h
@@ -180,8 +180,8 @@ cogl_object_get_user_data (CoglObject *object,
 
 /**
  * cogl_debug_object_foreach_type:
- * func: A callback function for each type
- * user_data: A pointer to pass to @func
+ * @func: A callback function for each type
+ * @user_data: A pointer to pass to @func
  *
  * Invokes @func once for each type of object that Cogl uses and
  * passes a count of the number of objects for that type. This is
diff --git a/cogl/cogl-renderer.h b/cogl/cogl-renderer.h
index 427b8ba25..923950a4a 100644
--- a/cogl/cogl-renderer.h
+++ b/cogl/cogl-renderer.h
@@ -239,7 +239,7 @@ cogl_renderer_check_onscreen_template (CoglRenderer *renderer,
 /**
  * cogl_renderer_connect:
  * @renderer: An unconnected #CoglRenderer
- * @error a pointer to a #CoglError for reporting exceptions
+ * @error: a pointer to a #CoglError for reporting exceptions
  *
  * Connects the configured @renderer. Renderer connection isn't a
  * very active process, it basically just means validating that
diff --git a/cogl/cogl-texture.h b/cogl/cogl-texture.h
index 6714b65c4..97311de97 100644
--- a/cogl/cogl-texture.h
+++ b/cogl/cogl-texture.h
@@ -247,7 +247,7 @@ cogl_is_texture (void *object);
 
 /**
  * cogl_texture_get_width:
- * @texture a #CoglTexture pointer.
+ * @texture: a #CoglTexture pointer.
  *
  * Queries the width of a cogl texture.
  *
@@ -258,7 +258,7 @@ cogl_texture_get_width (CoglTexture *texture);
 
 /**
  * cogl_texture_get_height:
- * @texture a #CoglTexture pointer.
+ * @texture: a #CoglTexture pointer.
  *
  * Queries the height of a cogl texture.
  *
@@ -269,7 +269,7 @@ cogl_texture_get_height (CoglTexture *texture);
 
 /**
  * cogl_texture_get_format:
- * @texture a #CoglTexture pointer.
+ * @texture: a #CoglTexture pointer.
  *
  * Queries the #CoglPixelFormat of a cogl texture.
  *
@@ -312,7 +312,7 @@ cogl_texture_get_rowstride (CoglTexture *texture);
 
 /**
  * cogl_texture_get_max_waste:
- * @texture a #CoglTexture pointer.
+ * @texture: a #CoglTexture pointer.
  *
  * Queries the maximum wasted (unused) pixels in one dimension of a GPU side
  * texture.
@@ -324,7 +324,7 @@ cogl_texture_get_max_waste (CoglTexture *texture);
 
 /**
  * cogl_texture_is_sliced:
- * @texture a #CoglTexture pointer.
+ * @texture: a #CoglTexture pointer.
  *
  * Queries if a texture is sliced (stored as multiple GPU side tecture
  * objects).
@@ -337,7 +337,7 @@ cogl_texture_is_sliced (CoglTexture *texture);
 
 /**
  * cogl_texture_get_gl_texture:
- * @texture a #CoglTexture pointer.
+ * @texture: a #CoglTexture pointer.
  * @out_gl_handle: (out) (allow-none): pointer to return location for the
  *   textures GL handle, or %NULL.
  * @out_gl_target: (out) (allow-none): pointer to return location for the
@@ -358,7 +358,7 @@ cogl_texture_get_gl_texture (CoglTexture *texture,
 
 /**
  * cogl_texture_get_data:
- * @texture a #CoglTexture pointer.
+ * @texture: a #CoglTexture pointer.
  * @format: the #CoglPixelFormat to store the texture as.
  * @rowstride: the rowstride of @data in bytes or pass 0 to calculate
  *             from the bytes-per-pixel of @format multiplied by the
@@ -383,7 +383,7 @@ cogl_texture_get_data (CoglTexture *texture,
 
 /**
  * cogl_texture_set_region:
- * @texture a #CoglTexture.
+ * @texture: a #CoglTexture.
  * @src_x: upper left coordinate to use from source data.
  * @src_y: upper left coordinate to use from source data.
  * @dst_x: upper left destination horizontal coordinate.
@@ -425,7 +425,7 @@ cogl_texture_set_region (CoglTexture *texture,
 
 /**
  * cogl_texture_set_region_from_bitmap:
- * @texture a #CoglTexture pointer
+ * @texture: a #CoglTexture pointer
  * @src_x: upper left coordinate to use from the source bitmap.
  * @src_y: upper left coordinate to use from the source bitmap
  * @dst_x: upper left destination horizontal coordinate.