docs: Port all docstring to gtk-doc markdown
authorThibault Saunier <thibault.saunier@osg.samsung.com>
Wed, 8 Mar 2017 21:13:48 +0000 (18:13 -0300)
committerThibault Saunier <thibault.saunier@osg.samsung.com>
Wed, 8 Mar 2017 21:13:48 +0000 (18:13 -0300)
56 files changed:
ges/ges-asset.c
ges/ges-audio-source.c
ges/ges-audio-test-source.c
ges/ges-audio-track.c
ges/ges-audio-transition.c
ges/ges-audio-uri-source.c
ges/ges-base-effect-clip.c
ges/ges-base-effect.c
ges/ges-base-transition-clip.c
ges/ges-clip-asset.c
ges/ges-clip.c
ges/ges-container.c
ges/ges-container.h
ges/ges-effect-clip.c
ges/ges-effect.c
ges/ges-enums.c
ges/ges-extractable.c
ges/ges-formatter.c
ges/ges-gerror.h
ges/ges-group.c
ges/ges-image-source.c
ges/ges-layer.c
ges/ges-layer.h
ges/ges-multi-file-source.c
ges/ges-operation-clip.c
ges/ges-operation.c
ges/ges-overlay-clip.c
ges/ges-pipeline.c
ges/ges-pitivi-formatter.c
ges/ges-project.c
ges/ges-source-clip.c
ges/ges-source.c
ges/ges-test-clip.c
ges/ges-test-clip.h
ges/ges-text-overlay-clip.c
ges/ges-text-overlay-clip.h
ges/ges-text-overlay.c
ges/ges-timeline-element.c
ges/ges-timeline-element.h
ges/ges-timeline.c
ges/ges-title-clip.c
ges/ges-title-source.c
ges/ges-title-source.h
ges/ges-track-element-asset.c
ges/ges-track-element.c
ges/ges-track.c
ges/ges-transition-clip.c
ges/ges-transition.c
ges/ges-uri-asset.c
ges/ges-uri-clip.c
ges/ges-utils.c
ges/ges-video-source.c
ges/ges-video-test-source.c
ges/ges-video-track.c
ges/ges-video-transition.c
ges/ges-video-uri-source.c

index 00d44ac..60fde65 100644 (file)
@@ -20,6 +20,7 @@
  */
 /**
  * SECTION: gesasset
+ * @title: GESAsset
  * @short_description: Represents usable resources inside the GStreamer Editing Services
  *
  * The Assets in the GStreamer Editing Services represent the resources
index a52dbf8..b9fe562 100644 (file)
 
 /**
  * SECTION:gesaudiosource
+ * @title: GESAudioSource
  * @short_description: Base Class for audio sources
  *
  * <refsect1 id="GESVideoSource.children_properties" role="properties">
- * <title role="children_properties.title">Children Properties</title>
- * <para>You can use the following children properties through the
- * #ges_track_element_set_child_property and alike set of methods:</para>
+ * <title role="children_properties.title">Children Properties
+ * You can use the following children properties through the
+ * #ges_track_element_set_child_property and alike set of methods:
  * <informaltable frame="none">
  * <tgroup cols="3">
  * <colspec colname="properties_type" colwidth="150px"/>
index 5802bac..00fb448 100644 (file)
@@ -20,8 +20,9 @@
 
 /**
  * SECTION:gesaudiotestsource
+ * @title: GESAudioTestSource
  * @short_description: produce a simple test waveform or silence
- * 
+ *
  * Outputs a test audio stream using audiotestsrc. The default property values
  * output silence. Useful for testing pipelines, or to fill gaps in an audio
  * track.
index 5486e69..7ce1dbd 100644 (file)
@@ -19,6 +19,7 @@
 
 /**
  * SECTION: gesaudiotrack
+ * @title: GESAudioTrack
  * @short_description: A standard GESTrack for raw audio
  *
  * Sane default properties to specify and fixate the output stream are
index 5d26f2e..bc6703b 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gesaudiotransition
+ * @title: GESAudioTransition
  * @short_description: implements audio crossfade transition
  */
 
index 945ff03..1211a7f 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gesaudiourisource
+ * @title: GESAudioUriSource
  * @short_description: outputs a single audio stream from a given file
  */
 
index 7f1b038..763529a 100644 (file)
@@ -19,6 +19,7 @@
 
 /**
  * SECTION: gesbaseeffectclip
+ * @title: GESBaseEffectClip
  * @short_description: An effect in a GESLayer
  *
  * The effect will be applied on the sources that have lower priorities
index 044f200..5b71aaf 100644 (file)
@@ -19,6 +19,7 @@
 
 /**
  * SECTION:gesbaseeffect
+ * @title: GESBaseEffect
  * @short_description: adds an effect to a stream in a GESSourceClip or a
  * GESLayer
  */
