docs: API reference fixes

clutter/clutter-timeout-pool.h

@@ -42,6 +42,10 @@ G_BEGIN_DECLS
 /**
  * ClutterTimeoutPool: (skip)
  *
+ * <structname>ClutterTimeoutPool</structname> is an opaque structure
+ * whose members cannot be directly accessed.
+ *
+ * Since: 0.6
  */
 typedef struct _ClutterTimeoutPool    ClutterTimeoutPool;
 

clutter/cogl/cogl/cogl-path.h

@@ -125,6 +125,8 @@ cogl_path_set_fill_rule (CoglPathFillRule fill_rule);
 /**
  * cogl_path_get_fill_rule:
  *
+ * Retrieves the fill rule set using cogl_path_set_fill_rule().
+ *
  * Return value: the fill rule that is used for the current path.
  *
  * Since: 1.4

clutter/cogl/cogl/winsys/cogl-texture-pixmap-x11.h

@@ -96,11 +96,13 @@ cogl_texture_pixmap_x11_update_area (CoglHandle handle,
  * cogl_texture_pixmap_x11_is_using_tfp_extension:
  * @handle: A CoglHandle to a CoglTexturePixmapX11 instance
  *
- * Return value: whether the texture is using the
+ * Checks whether the texture is using the GLX_EXT_texture_from_pixmap
- * GLX_EXT_texture_from_pixmap or similar extension to copy the
+ * or similar extension to copy the contents of the pixmap to the texture.
- * contents of the pixmap to the texture. This extension is usually
+ * This extension is usually implemented as zero-copy operation so it
- * implemented as zero-copy so it implies the updates are working
+ * implies the updates are working efficiently.
- * efficiently.
+ *
+ * Return value: %TRUE if the texture is using an efficient extension
+ *   and %FALSE otherwise
  *
  * Since: 1.4
  * Stability: Unstable
@@ -137,8 +139,10 @@ cogl_texture_pixmap_x11_set_damage_object (CoglHandle handle,
  * cogl_is_texture_pixmap_x11:
  * @handle: A CoglHandle
  *
- * Return value: whether @handle points to a CoglTexturePixmapX11
+ * Checks whether @handle points to a CoglTexturePixmapX11 instance.
- * instance.
+ *
+ * Return value: %TRUE if the handle is a CoglTexturePixmapX11, and
+ *   %FALSE otherwise
  *
  * Since: 1.4
  * Stability: Unstable

doc/reference/cally/cally-sections.txt

@@ -1,3 +1,21 @@
+<SECTION>
+<FILE>cally-stage</FILE>
+<TITLE>CallyStage</TITLE>
+CallyStage
+CallyStageClass
+cally_stage_new
+<SUBSECTION Standard>
+CALLY_STAGE
+CALLY_IS_STAGE
+CALLY_TYPE_STAGE
+CALLY_STAGE_CLASS
+CALLY_IS_STAGE_CLASS
+CALLY_STAGE_GET_CLASS
+<SUBSECTION Private>
+CallyStagePrivate
+cally_stage_get_type
+</SECTION>
+
 <SECTION>
 <FILE>cally-clone</FILE>
 <TITLE>CallyClone</TITLE>
@@ -127,24 +145,6 @@ CallyGroupPrivate
 cally_group_get_type
 </SECTION>
 
-<SECTION>
-<FILE>cally-stage</FILE>
-<TITLE>CallyStage</TITLE>
-CallyStage
-CallyStageClass
-cally_stage_new
-<SUBSECTION Standard>
-CALLY_STAGE
-CALLY_IS_STAGE
-CALLY_TYPE_STAGE
-CALLY_STAGE_CLASS
-CALLY_IS_STAGE_CLASS
-CALLY_STAGE_GET_CLASS
-<SUBSECTION Private>
-CallyStagePrivate
-cally_stage_get_type
-</SECTION>
-
 <SECTION>
 <FILE>cally-rectangle</FILE>
 <TITLE>CallyRectangle</TITLE>

doc/reference/clutter/clutter-sections.txt

@@ -911,10 +911,8 @@ CLUTTER_VALUE_HOLDS_FIXED
 clutter_value_set_fixed
 clutter_value_get_fixed
 
-<SUBSECTION Standard>
-ClutterTimeoutPool
-
 <SUBSECTION Private>
+ClutterTimeoutPool
 CLUTTER_TYPE_PARAM_FIXED
 CLUTTER_PARAM_SPEC_FIXED
 CLUTTER_IS_PARAM_SPEC_FIXED