Commit 287897e4 authored by Thibault Saunier's avatar Thibault Saunier

doc: Fix some gtk-doc comments

parent 27ba8d24
...@@ -202,7 +202,7 @@ gst_gl_sink_bin_class_init (GstGLSinkBinClass * klass) ...@@ -202,7 +202,7 @@ gst_gl_sink_bin_class_init (GstGLSinkBinClass * klass)
/** /**
* GstGLSinkBin::create-element: * GstGLSinkBin::create-element:
* @object: the #GstGLSinkBin * @object: the #glsinkbin
* *
* Will be emitted when we need the processing element/s that this bin will use * Will be emitted when we need the processing element/s that this bin will use
* *
......
...@@ -338,7 +338,7 @@ copy_config (GQuark field_id, const GValue * value, gpointer user_data) ...@@ -338,7 +338,7 @@ copy_config (GQuark field_id, const GValue * value, gpointer user_data)
* %FALSE and will try to update as much state as possible. The new state can * %FALSE and will try to update as much state as possible. The new state can
* then be retrieved and refined with gst_audio_converter_get_config(). * then be retrieved and refined with gst_audio_converter_get_config().
* *
* Look at the #GST_AUDIO_CONVERTER_OPT_* fields to check valid configuration * Look at the `GST_AUDIO_CONVERTER_OPT_*` fields to check valid configuration
* option and values. * option and values.
* *
* Returns: %TRUE when the new parameters could be set * Returns: %TRUE when the new parameters could be set
...@@ -1313,7 +1313,7 @@ converter_resample (GstAudioConverter * convert, ...@@ -1313,7 +1313,7 @@ converter_resample (GstAudioConverter * convert,
* Create a new #GstAudioConverter that is able to convert between @in and @out * Create a new #GstAudioConverter that is able to convert between @in and @out
* audio formats. * audio formats.
* *
* @config contains extra configuration options, see #GST_AUDIO_CONVERTER_OPT_* * @config contains extra configuration options, see `GST_AUDIO_CONVERTER_OPT_*`
* parameters for details about the options and values. * parameters for details about the options and values.
* *
* Returns: a #GstAudioConverter or %NULL if conversion is not possible. * Returns: a #GstAudioConverter or %NULL if conversion is not possible.
......
...@@ -33,7 +33,7 @@ typedef struct _GstAudioConverter GstAudioConverter; ...@@ -33,7 +33,7 @@ typedef struct _GstAudioConverter GstAudioConverter;
/** /**
* GST_AUDIO_CONVERTER_OPT_RESAMPLER_METHOD: * GST_AUDIO_CONVERTER_OPT_RESAMPLER_METHOD:
* *
* #GST_TYPE_AUDIO_RESAMPLER_METHOD, The resampler method to use when * #GstAudioResamplerMethod, The resampler method to use when
* changing sample rates. * changing sample rates.
* Default is #GST_AUDIO_RESAMPLER_METHOD_BLACKMAN_NUTTALL. * Default is #GST_AUDIO_RESAMPLER_METHOD_BLACKMAN_NUTTALL.
*/ */
...@@ -42,7 +42,7 @@ typedef struct _GstAudioConverter GstAudioConverter; ...@@ -42,7 +42,7 @@ typedef struct _GstAudioConverter GstAudioConverter;
/** /**
* GST_AUDIO_CONVERTER_OPT_DITHER_METHOD: * GST_AUDIO_CONVERTER_OPT_DITHER_METHOD:
* *
* #GST_TYPE_AUDIO_DITHER_METHOD, The dither method to use when * #GstAudioDitherMethod, The dither method to use when
* changing bit depth. * changing bit depth.
* Default is #GST_AUDIO_DITHER_NONE. * Default is #GST_AUDIO_DITHER_NONE.
*/ */
...@@ -51,7 +51,7 @@ typedef struct _GstAudioConverter GstAudioConverter; ...@@ -51,7 +51,7 @@ typedef struct _GstAudioConverter GstAudioConverter;
/** /**
* GST_AUDIO_CONVERTER_OPT_NOISE_SHAPING_METHOD: * GST_AUDIO_CONVERTER_OPT_NOISE_SHAPING_METHOD:
* *
* #GST_TYPE_AUDIO_NOISE_SHAPING_METHOD, The noise shaping method to use * #GstAudioNoiseShapingMethod, The noise shaping method to use
* to mask noise from quantization errors. * to mask noise from quantization errors.
* Default is #GST_AUDIO_NOISE_SHAPING_NONE. * Default is #GST_AUDIO_NOISE_SHAPING_NONE.
*/ */
...@@ -69,7 +69,7 @@ typedef struct _GstAudioConverter GstAudioConverter; ...@@ -69,7 +69,7 @@ typedef struct _GstAudioConverter GstAudioConverter;
/** /**
* GST_AUDIO_CONVERTER_OPT_MIX_MATRIX: * GST_AUDIO_CONVERTER_OPT_MIX_MATRIX:
* *
* #GST_TYPE_VALUE_LIST, The channel mapping matrix. * #GST_TYPE_LIST, The channel mapping matrix.
* *
* The matrix coefficients must be between -1 and 1: the number of rows is equal * The matrix coefficients must be between -1 and 1: the number of rows is equal
* to the number of output channels and the number of columns is equal to the * to the number of output channels and the number of columns is equal to the
......
...@@ -22,7 +22,6 @@ ...@@ -22,7 +22,6 @@
* SECTION:gstglquery * SECTION:gstglquery
* @short_description: OpenGL query abstraction * @short_description: OpenGL query abstraction
* @title: GstGLQuery * @title: GstGLQuery
* @see_also:
* *
* A #GstGLQuery represents and holds an OpenGL query object. Various types of * A #GstGLQuery represents and holds an OpenGL query object. Various types of
* queries can be run or counters retrieved. * queries can be run or counters retrieved.
......
...@@ -696,7 +696,7 @@ gst_encoding_profile_set_presence (GstEncodingProfile * profile, guint presence) ...@@ -696,7 +696,7 @@ gst_encoding_profile_set_presence (GstEncodingProfile * profile, guint presence)
/** /**
* gst_encoding_profile_set_enabled: * gst_encoding_profile_set_enabled:
* @profile: a #GstEncodingProfile * @profile: a #GstEncodingProfile
* @enabled: %FALSE to disable #profile, %TRUE to enable it * @enabled: %FALSE to disable @profile, %TRUE to enable it
* *
* Set whether the profile should be used or not. * Set whether the profile should be used or not.
* *
......
...@@ -18,7 +18,7 @@ ...@@ -18,7 +18,7 @@
* Boston, MA 02110-1301, USA. * Boston, MA 02110-1301, USA.
*/ */
/** /**
* SECTION: encoding-target * SECTION: encoding-target:
* On top of the notion of profiles, we implement the notion of EncodingTarget. * On top of the notion of profiles, we implement the notion of EncodingTarget.
* Encoding Targets are basically a higher level of abstraction to define formats * Encoding Targets are basically a higher level of abstraction to define formats
* for specific target types. Those can define several GstEncodingProfiles with * for specific target types. Those can define several GstEncodingProfiles with
......
...@@ -29,7 +29,7 @@ ...@@ -29,7 +29,7 @@
* changes). * changes).
* *
* It also provides several background shading effects. These effects are * It also provides several background shading effects. These effects are
* applied to a previous picture before the render() implementation can draw a * applied to a previous picture before the `render()` implementation can draw a
* new frame. * new frame.
*/ */
......
...@@ -42,7 +42,7 @@ ...@@ -42,7 +42,7 @@
* To use this base class, your child element needs to call either * To use this base class, your child element needs to call either
* gst_rtp_base_audio_payload_set_frame_based() or * gst_rtp_base_audio_payload_set_frame_based() or
* gst_rtp_base_audio_payload_set_sample_based(). This is usually done in the * gst_rtp_base_audio_payload_set_sample_based(). This is usually done in the
* element's _init() function. Then, the child element must call either * element's `_init()` function. Then, the child element must call either
* gst_rtp_base_audio_payload_set_frame_options(), * gst_rtp_base_audio_payload_set_frame_options(),
* gst_rtp_base_audio_payload_set_sample_options() or * gst_rtp_base_audio_payload_set_sample_options() or
* gst_rtp_base_audio_payload_set_samplebits_options. Since * gst_rtp_base_audio_payload_set_samplebits_options. Since
......
...@@ -497,7 +497,7 @@ beach: ...@@ -497,7 +497,7 @@ beach:
* In GStreamer, image tags are #GstSample<!-- -->s containing the raw image * In GStreamer, image tags are #GstSample<!-- -->s containing the raw image
* data, with the sample caps describing the content type of the image * data, with the sample caps describing the content type of the image
* (e.g. image/jpeg, image/png, text/uri-list). The sample info may contain * (e.g. image/jpeg, image/png, text/uri-list). The sample info may contain
* an additional 'image-type' field of #GST_TYPE_TAG_IMAGE_TYPE to describe * an additional 'image-type' field of #GstTagImageType to describe
* the type of image (front cover, back cover etc.). #GST_TAG_PREVIEW_IMAGE * the type of image (front cover, back cover etc.). #GST_TAG_PREVIEW_IMAGE
* tags should not carry an image type, their type is already indicated via * tags should not carry an image type, their type is already indicated via
* the special tag name. * the special tag name.
......
...@@ -243,8 +243,8 @@ gst_video_aggregator_pad_init (GstVideoAggregatorPad * vaggpad) ...@@ -243,8 +243,8 @@ gst_video_aggregator_pad_init (GstVideoAggregatorPad * vaggpad)
* Checks if the pad currently has a buffer queued that is going to be used * Checks if the pad currently has a buffer queued that is going to be used
* for the current output frame. * for the current output frame.
* *
* This must only be called from the aggregate_frames() virtual method, * This must only be called from the #GstVideoAggregatorClass::aggregate_frames virtual method,
* or from the prepare_frame() virtual method of the aggregator pads. * or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the aggregator pads.
* *
* Returns: %TRUE if the pad has currently a buffer queued * Returns: %TRUE if the pad has currently a buffer queued
*/ */
...@@ -263,10 +263,10 @@ gst_video_aggregator_pad_has_current_buffer (GstVideoAggregatorPad * pad) ...@@ -263,10 +263,10 @@ gst_video_aggregator_pad_has_current_buffer (GstVideoAggregatorPad * pad)
* Returns the currently queued buffer that is going to be used * Returns the currently queued buffer that is going to be used
* for the current output frame. * for the current output frame.
* *
* This must only be called from the aggregate_frames() virtual method, * This must only be called from the #GstVideoAggregatorClass::aggregate_frames virtual method,
* or from the prepare_frame() virtual method of the aggregator pads. * or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the aggregator pads.
* *
* The return value is only valid until aggregate_frames() or prepare_frames() * The return value is only valid until #GstVideoAggregatorClass::aggregate_frames or #GstVideoAggregatorPadClass::prepare_frame
* returns. * returns.
* *
* Returns: (transfer none): The currently queued buffer * Returns: (transfer none): The currently queued buffer
...@@ -286,10 +286,10 @@ gst_video_aggregator_pad_get_current_buffer (GstVideoAggregatorPad * pad) ...@@ -286,10 +286,10 @@ gst_video_aggregator_pad_get_current_buffer (GstVideoAggregatorPad * pad)
* Returns the currently prepared video frame that has to be aggregated into * Returns the currently prepared video frame that has to be aggregated into
* the current output frame. * the current output frame.
* *
* This must only be called from the aggregate_frames() virtual method, * This must only be called from the #GstVideoAggregatorClass::aggregate_frames virtual method,
* or from the prepare_frame() virtual method of the aggregator pads. * or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the aggregator pads.
* *
* The return value is only valid until aggregate_frames() or prepare_frames() * The return value is only valid until #GstVideoAggregatorClass::aggregate_frames or #GstVideoAggregatorPadClass::prepare_frame
* returns. * returns.
* *
* Returns: (transfer none): The currently prepared video frame * Returns: (transfer none): The currently prepared video frame
......
...@@ -26,7 +26,6 @@ ...@@ -26,7 +26,6 @@
* SECTION:gstvideodecoder * SECTION:gstvideodecoder
* @title: GstVideoDecoder * @title: GstVideoDecoder
* @short_description: Base class for video decoders * @short_description: Base class for video decoders
* @see_also:
* *
* This base class is for video decoders turning encoded data into raw video * This base class is for video decoders turning encoded data into raw video
* frames. * frames.
......
...@@ -26,7 +26,6 @@ ...@@ -26,7 +26,6 @@
* SECTION:gstvideoencoder * SECTION:gstvideoencoder
* @title: GstVideoEncoder * @title: GstVideoEncoder
* @short_description: Base class for video encoders * @short_description: Base class for video encoders
* @see_also:
* *
* This base class is for video encoders turning raw video into * This base class is for video encoders turning raw video into
* encoded video data. * encoded video data.
......
...@@ -2596,7 +2596,7 @@ copy_config (GQuark field_id, const GValue * value, gpointer user_data) ...@@ -2596,7 +2596,7 @@ copy_config (GQuark field_id, const GValue * value, gpointer user_data)
* %FALSE and will try to update as much state as possible. The new state can * %FALSE and will try to update as much state as possible. The new state can
* then be retrieved and refined with gst_video_converter_get_config(). * then be retrieved and refined with gst_video_converter_get_config().
* *
* Look at the #GST_VIDEO_CONVERTER_OPT_* fields to check valid configuration * Look at the `GST_VIDEO_CONVERTER_OPT_*` fields to check valid configuration
* option and values. * option and values.
* *
* Returns: %TRUE when @config could be set. * Returns: %TRUE when @config could be set.
......
...@@ -27,7 +27,7 @@ G_BEGIN_DECLS ...@@ -27,7 +27,7 @@ G_BEGIN_DECLS
/** /**
* GST_VIDEO_CONVERTER_OPT_RESAMPLER_METHOD: * GST_VIDEO_CONVERTER_OPT_RESAMPLER_METHOD:
* *
* #GST_TYPE_VIDEO_RESAMPLER_METHOD, The resampler method to use for * #GstVideoResamplerMethod, The resampler method to use for
* resampling. Other options for the resampler can be used, see * resampling. Other options for the resampler can be used, see
* the #GstVideoResampler. Default is #GST_VIDEO_RESAMPLER_METHOD_CUBIC * the #GstVideoResampler. Default is #GST_VIDEO_RESAMPLER_METHOD_CUBIC
*/ */
...@@ -35,7 +35,7 @@ G_BEGIN_DECLS ...@@ -35,7 +35,7 @@ G_BEGIN_DECLS
/** /**
* GST_VIDEO_CONVERTER_OPT_CHROMA_RESAMPLER_METHOD: * GST_VIDEO_CONVERTER_OPT_CHROMA_RESAMPLER_METHOD:
* *
* #GST_TYPE_VIDEO_RESAMPLER_METHOD, The resampler method to use for * #GstVideoChromaMethod, The resampler method to use for
* chroma resampling. Other options for the resampler can be used, see * chroma resampling. Other options for the resampler can be used, see
* the #GstVideoResampler. Default is #GST_VIDEO_RESAMPLER_METHOD_LINEAR * the #GstVideoResampler. Default is #GST_VIDEO_RESAMPLER_METHOD_LINEAR
*/ */
...@@ -51,7 +51,7 @@ G_BEGIN_DECLS ...@@ -51,7 +51,7 @@ G_BEGIN_DECLS
/** /**
* GST_VIDEO_CONVERTER_OPT_DITHER_METHOD: * GST_VIDEO_CONVERTER_OPT_DITHER_METHOD:
* *
* #GST_TYPE_VIDEO_DITHER_METHOD, The dither method to use when * #GstVideoDitherMethod, The dither method to use when
* changing bit depth. * changing bit depth.
* Default is #GST_VIDEO_DITHER_BAYER. * Default is #GST_VIDEO_DITHER_BAYER.
*/ */
...@@ -156,7 +156,7 @@ typedef enum { ...@@ -156,7 +156,7 @@ typedef enum {
/** /**
* GST_VIDEO_CONVERTER_OPT_ALPHA_MODE: * GST_VIDEO_CONVERTER_OPT_ALPHA_MODE:
* *
* #GST_TYPE_VIDEO_ALPHA_MODE, the alpha mode to use. * #GstVideoAlphaMode, the alpha mode to use.
* Default is #GST_VIDEO_ALPHA_MODE_COPY. * Default is #GST_VIDEO_ALPHA_MODE_COPY.
*/ */
#define GST_VIDEO_CONVERTER_OPT_ALPHA_MODE "GstVideoConverter.alpha-mode" #define GST_VIDEO_CONVERTER_OPT_ALPHA_MODE "GstVideoConverter.alpha-mode"
...@@ -190,7 +190,7 @@ typedef enum { ...@@ -190,7 +190,7 @@ typedef enum {
/** /**
* GST_VIDEO_CONVERTER_OPT_CHROMA_MODE: * GST_VIDEO_CONVERTER_OPT_CHROMA_MODE:
* *
* #GST_TYPE_VIDEO_CHROMA_MODE, set the chroma resample mode subsampled * #GstVideoChromaMode, set the chroma resample mode subsampled
* formats. Default is #GST_VIDEO_CHROMA_MODE_FULL. * formats. Default is #GST_VIDEO_CHROMA_MODE_FULL.
*/ */
#define GST_VIDEO_CONVERTER_OPT_CHROMA_MODE "GstVideoConverter.chroma-mode" #define GST_VIDEO_CONVERTER_OPT_CHROMA_MODE "GstVideoConverter.chroma-mode"
...@@ -217,7 +217,7 @@ typedef enum { ...@@ -217,7 +217,7 @@ typedef enum {
/** /**
* GST_VIDEO_CONVERTER_OPT_MATRIX_MODE: * GST_VIDEO_CONVERTER_OPT_MATRIX_MODE:
* *
* #GST_TYPE_VIDEO_MATRIX_MODE, set the color matrix conversion mode for * #GstVideoMatrixMode, set the color matrix conversion mode for
* converting between Y'PbPr and non-linear RGB (R'G'B'). * converting between Y'PbPr and non-linear RGB (R'G'B').
* Default is #GST_VIDEO_MATRIX_MODE_FULL. * Default is #GST_VIDEO_MATRIX_MODE_FULL.
*/ */
...@@ -237,7 +237,7 @@ typedef enum { ...@@ -237,7 +237,7 @@ typedef enum {
/** /**
* GST_VIDEO_CONVERTER_OPT_GAMMA_MODE: * GST_VIDEO_CONVERTER_OPT_GAMMA_MODE:
* *
* #GST_TYPE_VIDEO_GAMMA_MODE, set the gamma mode. * #GstVideoGammaMode, set the gamma mode.
* Default is #GST_VIDEO_GAMMA_MODE_NONE. * Default is #GST_VIDEO_GAMMA_MODE_NONE.
*/ */
#define GST_VIDEO_CONVERTER_OPT_GAMMA_MODE "GstVideoConverter.gamma-mode" #define GST_VIDEO_CONVERTER_OPT_GAMMA_MODE "GstVideoConverter.gamma-mode"
...@@ -260,7 +260,7 @@ typedef enum { ...@@ -260,7 +260,7 @@ typedef enum {
/** /**
* GST_VIDEO_CONVERTER_OPT_PRIMARIES_MODE: * GST_VIDEO_CONVERTER_OPT_PRIMARIES_MODE:
* *
* #GST_TYPE_VIDEO_PRIMARIES_MODE, set the primaries conversion mode. * #GstVideoPrimariesMode, set the primaries conversion mode.
* Default is #GST_VIDEO_PRIMARIES_MODE_NONE. * Default is #GST_VIDEO_PRIMARIES_MODE_NONE.
*/ */
#define GST_VIDEO_CONVERTER_OPT_PRIMARIES_MODE "GstVideoConverter.primaries-mode" #define GST_VIDEO_CONVERTER_OPT_PRIMARIES_MODE "GstVideoConverter.primaries-mode"
......
...@@ -106,11 +106,11 @@ GstVideoInterlaceMode gst_video_interlace_mode_from_string (const gchar * mode ...@@ -106,11 +106,11 @@ GstVideoInterlaceMode gst_video_interlace_mode_from_string (const gchar * mode
* @GST_VIDEO_MULTIVIEW_MODE_MULTIVIEW_FRAME_BY_FRAME: Multiple * @GST_VIDEO_MULTIVIEW_MODE_MULTIVIEW_FRAME_BY_FRAME: Multiple
* independent views are provided in separate frames in sequence. * independent views are provided in separate frames in sequence.
* This method only applies to raw video buffers at the moment. * This method only applies to raw video buffers at the moment.
* Specific view identification is via the #GstVideoMultiviewMeta * Specific view identification is via the `GstVideoMultiviewMeta`
* and #GstVideoMeta(s) on raw video buffers. * and #GstVideoMeta(s) on raw video buffers.
* @GST_VIDEO_MULTIVIEW_MODE_SEPARATED: Multiple views are * @GST_VIDEO_MULTIVIEW_MODE_SEPARATED: Multiple views are
* provided as separate #GstMemory framebuffers attached to each * provided as separate #GstMemory framebuffers attached to each
* #GstBuffer, described by the #GstVideoMultiviewMeta * #GstBuffer, described by the `GstVideoMultiviewMeta`
* and #GstVideoMeta(s) * and #GstVideoMeta(s)
* *
* All possible stereoscopic 3D and multiview representations. * All possible stereoscopic 3D and multiview representations.
......
...@@ -1380,8 +1380,7 @@ no_func: ...@@ -1380,8 +1380,7 @@ no_func:
* *
* Vertically combine @width pixels in the lines in @src_lines to @dest. * Vertically combine @width pixels in the lines in @src_lines to @dest.
* @dest is the location of the target line at @dest_offset and * @dest is the location of the target line at @dest_offset and
* @srcs are the input lines for @dest_offset, as obtained with * @srcs are the input lines for @dest_offset.
* gst_video_scaler_get_info().
*/ */
void void
gst_video_scaler_vertical (GstVideoScaler * scale, GstVideoFormat format, gst_video_scaler_vertical (GstVideoScaler * scale, GstVideoFormat format,
......
...@@ -31,7 +31,7 @@ G_BEGIN_DECLS ...@@ -31,7 +31,7 @@ G_BEGIN_DECLS
/** /**
* GST_VIDEO_SCALER_OPT_DITHER_METHOD: * GST_VIDEO_SCALER_OPT_DITHER_METHOD:
* *
* #GST_TYPE_VIDEO_DITHER_METHOD, The dither method to use for propagating * #GstVideoDitherMethod, The dither method to use for propagating
* quatization errors. * quatization errors.
*/ */
#define GST_VIDEO_SCALER_OPT_DITHER_METHOD "GstVideoScaler.dither-method" #define GST_VIDEO_SCALER_OPT_DITHER_METHOD "GstVideoScaler.dither-method"
......
...@@ -85,7 +85,7 @@ ...@@ -85,7 +85,7 @@
* ## Two basic usage scenarios * ## Two basic usage scenarios
* *
* There are two basic usage scenarios: in the simplest case, the application * There are two basic usage scenarios: in the simplest case, the application
* uses #playbin or #plasink or knows exactly what particular element is used * uses #playbin or #playsink or knows exactly what particular element is used
* for video output, which is usually the case when the application creates * for video output, which is usually the case when the application creates
* the videosink to use (e.g. #xvimagesink, #ximagesink, etc.) itself; in this * the videosink to use (e.g. #xvimagesink, #ximagesink, etc.) itself; in this
* case, the application can just create the videosink element, create and * case, the application can just create the videosink element, create and
...@@ -118,10 +118,10 @@ ...@@ -118,10 +118,10 @@
* windowing systems are not thread-safe at all and a lot of care would be * windowing systems are not thread-safe at all and a lot of care would be
* required to co-ordinate the toolkit and window system calls of the * required to co-ordinate the toolkit and window system calls of the
* different threads (Gtk+ users please note: prior to Gtk+ 2.18 * different threads (Gtk+ users please note: prior to Gtk+ 2.18
* GDK_WINDOW_XID() was just a simple structure access, so generally fine to do * `GDK_WINDOW_XID` was just a simple structure access, so generally fine to do
* within the bus sync handler; this macro was changed to a function call in * within the bus sync handler; this macro was changed to a function call in
* Gtk+ 2.18 and later, which is likely to cause problems when called from a * Gtk+ 2.18 and later, which is likely to cause problems when called from a
* sync handler; see below for a better approach without GDK_WINDOW_XID() * sync handler; see below for a better approach without `GDK_WINDOW_XID`
* used in the callback). * used in the callback).
* *
* ## GstVideoOverlay and Gtk+ * ## GstVideoOverlay and Gtk+
......
...@@ -822,16 +822,16 @@ gst_decode_bin_class_init (GstDecodeBinClass * klass) ...@@ -822,16 +822,16 @@ gst_decode_bin_class_init (GstDecodeBinClass * klass)
* #GstElementFactory that can be used to handle the given @caps. For each of * #GstElementFactory that can be used to handle the given @caps. For each of
* those factories, this signal is emitted. * those factories, this signal is emitted.
* *
* The signal handler should return a #GST_TYPE_AUTOPLUG_SELECT_RESULT enum * The signal handler should return a #GstAutoplugSelectResult enum
* value indicating what decodebin should do next. * value indicating what decodebin should do next.
* *
* A value of #GST_AUTOPLUG_SELECT_TRY will try to autoplug an element from * A value of #GstAutoplugSelectResult::try will try to autoplug an element from
* @factory. * @factory.
* *
* A value of #GST_AUTOPLUG_SELECT_EXPOSE will expose @pad without plugging * A value of #GstAutoplugSelectResult::expose will expose @pad without plugging
* any element to it. * any element to it.
* *
* A value of #GST_AUTOPLUG_SELECT_SKIP will skip @factory and move to the * A value of #GstAutoplugSelectResult::skip will skip @factory and move to the
* next factory. * next factory.
* *
* > The signal handler will not be invoked if any of the previously * > The signal handler will not be invoked if any of the previously
...@@ -840,9 +840,9 @@ gst_decode_bin_class_init (GstDecodeBinClass * klass) ...@@ -840,9 +840,9 @@ gst_decode_bin_class_init (GstDecodeBinClass * klass)
* > GST_AUTOPLUG_SELECT_TRY from one signal handler, handlers that get * > GST_AUTOPLUG_SELECT_TRY from one signal handler, handlers that get
* > registered next (again, if any) can override that decision. * > registered next (again, if any) can override that decision.
* *
* Returns: a #GST_TYPE_AUTOPLUG_SELECT_RESULT that indicates the required * Returns: a #GstAutoplugSelectResult that indicates the required
* operation. the default handler will always return * operation. the default handler will always return
* #GST_AUTOPLUG_SELECT_TRY. * #GstAutoplugSelectResult::try.
*/ */
gst_decode_bin_signals[SIGNAL_AUTOPLUG_SELECT] = gst_decode_bin_signals[SIGNAL_AUTOPLUG_SELECT] =
g_signal_new ("autoplug-select", G_TYPE_FROM_CLASS (klass), g_signal_new ("autoplug-select", G_TYPE_FROM_CLASS (klass),
......
...@@ -64,7 +64,7 @@ ...@@ -64,7 +64,7 @@
* *
*/ */
/** /*
* Global design * Global design
* *
* 1) From sink pad to elementary streams (GstParseBin) * 1) From sink pad to elementary streams (GstParseBin)
......
...@@ -736,16 +736,16 @@ gst_parse_bin_class_init (GstParseBinClass * klass) ...@@ -736,16 +736,16 @@ gst_parse_bin_class_init (GstParseBinClass * klass)
* #GstElementFactory that can be used to handle the given @caps. For each of * #GstElementFactory that can be used to handle the given @caps. For each of
* those factories, this signal is emitted. * those factories, this signal is emitted.
* *
* The signal handler should return a #GST_TYPE_AUTOPLUG_SELECT_RESULT enum * The signal handler should return a #GstAutoplugSelectResult enum
* value indicating what ParseBin should do next. * value indicating what ParseBin should do next.
* *
* A value of #GST_AUTOPLUG_SELECT_TRY will try to autoplug an element from * A value of #GstAutoplugSelectResult::try will try to autoplug an element from
* @factory. * @factory.
* *
* A value of #GST_AUTOPLUG_SELECT_EXPOSE will expose @pad without plugging * A value of #GstAutoplugSelectResult::expose will expose @pad without plugging
* any element to it. * any element to it.
* *
* A value of #GST_AUTOPLUG_SELECT_SKIP will skip @factory and move to the * A value of #GstAutoplugSelectResult::skip will skip @factory and move to the
* next factory. * next factory.
* *
* > The signal handler will not be invoked if any of the previously * > The signal handler will not be invoked if any of the previously
...@@ -754,9 +754,9 @@ gst_parse_bin_class_init (GstParseBinClass * klass) ...@@ -754,9 +754,9 @@ gst_parse_bin_class_init (GstParseBinClass * klass)
* > GST_AUTOPLUG_SELECT_TRY from one signal handler, handlers that get * > GST_AUTOPLUG_SELECT_TRY from one signal handler, handlers that get
* > registered next (again, if any) can override that decision. * > registered next (again, if any) can override that decision.
* *
* Returns: a #GST_TYPE_AUTOPLUG_SELECT_RESULT that indicates the required * Returns: a #GstAutoplugSelectResult that indicates the required
* operation. the default handler will always return * operation. the default handler will always return
* #GST_AUTOPLUG_SELECT_TRY. * #GstAutoplugSelectResult::try.
*/ */
gst_parse_bin_signals[SIGNAL_AUTOPLUG_SELECT] = gst_parse_bin_signals[SIGNAL_AUTOPLUG_SELECT] =
g_signal_new ("autoplug-select", G_TYPE_FROM_CLASS (klass), g_signal_new ("autoplug-select", G_TYPE_FROM_CLASS (klass),
...@@ -789,7 +789,7 @@ gst_parse_bin_class_init (GstParseBinClass * klass) ...@@ -789,7 +789,7 @@ gst_parse_bin_class_init (GstParseBinClass * klass)
GST_TYPE_QUERY | G_SIGNAL_TYPE_STATIC_SCOPE); GST_TYPE_QUERY | G_SIGNAL_TYPE_STATIC_SCOPE);
/** /**
* GstParseBin::drained * GstParseBin::drained:
* @bin: The ParseBin * @bin: The ParseBin
* *
* This signal is emitted once ParseBin has finished parsing all the data. * This signal is emitted once ParseBin has finished parsing all the data.
...@@ -813,7 +813,7 @@ gst_parse_bin_class_init (GstParseBinClass * klass) ...@@ -813,7 +813,7 @@ gst_parse_bin_class_init (GstParseBinClass * klass)
GST_TYPE_CAPS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS)); GST_TYPE_CAPS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
/** /**
* GstParseBin::expose-all-streams * GstParseBin::expose-all-streams:
* *
* Expose streams of unknown type. * Expose streams of unknown type.
* *
...@@ -829,7 +829,7 @@ gst_parse_bin_class_init (GstParseBinClass * klass) ...@@ -829,7 +829,7 @@ gst_parse_bin_class_init (GstParseBinClass * klass)
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS)); G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
/** /**
* GstParseBin2::connection-speed * GstParseBin2::connection-speed:
* *
* Network connection speed in kbps (0 = unknownw) * Network connection speed in kbps (0 = unknownw)
*/ */
...@@ -839,8 +839,6 @@ gst_parse_bin_class_init (GstParseBinClass * klass) ...@@ -839,8 +839,6 @@ gst_parse_bin_class_init (GstParseBinClass * klass)
0, G_MAXUINT64 / 1000, DEFAULT_CONNECTION_SPEED, 0, G_MAXUINT64 / 1000, DEFAULT_CONNECTION_SPEED,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS)); G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
klass->autoplug_continue = klass->autoplug_continue =
GST_DEBUG_FUNCPTR (gst_parse_bin_autoplug_continue); GST_DEBUG_FUNCPTR (gst_parse_bin_autoplug_continue);
klass->autoplug_factories = klass->autoplug_factories =
......
...@@ -17,8 +17,8 @@ ...@@ -17,8 +17,8 @@
* Boston, MA 02110-1301, USA. * Boston, MA 02110-1301, USA.
*/ */
/** /**
* SECTION:plugin-playback * SECTION:plugin-playback:
* short_description: Set of elements to create dynamic pipelines (or part of it) to play * @short_description: Set of elements to create dynamic pipelines (or part of it) to play
* media files. * media files.
*/ */
......
...@@ -970,7 +970,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass) ...@@ -970,7 +970,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass)
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS)); G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
/** /**
* GstPlayBin:ring-buffer-max-size * GstPlayBin:ring-buffer-max-size:
* *
* The maximum size of the ring buffer in bytes. If set to 0, the ring * The maximum size of the ring buffer in bytes. If set to 0, the ring
* buffer is disabled. Default 0. * buffer is disabled. Default 0.
...@@ -1043,7 +1043,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass) ...@@ -1043,7 +1043,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass)
g_cclosure_marshal_generic, G_TYPE_NONE, 0, G_TYPE_NONE); g_cclosure_marshal_generic, G_TYPE_NONE, 0, G_TYPE_NONE);
/** /**
* GstPlayBin::video-changed * GstPlayBin::video-changed:
* @playbin: a #GstPlayBin * @playbin: a #GstPlayBin
* *
* This signal is emitted whenever the number or order of the video * This signal is emitted whenever the number or order of the video
...@@ -1079,7 +1079,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass) ...@@ -1079,7 +1079,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass)
G_STRUCT_OFFSET (GstPlayBinClass, audio_changed), NULL, NULL, G_STRUCT_OFFSET (GstPlayBinClass, audio_changed), NULL, NULL,
g_cclosure_marshal_generic, G_TYPE_NONE, 0, G_TYPE_NONE); g_cclosure_marshal_generic, G_TYPE_NONE, 0, G_TYPE_NONE);
/** /**
* GstPlayBin::text-changed * GstPlayBin::text-changed:
* @playbin: a #GstPlayBin * @playbin: a #GstPlayBin
* *
* This signal is emitted whenever the number or order of the text * This signal is emitted whenever the number or order of the text
...@@ -1098,7 +1098,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass) ...@@ -1098,7 +1098,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass)
g_cclosure_marshal_generic, G_TYPE_NONE, 0, G_TYPE_NONE); g_cclosure_marshal_generic, G_TYPE_NONE, 0, G_TYPE_NONE);
/** /**
* GstPlayBin::video-tags-changed * GstPlayBin::video-tags-changed:
* @playbin: a #GstPlayBin * @playbin: a #GstPlayBin
* @stream: stream index with changed tags * @stream: stream index with changed tags
* *
...@@ -1116,7 +1116,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass) ...@@ -1116,7 +1116,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass)
g_cclosure_marshal_generic, G_TYPE_NONE, 1, G_TYPE_INT); g_cclosure_marshal_generic, G_TYPE_NONE, 1, G_TYPE_INT);
/** /**
* GstPlayBin::audio-tags-changed * GstPlayBin::audio-tags-changed:
* @playbin: a #GstPlayBin * @playbin: a #GstPlayBin
* @stream: stream index with changed tags * @stream: stream index with changed tags
* *
...@@ -1134,7 +1134,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass) ...@@ -1134,7 +1134,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass)
g_cclosure_marshal_generic, G_TYPE_NONE, 1, G_TYPE_INT); g_cclosure_marshal_generic, G_TYPE_NONE, 1, G_TYPE_INT);
/** /**
* GstPlayBin::text-tags-changed * GstPlayBin::text-tags-changed:
* @playbin: a #GstPlayBin * @playbin: a #GstPlayBin
* @stream: stream index with changed tags * @stream: stream index with changed tags
* *
...@@ -1192,7 +1192,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass) ...@@ -1192,7 +1192,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass)
g_cclosure_marshal_generic, G_TYPE_NONE, 1, GST_TYPE_ELEMENT); g_cclosure_marshal_generic, G_TYPE_NONE, 1, GST_TYPE_ELEMENT);
/** /**
* GstPlayBin::get-video-tags * GstPlayBin::get-video-tags:
* @playbin: a #GstPlayBin * @playbin: a #GstPlayBin
* @stream: a video stream number * @stream: a video stream number
* *
...@@ -1208,7 +1208,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass) ...@@ -1208,7 +1208,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass)
G_STRUCT_OFFSET (GstPlayBinClass, get_video_tags), NULL, NULL, G_STRUCT_OFFSET (GstPlayBinClass, get_video_tags), NULL, NULL,
g_cclosure_marshal_generic, GST_TYPE_TAG_LIST, 1, G_TYPE_INT); g_cclosure_marshal_generic, GST_TYPE_TAG_LIST, 1, G_TYPE_INT);
/** /**
* GstPlayBin::get-audio-tags * GstPlayBin::get-audio-tags:
* @playbin: a #GstPlayBin * @playbin: a #GstPlayBin
* @stream: an audio stream number * @stream: an audio stream number
* *
...@@ -1224,7 +1224,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass) ...@@ -1224,7 +1224,7 @@ gst_play_bin_class_init (GstPlayBinClass * klass)
G_STRUCT_OFFSET (GstPlayBinClass, get_audio_tags), NULL, NULL, G_STRUCT_OFFSET (GstPlayBinClass, get_audio_tags), NULL, NULL,
g_cclosure_marshal_generic, GST_TYPE_TAG_LIST, 1, G_TYPE_INT);