index 15efa42..040894c 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION: gesbasetransitionclip
+ * @title: GESBaseTransitionClip
  * @short_description: Base classes for transitions
  */
 
index cac07ca..f0c66cd 100644 (file)
@@ -19,6 +19,7 @@
  */
 /**
  * SECTION: gesclipasset
+ * @title: GESClipAsset
  * @short_description: A GESAsset subclass specialized in GESClip extraction
  *
  * The #GESUriClipAsset is a special #GESAsset specilized in #GESClip.
index 67c5571..5a41180 100644 (file)
@@ -22,6 +22,7 @@
 
 /**
  * SECTION:gesclip
+ * @title: GESClip
  * @short_description: Base Class for objects in a GESLayer
  *
  * A #GESClip is a 'natural' object which controls one or more
@@ -1019,7 +1020,6 @@ ges_clip_set_moving_from_layer (GESClip * clip, gboolean is_moving)
  * You might rather use the ges_clip_move_to_layer function to
  * move #GESClip-s from a layer to another.
  *
- *
  * Returns: %TRUE if @clip is currently moving from its current layer
  * %FALSE otherwize
  **/
index 6a56457..543b03d 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gescontainer
+ * @title: GESContainer
  * @short_description: Base Class for objects responsible for controlling other
  * GESTimelineElement-s
  */
index 67ff0a9..39a731d 100644 (file)
@@ -70,7 +70,6 @@ typedef enum
  * controlled by this Container. NOTE: Do not modify.
  * @height: The span of priorities this container occupies
  *
- *
  * The #GESContainer base class.
  */
 struct _GESContainer
index 055504d..af99307 100644 (file)
@@ -19,6 +19,7 @@
 
 /**
  * SECTION: geseffectclip
+ * @title: GESEffectClip
  * @short_description: An effect created by parse-launch style bin descriptions
  * in a GESLayer
  *
index e4fc993..66c347f 100644 (file)
@@ -19,6 +19,7 @@
 
 /**
  * SECTION:geseffect
+ * @title: GESEffect
  * @short_description: adds an effect build from a parse-launch style
  * bin description to a stream in a GESSourceClip or a GESLayer
  */
index db545a8..440657e 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:ges-enums
+ * @title: GES Enumerations
  * @short_description: Various enums for the Gstreamer Editing Services
  */
 
index 0d6af61..77f56d6 100644 (file)
@@ -20,6 +20,7 @@
  */
 /**
  * SECTION: gesextractable
+ * @title: GESExtractable Interface
  * @short_description: An interface for objects which can be extracted from a GESAsset
  *
  * FIXME: Long description needed
index b0e8837..8dfdf06 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gesformatter
+ * @title: GESFormatter
  * @short_description: Timeline saving and loading.
  *
  **/
index 8391d5e..eaa60f9 100644 (file)
@@ -22,6 +22,7 @@
 
 /**
  * SECTION: ges-gerror
+ * @title: GESErrors
  * @short_description: GError â€” Categorized error messages
  */
 
index a23d257..0c0c0c7 100644 (file)
@@ -19,6 +19,7 @@
 
 /**
  * SECTION:gesgroup
+ * @title: GESGroup
  * @short_description: Class that permits to group GESClip-s in a timeline,
  * letting the user manage it a single GESTimelineElement
  *
index 157f2f0..619aa91 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gesimagesource
+ * @title: GESImageSource
  * @short_description: outputs the video stream from a media file as a still
  * image.
  *
index 606e3eb..a66759f 100644 (file)
@@ -22,6 +22,7 @@
 
 /**
  * SECTION:geslayer
+ * @title: GESLayer
  * @short_description: Non-overlapping sequence of GESClip
  *
  * Responsible for the ordering of the various contained Clip(s). A
index 5fbf0bd..4c4ef3b 100644 (file)
@@ -129,4 +129,3 @@ GstClockTime ges_layer_get_duration (GESLayer *layer);
 G_END_DECLS
 
 #endif /* _GES_LAYER */
-
index 6ac35b0..30cea55 100644 (file)
@@ -19,6 +19,7 @@
 
 /**
  * SECTION:gesmultifilesource
+ * @title: GESMultiFileSource
  * @short_description: outputs the video stream from a sequence of images.
  *
  * Outputs the video stream from a given image sequence. The start frame
index cb53dcc..445de76 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gesoperationclip
+ * @title: GESOperationClip
  * @short_description: Base Class for operations in a GESLayer
  *
  * Operations are any kind of object that both outputs AND consumes data.
index c412fbe..9bfb7bd 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gesoperation
+ * @title: GESOperation
  * @short_description: Base Class for effects and overlays
  */
 
