docs: Update documentation

diff --git a/docs/libs/ges-sections.txt b/docs/libs/ges-sections.txt
index f6e74b472ec973372f674f3505cc6e51bda57bb5..32686fce5bf3e96aac8cc63dc6302912c49df41a 100644 (file)
--- a/docs/libs/ges-sections.txt
+++ b/docs/libs/ges-sections.txt
@@ -51,6 +51,8 @@ ges_track_add_object
 ges_track_remove_object
 ges_track_set_caps
 ges_track_get_caps
+ges_track_enable_update
+ges_track_get_objects
 <SUBSECTION Standard>
 GESTrackClass
 GESTrackPrivate
@@ -242,6 +244,7 @@ ges_timeline_add_track
 ges_timeline_remove_track
 ges_timeline_load_from_uri
 ges_timeline_save_to_uri
+ges_timeline_enable_update
 <SUBSECTION usage>
 ges_timeline_get_tracks
 ges_timeline_get_layers
@@ -270,6 +273,8 @@ ges_timeline_layer_remove_object
 ges_timeline_layer_set_priority
 ges_timeline_layer_get_priority
 ges_timeline_layer_get_objects
+ges_timeline_layer_get_auto_transition
+ges_timeline_layer_set_auto_transition
 <SUBSECTION Standard>
 GESTimelineLayerPrivate
 ges_timeline_layer_set_timeline
@@ -303,6 +308,7 @@ ges_timeline_object_move_to_layer
 ges_timeline_object_set_top_effect_priority
 ges_timeline_object_set_supported_formats
 ges_timeline_object_get_supported_formats
+ges_timeline_object_split
 <SUBSECTION Standard>
 GES_TIMELINE_OBJECT_DURATION
 GES_TIMELINE_OBJECT_INPOINT
@@ -344,6 +350,10 @@ ges_timeline_pipeline_preview_set_video_sink
 ges_timeline_pipeline_get_thumbnail_buffer
 ges_timeline_pipeline_get_thumbnail_rgb24
 ges_timeline_pipeline_save_thumbnail
+ges_timeline_pipeline_preview_get_audio_sink
+ges_timeline_pipeline_preview_get_video_sink
+ges_timeline_pipeline_preview_set_audio_sink
+ges_timeline_pipeline_preview_set_video_sink
 <SUBSECTION Standard>
 GESTimelinePipelineClass
 GESTimelinePipelinePrivate

diff --git a/ges/ges-formatter.c b/ges/ges-formatter.c
index 1c2cbffb09ae05e75587c2b64a30883ef0e8440a..530733b2fbe692bc4f8436be7331608408583b1a 100644 (file)
--- a/ges/ges-formatter.c
+++ b/ges/ges-formatter.c
@@ -237,7 +237,7 @@ ges_formatter_set_data (GESFormatter * formatter, void *data, gsize length)
  *
  * Lets you get the data @formatter used for loading.
  *
- * Returns: a pointer to the data.
+ * Returns: (transfer none): a pointer to the data.
  */
 void *
 ges_formatter_get_data (GESFormatter * formatter, gsize * length)

