[cogl/wip/cogl-1.14: 131/177] doc: Make a pass on CoglRenderer argument documentation

[Robert Bragg <rbragg src gnome org>]

commit 5963a76f06851887404dd20451909353ccd4d5b7
Author: Damien Lespiau <damien lespiau intel com>
Date:   Sun Dec 30 17:47:12 2012 +0000

    doc: Make a pass on CoglRenderer argument documentation
    
    Various arguments where missing, added them.
    
    (cherry picked from commit 6e6ee4acb5524ced2f82d42d9c6a706f84f8184c)

 cogl/cogl-win32-renderer.h |    7 +++++++
 cogl/cogl-xlib-renderer.h  |   13 +++++++++++--
 2 files changed, 18 insertions(+), 2 deletions(-)
---
diff --git a/cogl/cogl-win32-renderer.h b/cogl/cogl-win32-renderer.h
index f65bc8f..e9747da 100644
--- a/cogl/cogl-win32-renderer.h
+++ b/cogl/cogl-win32-renderer.h
@@ -35,6 +35,7 @@ COGL_BEGIN_DECLS
 
 /**
  * cogl_win32_renderer_handle_event:
+ * @renderer: a #CoglRenderer
  * @message: A pointer to a win32 MSG struct
  *
  * This function processes a single event; it can be used to hook into
@@ -66,6 +67,9 @@ typedef CoglFilterReturn (* CoglWin32FilterFunc) (MSG *message,
 
 /**
  * cogl_win32_renderer_add_filter:
+ * @renderer: a #CoglRenderer
+ * @func: the callback function
+ * @data: user data passed to @func when called
  *
  * Adds a callback function that will receive all native events. The
  * function can stop further processing of the event by return
@@ -78,6 +82,9 @@ cogl_win32_renderer_add_filter (CoglRenderer *renderer,
 
 /**
  * cogl_win32_renderer_remove_filter:
+ * @renderer: a #CoglRenderer
+ * @func: the callback function
+ * @data: user data given when the callback was installed
  *
  * Removes a callback that was previously added with
  * cogl_win32_renderer_add_filter().
diff --git a/cogl/cogl-xlib-renderer.h b/cogl/cogl-xlib-renderer.h
index a9277c6..db25b4e 100644
--- a/cogl/cogl-xlib-renderer.h
+++ b/cogl/cogl-xlib-renderer.h
@@ -37,6 +37,7 @@ COGL_BEGIN_DECLS
 
 /*
  * cogl_xlib_renderer_handle_event:
+ * @renderer: a #CoglRenderer
  * @event: pointer to an XEvent structure
  *
  * This function processes a single event; it can be used to hook into
@@ -56,7 +57,7 @@ cogl_xlib_renderer_handle_event (CoglRenderer *renderer,
 /*
  * CoglXlibFilterFunc:
  * @event: pointer to an XEvent structure
- * @data: The data that was given when the filter was added
+ * @data: the data that was given when the filter was added
  *
  * A callback function that can be registered with
  * cogl_xlib_renderer_add_filter(). The function should return
@@ -68,6 +69,9 @@ typedef CoglFilterReturn (* CoglXlibFilterFunc) (XEvent *event,
 
 /*
  * cogl_xlib_renderer_add_filter:
+ * @renderer: a #CoglRenderer
+ * @func: the callback function
+ * @data: user data passed to @func when called
  *
  * Adds a callback function that will receive all native events. The
  * function can stop further processing of the event by return
@@ -80,6 +84,9 @@ cogl_xlib_renderer_add_filter (CoglRenderer *renderer,
 
 /*
  * cogl_xlib_renderer_remove_filter:
+ * @renderer: a #CoglRenderer
+ * @func: the callback function
+ * @data: user data given when the callback was installed
  *
  * Removes a callback that was previously added with
  * cogl_xlib_renderer_add_filter().
@@ -91,6 +98,7 @@ cogl_xlib_renderer_remove_filter (CoglRenderer *renderer,
 
 /*
  * cogl_xlib_renderer_get_foreign_display:
+ * @renderer: a #CoglRenderer
  *
  * Return value: the foreign Xlib display that will be used by any Xlib based
  * winsys backend. The display needs to be set with
@@ -101,6 +109,7 @@ cogl_xlib_renderer_get_foreign_display (CoglRenderer *renderer);
 
 /*
  * cogl_xlib_renderer_set_foreign_display:
+ * @renderer: a #CoglRenderer
  *
  * Sets a foreign Xlib display that Cogl will use for and Xlib based winsys
  * backend.
@@ -117,7 +126,7 @@ cogl_xlib_renderer_set_foreign_display (CoglRenderer *renderer,
 
 /**
  * cogl_xlib_renderer_set_event_retrieval_enabled:
- * @renderer: A #CoglRenderer
+ * @renderer: a #CoglRenderer
  * @enable: The new value
  *
  * Sets whether Cogl should automatically retrieve events from the X