diff --git a/ges/ges-formatter.c b/ges/ges-formatter.c
index 05f3dd3362..d59ada245c 100644
--- a/ges/ges-formatter.c
+++ b/ges/ges-formatter.c
@@ -235,9 +235,10 @@ ges_formatter_set_data (GESFormatter * formatter, void *data, gsize length)
  * @formatter: a #GESFormatter
  * @length: location into which to store the size of the data in bytes.
  *
+ * Lets you get the data @formatter used for loading.
+ *
  * Returns: a pointer to the data.
  */
-
 void *
 ges_formatter_get_data (GESFormatter * formatter, gsize * length)
 {
diff --git a/ges/ges-keyfile-formatter.c b/ges/ges-keyfile-formatter.c
index feec4e6b6f..943c70c0fd 100644
--- a/ges/ges-keyfile-formatter.c
+++ b/ges/ges-keyfile-formatter.c
@@ -52,6 +52,13 @@ ges_keyfile_formatter_init (GESKeyfileFormatter * object)
 {
 }
 
+/**
+ * ges_keyfile_formatter_new:
+ *
+ * Creates a new #GESKeyfileFormatter.
+ *
+ * Returns: The newly created #GESKeyfileFormatter.
+ */
 GESKeyfileFormatter *
 ges_keyfile_formatter_new (void)
 {
diff --git a/ges/ges-timeline-file-source.c b/ges/ges-timeline-file-source.c
index 33b248d56f..2df3e170cf 100644
--- a/ges/ges-timeline-file-source.c
+++ b/ges/ges-timeline-file-source.c
@@ -285,7 +285,6 @@ ges_timeline_filesource_set_supported_formats (GESTimelineFileSource * self,
  * @is_image: %TRUE if @self is a still image, %FALSE otherwize
  *
  * Sets whether the timeline object is a still image or not.
- *
  */
 void
 ges_timeline_filesource_set_is_image (GESTimelineFileSource * self,
@@ -298,8 +297,9 @@ ges_timeline_filesource_set_is_image (GESTimelineFileSource * self,
  * ges_timeline_filesource_is_muted:
  * @self: the #GESTimelineFileSource 
  *
- * Returns: %TRUE if the audio track of @self is muted, %FALSE otherwize.
+ * Lets you know if the audio track of @self is muted or not.
  *
+ * Returns: %TRUE if the audio track of @self is muted, %FALSE otherwize.
  */
 gboolean
 ges_timeline_filesource_is_muted (GESTimelineFileSource * self)
@@ -311,8 +311,9 @@ ges_timeline_filesource_is_muted (GESTimelineFileSource * self)
  * ges_timeline_filesource_get_max_duration:
  * @self: the #GESTimelineFileSource 
  *
- * Returns: The duration of @self.
+ * Get the duration of the object.
  *
+ * Returns: The duration of @self.
  */
 guint64
 ges_timeline_filesource_get_max_duration (GESTimelineFileSource * self)
@@ -324,8 +325,9 @@ ges_timeline_filesource_get_max_duration (GESTimelineFileSource * self)
  * ges_timeline_filesource_is_image:
  * @self: the #GESTimelineFileSource 
  *
- * Returns: %TRUE if @self is a still image %FALSE otherwize.
+ * Lets you know if @self is an image or not.
  *
+ * Returns: %TRUE if @self is a still image %FALSE otherwize.
  */
 gboolean
 ges_timeline_filesource_is_image (GESTimelineFileSource * self)
@@ -337,8 +339,9 @@ ges_timeline_filesource_is_image (GESTimelineFileSource * self)
  * ges_timeline_filesource_get_uri:
  * @self: the #GESTimelineFileSource 
  *
- * Returns: The location of the ressource.
+ * Get the location of the ressource.
  *
+ * Returns: The location of the ressource.
  */
 const gchar *
 ges_timeline_filesource_get_uri (GESTimelineFileSource * self)
@@ -350,8 +353,9 @@ ges_timeline_filesource_get_uri (GESTimelineFileSource * self)
  * ges_timeline_filesource_get_supported_formats:
  * @self: the #GESTimelineFileSource 
  *
- * Returns: The formats supported by @self.
+ * Get the formats supported by @self.
  *
+ * Returns: The formats supported by @self.
  */
 GESTrackType
 ges_timeline_filesource_get_supported_formats (GESTimelineFileSource * self)
diff --git a/ges/ges-timeline-layer.c b/ges/ges-timeline-layer.c
index 05e58e1a8a..ca10a72456 100644
--- a/ges/ges-timeline-layer.c
+++ b/ges/ges-timeline-layer.c
@@ -373,7 +373,9 @@ ges_timeline_layer_set_priority (GESTimelineLayer * layer, guint priority)
  * ges_timeline_layer_get_priority:
  * @layer: a #GESTimelineLayer
  *
- * Returns: the priority of the @layer within the timeline.
+ * Get the priority of @layer within the timeline.
+ *
+ * Returns: The priority of the @layer within the timeline.
  */
 guint
 ges_timeline_layer_get_priority (GESTimelineLayer * layer)
diff --git a/ges/ges-timeline-object.c b/ges/ges-timeline-object.c
index 9283eb4ba4..eb694f258e 100644
--- a/ges/ges-timeline-object.c
+++ b/ges/ges-timeline-object.c
@@ -711,6 +711,8 @@ ges_timeline_object_get_layer (GESTimelineObject * object)
  * ges_timeline_object_get_track_objects:
  * @object: a #GESTimelineObject
  *
+ * Get the list of #GESTrackObject contained in @object
+ *
  * Returns: (transfer full) (element-type GESTrackObject): The list of
  * trackobject contained in @object.
  * The user is responsible for unreffing the contained objects 
diff --git a/ges/ges-timeline-standard-transition.c b/ges/ges-timeline-standard-transition.c
index 2a2e3453a7..325a9279eb 100644
--- a/ges/ges-timeline-standard-transition.c
+++ b/ges/ges-timeline-standard-transition.c
@@ -188,8 +188,11 @@ ges_tl_transition_create_track_object (GESTimelineObject * obj,
  * ges_timeline_standard_transition_new:
  * @vtype: the type of transition to create
  *
+ * Creates a new #GESTimelineStandardTransition.
+ *
+ * Returns: a newly created #GESTimelineStandardTransition, or %NULL if something
+ * went wrong.
  */
-
 GESTimelineStandardTransition *
 ges_timeline_standard_transition_new (GESVideoStandardTransitionType vtype)
 {
@@ -200,6 +203,11 @@ ges_timeline_standard_transition_new (GESVideoStandardTransitionType vtype)
 /**
  * ges_timeline_standard_transition_new_for_nick:
  * @nick: a string representing the type of transition to create
+ *
+ * Creates a new #GESTimelineStandardTransition for the provided @nick.
+ *
+ * Returns: The newly created #GESTimelineStandardTransition, or %NULL if something
+ * went wrong
  */
 
 GESTimelineStandardTransition *
diff --git a/ges/ges-timeline-test-source.c b/ges/ges-timeline-test-source.c
index 52956de8d8..6c44d857c9 100644
--- a/ges/ges-timeline-test-source.c
+++ b/ges/ges-timeline-test-source.c
@@ -294,9 +294,11 @@ ges_timeline_test_source_set_volume (GESTimelineTestSource * self,
 }
 
 /**
-* ges_timeline_test_source_get_vpattern:
+ * ges_timeline_test_source_get_vpattern:
  * @self: a #GESTimelineTestSource
  *
+ * Get the #GESVideoTestPattern which is applied on @self.
+ *
  * Returns: The #GESVideoTestPattern which is applied on @self.
  */
 GESVideoTestPattern
@@ -309,6 +311,8 @@ ges_timeline_test_source_get_vpattern (GESTimelineTestSource * self)
  * ges_timeline_test_source_is_muted:
  * @self: a #GESTimelineTestSource
  *
+ * Let you know if the audio track of @self is muted or not.
+ *
  * Returns: Whether the audio track of @self is muted or not.
  */
 gboolean
@@ -321,6 +325,8 @@ ges_timeline_test_source_is_muted (GESTimelineTestSource * self)
  * ges_timeline_test_source_get_frequency:
  * @self: a #GESTimelineTestSource
  *
+ * Get the frequency @self generates.
+ *
  * Returns: The frequency @self generates. See audiotestsrc element.
  */
 gdouble
@@ -333,8 +339,9 @@ ges_timeline_test_source_get_frequency (GESTimelineTestSource * self)
  * ges_timeline_test_source_get_volume:
  * @self: a #GESTimelineTestSource
  *
- * Returns: The volume of the test audio signal applied on @self.
+ * Get the volume of the test audio signal applied on @self.
  *
+ * Returns: The volume of the test audio signal applied on @self.
  */
 gdouble
 ges_timeline_test_source_get_volume (GESTimelineTestSource * self)
@@ -373,10 +380,9 @@ ges_timeline_test_source_create_track_object (GESTimelineObject * obj,
 }
 
 /**
- * ges_timeline_testsource_new:
- * @uri: the URI the source should control
+ * ges_timeline_test_source_new:
  *
- * Creates a new #GESTimelineTestSource for the provided @uri.
+ * Creates a new #GESTimelineTestSource.
  *
  * Returns: The newly created #GESTimelineTestSource, or NULL if there was an
  * error.
@@ -388,6 +394,15 @@ ges_timeline_test_source_new (void)
   return g_object_new (GES_TYPE_TIMELINE_TEST_SOURCE, NULL);
 }
 
+/**
+ * ges_timeline_test_source_new_for_nick:
+ * @nick: the nickname for which to create the #GESTimelineTestSource
+ *
+ * Creates a new #GESTimelineTestSource for the provided @nick.
+ *
+ * Returns: The newly created #GESTimelineTestSource, or NULL if there was an
+ * error.
+ */
 GESTimelineTestSource *
 ges_timeline_test_source_new_for_nick (gchar * nick)
 {
diff --git a/ges/ges-timeline-text-overlay.c b/ges/ges-timeline-text-overlay.c
index c2c75044e5..34964b00ef 100644
--- a/ges/ges-timeline-text-overlay.c
+++ b/ges/ges-timeline-text-overlay.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:ges-timeline-text-overlay
  * @short_description: Render text onto another stream in a #GESTimelineLayer
- * 
+ *
  * Renders text onto the next lower priority stream using textrender.
  */
 
@@ -341,6 +341,8 @@ ges_timeline_text_overlay_set_valign (GESTimelineTextOverlay * self,
  * ges_timeline_text_overlay_get_text:
  * @self: a #GESTimelineTextOverlay
  *
+ * Get the text currently set on @self.
+ *
  * Returns: The text currently set on @self.
  *
  */
@@ -354,6 +356,8 @@ ges_timeline_text_overlay_get_text (GESTimelineTextOverlay * self)
  * ges_timeline_text_overlay_get_font_desc:
  * @self: a #GESTimelineTextOverlay
  *
+ * Get the pango font description used by @self.
+ *
  * Returns: The pango font description used by @self.
  */
 const char *
@@ -366,6 +370,8 @@ ges_timeline_text_overlay_get_font_desc (GESTimelineTextOverlay * self)
  * ges_timeline_text_overlay_get_halignment:
  * @self: a #GESTimelineTextOverlay
  *
+ * Get the horizontal aligment used by @self.
+ *
  * Returns: The horizontal aligment used by @self.
  */
 GESTextHAlign
@@ -378,6 +384,8 @@ ges_timeline_text_overlay_get_halignment (GESTimelineTextOverlay * self)
  * ges_timeline_text_overlay_get_valignment:
  * @self: a #GESTimelineTextOverlay
  *
+ * Get the vertical aligment used by @self.
+ *
  * Returns: The vertical aligment used by @self.
  */
 GESTextVAlign
@@ -412,7 +420,7 @@ ges_timeline_text_overlay_create_track_object (GESTimelineObject * obj,
 }
 
 /**
- * ges_timeline_titlesource_new:
+ * ges_timeline_text_overlay_new:
  *
  * Creates a new #GESTimelineTextOverlay
  *
diff --git a/ges/ges-timeline-title-source.c b/ges/ges-timeline-title-source.c
index f62267a367..28c3dec90a 100644
--- a/ges/ges-timeline-title-source.c
+++ b/ges/ges-timeline-title-source.c
@@ -393,7 +393,9 @@ ges_timeline_title_source_set_mute (GESTimelineTitleSource * self,
  * ges_timeline_title_source_get_text:
  * @self: a #GESTimelineTitleSource
  *
- * Returns: The text currently set on the @self.
+ * Get the text currently set on @self.
+ *
+ * Returns: The text currently set on @self.
  *
  */
 const gchar *
@@ -406,7 +408,9 @@ ges_timeline_title_source_get_text (GESTimelineTitleSource * self)
  * ges_timeline_title_source_get_font_desc:
  * @self: a #GESTimelineTitleSource
  *
- * Returns: The pango font description used by the @self.
+ * Get the pango font description used by @self.
+ *
+ * Returns: The pango font description used by @self.
  *
  */
 const char *
@@ -419,6 +423,8 @@ ges_timeline_title_source_get_font_desc (GESTimelineTitleSource * self)
  * ges_timeline_title_source_get_halignment:
  * @self: a #GESTimelineTitleSource
  *
+ * Get the horizontal aligment used by @self.
+ *
  * Returns: The horizontal aligment used by @self.
  *
  */
@@ -432,6 +438,8 @@ ges_timeline_title_source_get_halignment (GESTimelineTitleSource * self)
  * ges_timeline_title_source_get_valignment:
  * @self: a #GESTimelineTitleSource
  *
+ * Get the vertical aligment used by @self.
+ *
  * Returns: The vertical aligment used by @self.
  *
  */
@@ -446,6 +454,8 @@ ges_timeline_title_source_get_valignment (GESTimelineTitleSource * self)
  * ges_timeline_title_source_is_muted:
  * @self: a #GESTimelineTitleSource
  *
+ * Let you know if the audio track of @self is muted or not.
+ *
  * Returns: Whether the audio track of @self is muted or not.
  *
  */
diff --git a/ges/ges-timeline.c b/ges/ges-timeline.c
index 9a7ad48970..c49d513d0a 100644
--- a/ges/ges-timeline.c
+++ b/ges/ges-timeline.c
@@ -975,6 +975,8 @@ ges_timeline_get_tracks (GESTimeline * timeline)
  * ges_timeline_get_layers:
  * @timeline: a #GESTimeline
  *
+ * Get the list of #GESTimelineLayer present in the Timeline.
+ *
  * Returns: (transfer full) (element-type GESTimelineLayer): the list of
  * #GESTimelineLayer present in the Timeline.
  * The caller should unref each Layer once he is done with them.
diff --git a/ges/ges-track-audio-test-source.c b/ges/ges-track-audio-test-source.c
index 751061741d..6abd037d53 100644
--- a/ges/ges-track-audio-test-source.c
+++ b/ges/ges-track-audio-test-source.c
@@ -112,6 +112,13 @@ ges_track_audio_test_source_create_element (GESTrackObject * trksrc)
   return ret;
 }
 
+/**
+ * ges_track_audio_test_source_set_freq:
+ * @self: a #GESTrackAudioTestSource
+ * @freq: The frequency you want to apply on @self
+ *
+ * Lets you set the frequency applied on the track object
+ */
 void
 ges_track_audio_test_source_set_freq (GESTrackAudioTestSource * self,
     gdouble freq)
@@ -123,6 +130,13 @@ ges_track_audio_test_source_set_freq (GESTrackAudioTestSource * self,
     g_object_set (element, "freq", (gdouble) freq, NULL);
 }
 
+/**
+ * ges_track_audio_test_source_set_volume:
+ * @self: a #GESTrackAudioTestSource
+ * @volume: The volume you want to apply on @self
+ *
+ * Sets the volume of the test audio signal.
+ */
 void
 ges_track_audio_test_source_set_volume (GESTrackAudioTestSource * self,
     gdouble volume)
@@ -138,7 +152,9 @@ ges_track_audio_test_source_set_volume (GESTrackAudioTestSource * self,
  * ges_track_audio_test_source_get_freq:
  * @self: a #GESTrackAudioTestSource
  *
- * Returns: The current frequency of @self
+ * Get the current frequency of @self.
+ *
+ * Returns: The current frequency of @self.
  */
 double
 ges_track_audio_test_source_get_freq (GESTrackAudioTestSource * self)
@@ -149,6 +165,8 @@ ges_track_audio_test_source_get_freq (GESTrackAudioTestSource * self)
 /**
  * ges_track_audio_test_source_get_volume:
  * @self: a #GESTrackAudioTestSource
+ * 
+ * Get the current volume of @self.
  *
  * Returns: The current volume of @self
  */
@@ -158,6 +176,13 @@ ges_track_audio_test_source_get_volume (GESTrackAudioTestSource * self)
   return self->priv->volume;
 }
 
+/**
+ * ges_track_audio_test_source_new:
+ *
+ * Creates a new #GESTrackAudioTestSource.
+ *
+ * Returns: The newly created #GESTrackAudioTestSource.
+ */
 GESTrackAudioTestSource *
 ges_track_audio_test_source_new (void)
 {
diff --git a/ges/ges-track-audio-transition.c b/ges/ges-track-audio-transition.c
index de5bc7dc48..95341e89f9 100644
--- a/ges/ges-track-audio-transition.c
+++ b/ges/ges-track-audio-transition.c
@@ -290,6 +290,13 @@ ges_track_audio_transition_duration_changed (GESTrackObject * object,
   GST_LOG ("done updating controller");
 }
 
+/**
+ * ges_track_audio_transition_new:
+ *
+ * Creates a new #GESTrackAudioTransition.
+ *
+ * Returns: The newly created #GESTrackAudioTransition.
+ */
 GESTrackAudioTransition *
 ges_track_audio_transition_new (void)
 {
diff --git a/ges/ges-track-filesource.c b/ges/ges-track-filesource.c
index db810b508b..85b9cb2604 100644
--- a/ges/ges-track-filesource.c
+++ b/ges/ges-track-filesource.c
@@ -126,6 +126,15 @@ ges_track_filesource_init (GESTrackFileSource * self)
       GES_TYPE_TRACK_FILESOURCE, GESTrackFileSourcePrivate);
 }
 
+/**
+ * ges_track_filesource_new:
+ * @uri: the URI the source should control
+ *
+ * Creates a new #GESTrackFileSource for the provided @uri.
+ *
+ * Returns: The newly created #GESTrackFileSource, or %NULL if there was an
+ * error.
+ */
 GESTrackFileSource *
 ges_track_filesource_new (gchar * uri)
 {
diff --git a/ges/ges-track-image-source.c b/ges/ges-track-image-source.c
index dd5ce0c0ef..2ea9fd51df 100644
--- a/ges/ges-track-image-source.c
+++ b/ges/ges-track-image-source.c
@@ -177,6 +177,14 @@ ges_track_image_source_init (GESTrackImageSource * self)
       GES_TYPE_TRACK_IMAGE_SOURCE, GESTrackImageSourcePrivate);
 }
 
+/**
+ * ges_track_image_source_new:
+ * @uri: the URI the source should control
+ *
+ * Creates a new #GESTrackImageSource for the provided @uri.
+ *
+ * Returns: A new #GESTrackImageSource.
+ */
 GESTrackImageSource *
 ges_track_image_source_new (gchar * uri)
 {
diff --git a/ges/ges-track-object.c b/ges/ges-track-object.c
index e398008dfc..e911b771dd 100644
--- a/ges/ges-track-object.c
+++ b/ges/ges-track-object.c
@@ -714,6 +714,8 @@ ges_track_object_set_track (GESTrackObject * object, GESTrack * track)
  * ges_track_object_get_track:
  * @object: a #GESTrackObject
  *
+ * Get the #GESTrack to which this object belongs. 
+ *
  * Returns: (transfer none): The #GESTrack to which this object belongs. Can be %NULL if it
  * is not in any track
  */
@@ -739,6 +741,8 @@ ges_track_object_set_timeline_object (GESTrackObject * object,
  * ges_track_object_get_timeline_object:
  * @object: a #GESTrackObject
  *
+ * Get the #GESTimelineObject which is controlling this track object
+ *
  * Returns: (transfer none): the #GESTimelineObject which is controlling
  * this track object
  */
@@ -754,6 +758,8 @@ ges_track_object_get_timeline_object (GESTrackObject * object)
  * ges_track_object_get_gnlobject:
  * @object: a #GESTrackObject
  *
+ * Get the GNonLin object this object is controlling.
+ *
  * Returns: (transfer none): the GNonLin object this object is controlling.
  */
 GstElement *
@@ -766,6 +772,8 @@ ges_track_object_get_gnlobject (GESTrackObject * object)
  * ges_track_object_get_element:
  * @object: a #GESTrackObject
  *
+ * Get the #GstElement this track object is controlling within GNonLin.
+ *
  * Returns: (transfer none): the #GstElement this track object is controlling
  * within GNonLin.
  */
@@ -794,6 +802,8 @@ ges_track_object_set_locked (GESTrackObject * object, gboolean locked)
  * ges_track_object_is_locked:
  * @object: a #GESTrackObject
  *
+ * Let you know if object us locked or not (moving synchronously).
+ *
  * Returns: %TRUE if the object is moving synchronously to its controlling
  * #GESTimelineObject, else %FALSE.
  */
diff --git a/ges/ges-track-text-overlay.c b/ges/ges-track-text-overlay.c
index 7efbc207b6..722b2f92d8 100644
--- a/ges/ges-track-text-overlay.c
+++ b/ges/ges-track-text-overlay.c
@@ -184,7 +184,6 @@ ges_track_text_overlay_create_element (GESTrackObject * object)
  * Sets the text this track object will render.
  *
  */
-
 void
 ges_track_text_overlay_set_text (GESTrackTextOverlay * self, const gchar * text)
 {
@@ -201,10 +200,10 @@ ges_track_text_overlay_set_text (GESTrackTextOverlay * self, const gchar * text)
  * @self: the #GESTrackTextOverlay
  * @font_desc: the pango font description
  *
- * Sets the text this track object will render.
+ * Sets the pango font description of the text this track object
+ * will render.
  *
  */
-
 void
 ges_track_text_overlay_set_font_desc (GESTrackTextOverlay * self,
     const gchar * font_desc)
@@ -219,11 +218,13 @@ ges_track_text_overlay_set_font_desc (GESTrackTextOverlay * self,
 }
 
 /**
- * ges_track_text_overlay_valignment:
+ * ges_track_text_overlay_set_valignment:
  * @self: the #GESTrackTextOverlay* to set text on
- * @valign: #GESTextVAlign
+ * @valign: The #GESTextVAlign defining the vertical alignment
+ * of the text render by @self.
  *
  * Sets the vertical aligment of the text.
+ *
  */
 void
 ges_track_text_overlay_set_valignment (GESTrackTextOverlay * self,
@@ -236,11 +237,13 @@ ges_track_text_overlay_set_valignment (GESTrackTextOverlay * self,
 }
 
 /**
- * ges_track_text_overlay_halignment:
+ * ges_track_text_overlay_set_halignment:
  * @self: the #GESTrackTextOverlay* to set text on
- * @halign: #GESTextHAlign
+ * @halign: The #GESTextHAlign defining the horizontal alignment
+ * of the text render by @self.
+ *
+ * Sets the horizontal aligment of the text.
  *
- * Sets the vertical aligment of the text.
  */
 void
 ges_track_text_overlay_set_halignment (GESTrackTextOverlay * self,
@@ -256,8 +259,10 @@ ges_track_text_overlay_set_halignment (GESTrackTextOverlay * self,
  * ges_track_text_overlay_get_text:
  * @self: a GESTrackTextOverlay
  *
- * Returns: The text currently set on the @source.
- * */
+ * Get the text currently set on @source.
+ *
+ * Returns: The text currently set on @source.
+ */
 const gchar *
 ges_track_text_overlay_get_text (GESTrackTextOverlay * self)
 {
@@ -268,7 +273,9 @@ ges_track_text_overlay_get_text (GESTrackTextOverlay * self)
  * ges_track_text_overlay_get_font_desc:
  * @self: a GESTrackTextOverlay
  *
- * Returns: The pango font description used by the @source.
+ * Get the pango font description currently set on @source.
+ *
+ * Returns: The pango font description currently set on @source.
  */
 const char *
 ges_track_text_overlay_get_font_desc (GESTrackTextOverlay * self)
@@ -280,6 +287,8 @@ ges_track_text_overlay_get_font_desc (GESTrackTextOverlay * self)
  * ges_track_text_overlay_get_halignment:
  * @self: a GESTrackTextOverlay
  *
+ * Get the horizontal aligment used by @source.
+ *
  * Returns: The horizontal aligment used by @source.
  */
 GESTextHAlign
@@ -292,6 +301,8 @@ ges_track_text_overlay_get_halignment (GESTrackTextOverlay * self)
  * ges_track_text_overlay_get_valignment:
  * @self: a GESTrackTextOverlay
  *
+ * Get the vertical aligment used by @source.
+ *
  * Returns: The vertical aligment used by @source.
  */
 GESTextVAlign
@@ -300,6 +311,14 @@ ges_track_text_overlay_get_valignment (GESTrackTextOverlay * self)
   return self->priv->valign;
 }
 
+/**
+ * ges_track_text_overlay_new:
+ *
+ * Creates a new #GESTrackTextOverlay.
+ *
+ * Returns: The newly created #GESTrackTextOverlay or %NULL if something went
+ * wrong.
+ */
 GESTrackTextOverlay *
 ges_track_text_overlay_new (void)
 {
diff --git a/ges/ges-track-text-overlay.h b/ges/ges-track-text-overlay.h
index baa79ffc96..6ae3315561 100644
--- a/ges/ges-track-text-overlay.h
+++ b/ges/ges-track-text-overlay.h
@@ -77,7 +77,7 @@ void ges_track_text_overlay_set_font_desc(GESTrackTextOverlay *self,
                                           const gchar *font_desc);
 
 void ges_track_text_overlay_set_halignment(GESTrackTextOverlay *self,
-                                           GESTextHAlign halgn);
+                                           GESTextHAlign halign);
 
 void ges_track_text_overlay_set_valignment(GESTrackTextOverlay *self,
                                            GESTextVAlign valign);
diff --git a/ges/ges-track-title-source.c b/ges/ges-track-title-source.c
index 3f55b38425..3fc068bc3d 100644
--- a/ges/ges-track-title-source.c
+++ b/ges/ges-track-title-source.c
@@ -253,6 +253,8 @@ ges_track_title_source_set_halignment (GESTrackTitleSource * self,
  * ges_track_title_source_get_text:
  * @source: a #GESTrackTitleSource
  *
+ * Get the text currently set on the @source.
+ *
  * Returns: (transfer none): The text currently set on the @source.
  */
 const gchar *
@@ -265,6 +267,8 @@ ges_track_title_source_get_text (GESTrackTitleSource * source)
  * ges_track_title_source_get_font_desc:
  * @source: a #GESTrackTitleSource
  *
+ * Get the pango font description used by @source.
+ *
  * Returns: (transfer none): The pango font description used by this
  * @source.
  */
@@ -278,6 +282,8 @@ ges_track_title_source_get_font_desc (GESTrackTitleSource * source)
  * ges_track_title_source_get_halignment:
  * @source: a #GESTrackTitleSource
  *
+ * Get the horizontal aligment used by this source.
+ *
  * Returns: The horizontal aligment used by this source.
  */
 GESTextHAlign
@@ -290,6 +296,8 @@ ges_track_title_source_get_halignment (GESTrackTitleSource * source)
  * ges_track_title_source_get_valignment:
  * @source: a #GESTrackTitleSource
  *
+ * Get the vertical aligment used by this source.
+ *
  * Returns: The vertical aligment used by this source.
  */
 GESTextVAlign
@@ -299,6 +307,14 @@ ges_track_title_source_get_valignment (GESTrackTitleSource * source)
 }
 
 
+/**
+ * ges_track_title_source_new:
+ *
+ * Creates a new #GESTrackTitleSource.
+ *
+ * Returns: The newly created #GESTrackTitleSource, or %NULL if there was an
+ * error.
+ */
 GESTrackTitleSource *
 ges_track_title_source_new (void)
 {
diff --git a/ges/ges-track-video-test-source.c b/ges/ges-track-video-test-source.c
index 8803cec448..d9668f2d10 100644
--- a/ges/ges-track-video-test-source.c
+++ b/ges/ges-track-video-test-source.c
@@ -95,7 +95,9 @@ ges_track_video_test_source_set_pattern (GESTrackVideoTestSource
  * ges_track_video_test_source_get_pattern:
  * @source: a #GESVideoTestPattern
  *
- * Returns: the video pattern used by the @source.
+ * Get the video pattern used by the @source.
+ *
+ * Returns: The video pattern used by the @source.
  */
 GESVideoTestPattern
 ges_track_video_test_source_get_pattern (GESTrackVideoTestSource * source)
@@ -103,6 +105,14 @@ ges_track_video_test_source_get_pattern (GESTrackVideoTestSource * source)
   return source->priv->pattern;
 }
 
+/**
+ * ges_track_video_test_source_new:
+ *
+ * Creates a new #GESTrackVideoTestSource.
+ *
+ * Returns: The newly created #GESTrackVideoTestSource, or %NULL if there was an
+ * error.
+ */
 GESTrackVideoTestSource *
 ges_track_video_test_source_new (void)
 {
diff --git a/ges/ges-track-video-transition.c b/ges/ges-track-video-transition.c
index 6f071d928e..e146795590 100644
--- a/ges/ges-track-video-transition.c
+++ b/ges/ges-track-video-transition.c
@@ -373,6 +373,8 @@ ges_track_video_transition_set_transition_type (GESTrackVideoTransition * self,
  * ges_track_video_transition_get_transition_type:
  * @trans: a #GESTrackVideoTransition
  *
+ * Get the transition type used by @trans.
+ *
  * Returns: The transition type used by @trans.
  */
 GESVideoStandardTransitionType
@@ -381,6 +383,14 @@ ges_track_video_transition_get_transition_type (GESTrackVideoTransition * trans)
   return trans->priv->type;
 }
 
+/**
+ * ges_track_video_transition_new:
+ *
+ * Creates a new #GESTrackVideoTransition.
+ *
+ * Returns: The newly created #GESTrackVideoTransition, or %NULL if there was an
+ * error.
+ */
 GESTrackVideoTransition *
 ges_track_video_transition_new (void)
 {
diff --git a/ges/ges-track.c b/ges/ges-track.c
index dea2b83aed..76521e0a2d 100644
--- a/ges/ges-track.c
+++ b/ges/ges-track.c
@@ -427,6 +427,8 @@ pad_removed_cb (GstElement * element, GstPad * pad, GESTrack * track)
  * ges_track_get_caps:
  * @track: a #GESTrack
  *
+ * Get the #GstCaps this track is configured to output.
+ *
  * Returns: The #GstCaps this track is configured to output.
  */
 const GstCaps *
@@ -441,6 +443,8 @@ ges_track_get_caps (GESTrack * track)
  * ges_track_get_timeline:
  * @track: a #GESTrack
  *
+ * Get the #GESTimeline this track belongs to. Can be %NULL.
+ *
  * Returns: The #GESTimeline this track belongs to. Can be %NULL.
  */
 const GESTimeline *