From 3f492e60542ce8303c9863798a935d7967d6d16d Mon Sep 17 00:00:00 2001
From: Neil Roberts <neil@linux.intel.com>
Date: Tue, 9 Dec 2008 13:16:42 +0000
Subject: [PATCH] Add gtk-doc for cogl_texture_multiple_rectangles

---
 cogl-texture.h                       | 18 ++++++++++++++++++
 doc/reference/cogl/cogl-sections.txt |  1 +
 2 files changed, 19 insertions(+)

diff --git a/cogl-texture.h b/cogl-texture.h
index 5df2a818d..95e663084 100644
--- a/cogl-texture.h
+++ b/cogl-texture.h
@@ -385,6 +385,24 @@ void            cogl_texture_polygon          (CoglHandle          handle,
                                                CoglTextureVertex  *vertices,
                                                gboolean            use_color);
 
+/**
+ * cogl_texture_multiple_rectangles:
+ * @handle: a @CoglHandle.
+ * @verts: an array of vertices
+ * @n_rects: number of rectangles to draw
+ *
+ * Draws a series of rectangles in the same way that
+ * cogl_texture_rectangle() does. In some situations it can give a
+ * significant performance boost to use this function rather than
+ * calling cogl_texture_rectangle() separately for each rectangle.
+ *
+ * @verts should point to an array of #CoglFixed<!-- -->s with
+ * @n_rects * 8 elements. Each group of 8 values corresponds to the
+ * parameters x1, y1, x2, y2, tx1, ty1, tx2 and ty2 and have the same
+ * meaning as in cogl_texture_rectangle().
+ *
+ * Since: 1.0
+ */
 void            cogl_texture_multiple_rectangles
                                               (CoglHandle          handle,
                                                const CoglFixed    *verts,
diff --git a/doc/reference/cogl/cogl-sections.txt b/doc/reference/cogl/cogl-sections.txt
index 03247ff3c..dcd7c933f 100644
--- a/doc/reference/cogl/cogl-sections.txt
+++ b/doc/reference/cogl/cogl-sections.txt
@@ -120,6 +120,7 @@ cogl_texture_set_region
 cogl_texture_ref
 cogl_texture_unref
 cogl_texture_rectangle
+cogl_texture_multiple_rectangles
 cogl_texture_polygon
 </SECTION>