diff --git a/ges/ges-effect.h b/ges/ges-effect.h
index bc3c480714..0f83cb0d20 100644
--- a/ges/ges-effect.h
+++ b/ges/ges-effect.h
@@ -82,7 +82,7 @@ GESEffect*
 ges_effect_new (const gchar * bin_description);
 
 gboolean
-ges_effect_class_register_rate_property (GESEffectClass *klass, const gchar *element, const gchar *property_name);
+ges_effect_class_register_rate_property (GESEffectClass *klass, const gchar *element_name, const gchar *property_name);
 
 G_END_DECLS
 #endif /* _GES_EFFECT */
diff --git a/ges/ges-meta-container.c b/ges/ges-meta-container.c
index 4d48389e05..1c6da965b2 100644
--- a/ges/ges-meta-container.c
+++ b/ges/ges-meta-container.c
@@ -282,7 +282,7 @@ ges_meta_container_set_ ## name (GESMetaContainer *container,      \
  * ges_meta_container_set_boolean:
  * @container: Target container
  * @meta_item: Name of the meta item to set
- * @value: (allow-none): Value to set
+ * @value: Value to set
  *
  * Sets the value of a given meta item
  *
@@ -443,13 +443,12 @@ ges_meta_container_metas_to_string (GESMetaContainer * container)
 
 /**
  * ges_meta_container_add_metas_from_string:
- * @str: a string created with ges_meta_container_metas_to_string()
  * @container: Target container
+ * @str: a string created with ges_meta_container_metas_to_string()
  *
  * Deserializes a meta container.
  *
- * Returns: (transfer full): a new #GESMetaContainer, or NULL in case of an
- * error.
+ * Returns: TRUE on success, FALSE if there was an error.
  */
 gboolean
 ges_meta_container_add_metas_from_string (GESMetaContainer * container,
@@ -515,7 +514,7 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
  * @container: Target container
  * @flags: The #GESMetaFlag to be used
  * @meta_item: Name of the meta item to set
- * @value: (allow-none): Value to set
+ * @value: Value to set
  *
  * Sets a static meta on @container. This method lets you define static
  * metadatas, which means that the type of the registered will be the only
@@ -530,7 +529,7 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
  * @container: Target container
  * @flags: The #GESMetaFlag to be used
  * @meta_item: Name of the meta item to set
- * @value: (allow-none): Value to set
+ * @value: Value to set
  *
  * Sets a static meta on @container. This method lets you define static
  * metadatas, which means that the type of the registered will be the only
@@ -545,7 +544,7 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
  * @container: Target container
  * @flags: The #GESMetaFlag to be used
  * @meta_item: Name of the meta item to set
- * @value: (allow-none): Value to set
+ * @value: Value to set
  *
  * Sets a static meta on @container. This method lets you define static
  * metadatas, which means that the type of the registered will be the only
@@ -560,7 +559,7 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
  * @container: Target container
  * @flags: The #GESMetaFlag to be used
  * @meta_item: Name of the meta item to set
- * @value: (allow-none): Value to set
+ * @value: Value to set
  *
  * Sets a static meta on @container. This method lets you define static
  * metadatas, which means that the type of the registered will be the only
@@ -575,7 +574,7 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
  * @container: Target container
  * @flags: The #GESMetaFlag to be used
  * @meta_item: Name of the meta item to set
- * @value: (allow-none): Value to set
+ * @value: Value to set
  *
  * Sets a static meta on @container. This method lets you define static
  * metadatas, which means that the type of the registered will be the only
@@ -590,7 +589,7 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
  * @container: Target container
  * @flags: The #GESMetaFlag to be used
  * @meta_item: Name of the meta item to set
- * @value: (allow-none): Value to set
+ * @value: Value to set
  *
  * Sets a static meta on @container. This method lets you define static
  * metadatas, which means that the type of the registered will be the only
diff --git a/ges/ges-timeline.c b/ges/ges-timeline.c
index bc2b590d24..ea8441d385 100644
--- a/ges/ges-timeline.c
+++ b/ges/ges-timeline.c
@@ -2167,6 +2167,14 @@ timeline_add_group (GESTimeline * timeline, GESGroup * group)
   g_signal_emit (timeline, ges_timeline_signals[GROUP_ADDED], 0, group);
 }
 
+/**
+ * ges_timeline_emit_group_removed:
+ * @timeline: a #GESTimeline
+ * @group: group that was removed
+ * @array: (element-type GESTimelineElement): children that were removed
+ *
+ * Emit group-removed signal.
+ */
 void
 ges_timeline_emit_group_removed (GESTimeline * timeline, GESGroup * group,
     GPtrArray * array)