2008-06-12 Emmanuele Bassi <ebassi@openedhand.com>

* doc/reference/cogl/Makefile.am: Ignore cogl/gl and cogl/gles
	when building the documentation.

	* clutter/cogl/cogl.h.in: Add sections in the header file.

cogl.h.in

@@ -217,17 +217,26 @@ struct _CoglTextureVertex
 
 typedef struct _CoglTextureVertex CoglTextureVertex;
 
+/**
+ * SECTION:cogl
+ * @short_description: General purpose API
+ *
+ * General utility functions for COGL.
+ */
+
 /* Context manipulation */
 
 /**
  * cogl_create_context:
  *
+ * FIXME
  */
 gboolean        cogl_create_context           (void);
 
 /**
  * cogl_destroy_context:
  *
+ * FIXME
  */
 void            cogl_destroy_context          (void);
 
@@ -235,7 +244,7 @@ void            cogl_destroy_context          (void);
 /**
  * COGL_INVALID_HANDLE:
  *
- * A cogl handle that is not valid, used for unitialized handles as well as
+ * A COGL handle that is not valid, used for unitialized handles as well as
  * error conditions.
  */
 #define COGL_INVALID_HANDLE NULL
@@ -555,6 +564,15 @@ void            cogl_fog_set                  (const ClutterColor *fog_color,
  */
 void            cogl_paint_init               (const ClutterColor *color);
 
+/**
+ * SECTION:cogl-texture
+ * @short_description: Fuctions for creating and manipulating textures
+ *
+ * COGL allows creating and manipulating GL textures using a uniform
+ * API that tries to hide all the various complexities of creating,
+ * loading and manipulating textures.
+ */
+
 /* Textures api */
 
 /**
@@ -1210,6 +1228,16 @@ void            cogl_path_round_rectangle     (ClutterFixed        x,
                                                ClutterFixed        radius,
                                                ClutterAngle        arc_step);
 
+/**
+ * SECTION:cogl-shaders
+ * @short_description: Fuctions for accessing the programmable GL pipeline
+ *
+ * COGL allows accessing the GL programmable pipeline in order to create
+ * vertex and fragment shaders.
+ *
+ * The only supported format is GLSL shaders.
+ */
+
 /**
  * cogl_create_shader:
  * @shader_type: CGL_VERTEX_SHADER or CGL_FRAGMENT_SHADER.
@@ -1396,6 +1424,14 @@ COGLint         cogl_program_get_uniform_location
 void            cogl_program_uniform_1f       (COGLint           uniform_no,
                                                gfloat            value);
 
+/**
+ * SECTION:cogl-offscreen
+ * @short_description: Fuctions for creating and manipulating offscreen
+ *   frame buffer objects
+ *
+ * COGL allows creating and operating on FBOs (Framebuffer Objects).
+ */
+
 /* Offscreen api */
 
 /**

doc/reference/cogl/Makefile.am

@@ -59,7 +59,9 @@ IGNORE_HFILES=\
 	cogl-defines.h \
 	cogl-internal.h \
 	cogl-primitives.h \
-	cogl-texture.h
+	cogl-texture.h \
+	gl \
+	gles
 
 EXTRA_HFILES=