diff --git a/ges/ges-timeline-layer.c b/ges/ges-timeline-layer.c
index 7a4f19e532803ff8481da7d5ccf3f418099d8010..4e635d52e7c0755483edae46815b4da813f06630 100644 (file)
--- a/ges/ges-timeline-layer.c
+++ b/ges/ges-timeline-layer.c
@@ -765,10 +765,10 @@ ges_timeline_layer_get_auto_transition (GESTimelineLayer * layer)
 /**
  * ges_timeline_layer_set_auto_transition:
  * @layer: a #GESTimelineLayer
- * @priority: whether the auto_transition is active
+ * @auto_transition: whether the auto_transition is active
  *
  * Sets the layer to the given @auto_transition. See the documentation of the
- * priority auto_transition for more information.
+ * property auto_transition for more information.
  */
 void
 ges_timeline_layer_set_auto_transition (GESTimelineLayer * layer,

diff --git a/ges/ges-timeline-object.c b/ges/ges-timeline-object.c
index 8938a2f2972fd8c2b70e17877790ef730199f801..dc7b69326c5fa5537ae4dcc0a99b7b5da6f38229 100644 (file)
--- a/ges/ges-timeline-object.c
+++ b/ges/ges-timeline-object.c
@@ -361,7 +361,7 @@ ges_timeline_object_class_init (GESTimelineObjectClass * klass)
    * @object: the #GESTimelineObject
    * @tckobj: the #GESTrackObject that was removed.
    *
-   * Will be emitted after a track object was added to the object.
+   * Will be emitted after a track object was removed from @object.
    *
    * Since: 0.10.2
    */

diff --git a/ges/ges-timeline-object.h b/ges/ges-timeline-object.h
index f682dfd4f849f3bfecac05f576b68a8def1c36b1..024b20e5d99836b165bca1974e5d8f73c196f094 100644 (file)
--- a/ges/ges-timeline-object.h
+++ b/ges/ges-timeline-object.h
@@ -291,7 +291,7 @@ ges_timeline_object_set_supported_formats (GESTimelineObject * self,
                                            GESTrackType supportedformats);
 
 GESTimelineObject *
-ges_timeline_object_split(GESTimelineObject * ref_object, gint64 position);
+ges_timeline_object_split(GESTimelineObject * self, gint64 position);
 
 G_END_DECLS
 

diff --git a/ges/ges-timeline.c b/ges/ges-timeline.c
index cac3145508ec12d5dba1a2c584d9ed12a9429157..83986c81f8a5f9179b1f82fab22060db5ae6a013 100644 (file)
--- a/ges/ges-timeline.c
+++ b/ges/ges-timeline.c
@@ -1110,12 +1110,12 @@ ges_timeline_get_layers (GESTimeline * timeline)
 
 /**
  * ges_timeline_enable_update:
- * @timeline : a #GESTimeline
- * @enabled : TRUE if the timeline must be updated, FALSE otherwise.
+ * @timeline: a #GESTimeline
+ * @enabled: TRUE if the timeline must be updated, FALSE otherwise.
  *
  * Calls the enable_update function of the tracks contained by the timeline.
  *
- * Returns : True if success, FALSE otherwise.
+ * Returns: True if success, FALSE otherwise.
  */
 gboolean
 ges_timeline_enable_update (GESTimeline * timeline, gboolean enabled)

diff --git a/ges/ges-track.c b/ges/ges-track.c
index 2e481f3f90a014f50a80a551a284592b8e596669..dccadb811497625fbb92134ddf38c482dd43321d 100644 (file)
--- a/ges/ges-track.c
+++ b/ges/ges-track.c
@@ -483,6 +483,15 @@ ges_track_add_object (GESTrack * track, GESTrackObject * object)
   return TRUE;
 }
 
+/**
+ * ges_track_get_objects:
+ * @track: a #GESTrack
+ *
+ * Gets the #GESTrackObject contained in @track
+ *
+ * Returns: (transfer full) (element-type GESTrackObject): the list of
+ * #GESTrackObject present in the Track sorted by priority and start.
+ */
 GList *
 ges_track_get_objects (GESTrack * track)
 {
@@ -652,12 +661,12 @@ ges_track_get_timeline (GESTrack * track)
 
 /**
  * ges_track_enable_update:
- * @track : a #GESTrack
- * @enabled : TRUE if the composition must be updated, FALSE otherwise.
+ * @track: a #GESTrack
+ * @enabled: %TRUE if the composition must be updated, FALSE otherwise.
  *
  * Sets the @track 's composition update property to @enabled .
  *
- * Returns : True if success, FALSE otherwise.
+ * Returns: True if success, %FALSE otherwise.
  */
 gboolean
 ges_track_enable_update (GESTrack * track, gboolean enabled)