index 6d3e8c4..52db863 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gesoverlayclip
+ * @title: GESOverlayClip
  * @short_description: Base Class for overlays in a GESLayer
  *
  * Overlays are objects which modify the underlying layer(s).
@@ -27,7 +28,7 @@
  * Examples of overlays include text, image watermarks, or audio dubbing.
  *
  * Transitions, which change from one source to another over time, are
- * not considered overlays. 
+ * not considered overlays.
  */
 
 #include "ges-internal.h"
index 2a81504..2391de6 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gespipeline
+ * @title: GESPipeline
  * @short_description: Convenience GstPipeline for editing.
  *
  * #GESPipeline allows developers to view and render #GESTimeline
index 8e7b5d3..ecd5f42 100644 (file)
@@ -19,6 +19,7 @@
 
 /**
  * SECTION: gespitiviformatter
+ * @title: GESPitiviFormatter
  * @short_description: A formatter for the obsolete Pitivi xptv project file format
  *
  * This is a legacy format and you should avoid to use it. The formatter
index 3c336ed..e92eabe 100644 (file)
@@ -19,6 +19,7 @@
  */
 /**
  * SECTION: gesproject
+ * @title: GESProject
  * @short_description: A GESAsset that is used to manage projects
  *
  * The #GESProject is used to control a set of #GESAsset and is a
index 40ac817..dac3459 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gessourceclip
+ * @title: GESSourceClip
  * @short_description: Base Class for sources of a GESLayer
  */
 
index 72c00f5..5f597e9 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gessource
+ * @title: GESSource
  * @short_description: Base Class for single-media sources
  */
 
index f022f80..2077a4a 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gestestclip
+ * @title: GESTestClip
  * @short_description: Render video and audio test patterns in a GESLayer
  *
  * Useful for testing purposes.
index 01fabbf..4a3f806 100644 (file)
@@ -50,7 +50,6 @@ typedef struct _GESTestClipPrivate GESTestClipPrivate;
 
 /**
  * GESTestClip:
- * 
  */
 
 struct _GESTestClip {
index ccaf95d..0238431 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gestextoverlayclip
+ * @title: GESTextOverlayClip
  * @short_description: Render text onto another stream in a GESLayer
  *
  * Renders text onto the next lower priority stream using textrender.
index 0ad8755..3395b81 100644 (file)
@@ -42,7 +42,6 @@ typedef struct _GESTextOverlayClipPrivate GESTextOverlayClipPrivate;
 
 /**
  * GESTextOverlayClip:
- * 
  */
 
 struct _GESTextOverlayClip
index ef5cb82..22c5835 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gestextoverlay
+ * @title: GESTextOverlay
  * @short_description: render text onto another video stream in a GESLayer
  *
  */
index 9922c41..6531f6b 100644 (file)
@@ -18,6 +18,7 @@
 
 /**
  * SECTION:gestimelineelement
+ * @title: GESTimelineElement
  * @short_description: Base Class for all elements that will be in a way or
  * another inside a GESTimeline.
  *
@@ -1177,7 +1178,6 @@ ges_timeline_element_get_toplevel_parent (GESTimelineElement * self)
  * ges_timeline_element_get_name:
  * @self: a #GESTimelineElement
  *
- *
  * Returns a copy of the name of @self.
  * Caller should g_free() the return value after usage.
  *
@@ -1196,7 +1196,6 @@ ges_timeline_element_get_name (GESTimelineElement * self)
  * @self: a #GESTimelineElement
  * @name: (allow-none): The name @self should take (if avalaible<)
  *
- *
  * Sets the name of object, or gives @self a guaranteed unique name (if name is NULL).
  * This function makes a copy of the provided name, so the caller retains ownership
  * of the name it sent.
index 7888b8f..6c7b50f 100644 (file)
@@ -289,4 +289,3 @@ GESTrackType ges_timeline_element_get_track_types  (GESTimelineElement * self);
 G_END_DECLS
 
 #endif /* _GES_TIMELINE_ELEMENT_H_ */
-
index a72b088..1b010f7 100644 (file)
@@ -23,6 +23,7 @@
 
 /**
  * SECTION:gestimeline
+ * @title: GESTimeline
  * @short_description: Multimedia timeline
  *
  * #GESTimeline is the central object for any multimedia timeline.
index e6b6d68..f33cbc0 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gestitleclip
+ * @title: GESTitleClip
  * @short_description: Render stand-alone titles in  GESLayer.
  *
  * Renders the given text in the specified font, at specified position, and
index 3515d3f..6a294b5 100644 (file)
 
 /**
  * SECTION:gestitlesource
+ * @title: GESTitleSource
  * @short_description: render stand-alone text titles
  *
  * #GESTitleSource is a GESTimelineElement that implements the notion
  * of titles in GES.
  *
  * <refsect1 id="GESTileSource.children_properties" role="properties">
- * <title role="children_properties.title">Children Properties</title>
- * <para>You can use the following children properties through the
- * #ges_track_element_set_child_property and alike set of methods:</para>
+ * <title role="children_properties.title">Children Properties
+ * You can use the following children properties through the
+ * #ges_track_element_set_child_property and alike set of methods:
  * <informaltable frame="none">
  * <tgroup cols="3">
  * <colspec colname="properties_type" colwidth="150px"/>
index 49f835a..689b2e7 100644 (file)
@@ -46,7 +46,7 @@ G_BEGIN_DECLS
 
 typedef struct _GESTitleSourcePrivate GESTitleSourcePrivate;
 
-/** 
+/**
  * GESTitleSource:
  *
  */
@@ -64,7 +64,6 @@ struct _GESTitleSource {
  * GESTitleSourceClass:
  * @parent_class: parent class
  */
-
 struct _GESTitleSourceClass {
   GESVideoSourceClass parent_class;
 
index 8f46e7e..10b6aa7 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION: gestrackelementasset
+ * @title: GESTrackElementAsset
  * @short_description: A GESAsset subclass specialized in GESTrackElement extraction
  */
 
index cfd5a1f..23369f8 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gestrackelement
+ * @title: GESTrackElement
  * @short_description: Base Class for objects contained in a GESTrack
  *
  * #GESTrackElement is the Base Class for any object that can be contained in a
index 75f7645..879b66f 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gestrack
+ * @title: GESTrack
  * @short_description: Composition of objects
  *
  * Corresponds to one output format (i.e. audio OR video).
index 1a47076..ef4754e 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION: gestransitionclip
+ * @title: GESTransitionClip
  * @short_description: Transition from one clip to another in a GESLayer
  *
  * Creates an object that mixes together the two underlying objects, A and B.
index 2b469f3..82c1597 100644 (file)
@@ -17,9 +17,9 @@
  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
-
-/** 
+/**
  * SECTION:gestransition
+ * @title: GESTransition
  * @short_description: base class for audio and video transitions
  *
  */
index 170dc8a..7a27a03 100644 (file)
@@ -20,6 +20,7 @@
  */
 /**
  * SECTION: gesuriclipasset
+ * @title: GESUriClipAsset
  * @short_description: A GESAsset subclass specialized in GESUriClip extraction
  *
  * The #GESUriClipAsset is a special #GESAsset that lets you handle
@@ -648,6 +649,7 @@ ges_uri_clip_asset_get_stream_assets (GESUriClipAsset * self)
  *****************************************************************/
 /**
  * SECTION: gesurisourceasset
+ * @title: GESUriClipAsset
  * @short_description: A GESAsset subclass specialized in GESUriSource extraction
  *
  * NOTE: You should never request such a #GESAsset as they will be created automatically
index 07a8819..dc9f38c 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION: gesuriclip
+ * @title: GESUriClip
  * @short_description: An object for manipulating media files in a GESTimeline
  *
  * Represents all the output streams from a particular uri. It is assumed that
index fc4eddb..bd330cb 100644 (file)
@@ -19,6 +19,7 @@
 
 /**
  * SECTION:ges-utils
+ * @title: GES utilities
  * @short_description: Convenience methods
  *
  */
index fe41287..87a917a 100644 (file)
 
 /**
  * SECTION:gesvideosource
+ * @title: GESVideoSource
  * @short_description: Base Class for video sources
  *
  * <refsect1 id="GESVideoSource.children_properties" role="properties">
- * <title role="children_properties.title">Children Properties</title>
- * <para>You can use the following children properties through the
- * #ges_track_element_set_child_property and alike set of methods:</para>
+ * # Children Properties
+ * You can use the following children properties through the
+ * #ges_track_element_set_child_property and alike set of methods:
  * <informaltable frame="none">
  * <tgroup cols="3">
  * <colspec colname="properties_type" colwidth="150px"/>
index 483d12e..81b98b7 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gesvideotestsource
+ * @title: GESVideoTestSource
  * @short_description: produce solid colors and patterns
  */
 
index 6064a80..8a5300c 100644 (file)
@@ -19,6 +19,7 @@
 
 /**
  * SECTION: gesvideotrack
+ * @title: GESVideoTrack
  * @short_description: A standard GESTrack for raw video
  */
 
index 94611d7..3d4b3ff 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gesvideotransition
+ * @title: GESVideoTransition
  * @short_description: implements video crossfade transition
  */
 
index d523527..61923ac 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * SECTION:gesvideourisource
+ * @title: GESVideoUriSource
  * @short_description: outputs a single video stream from a given file
  */