Compare revisions

Matthew Waters · Gauthier Lamaison · Tim-Philipp Müller · Mathieu Duponchelle · Yeongjin Jeong · Tim-Philipp Müller
--- a/docs/meson.build
+++ b/docs/meson.build
@@ -21,7 +21,9 @@ endif

 plugins_cache = join_paths(meson.current_source_dir(), 'plugins', 'gst_plugins_cache.json')

-if plugins_cache_generator.found()
+if plugins.length() == 0
+    message('All bad plugins have been disabled')
+elif plugins_cache_generator.found()
    plugins_doc_dep = custom_target('bad-plugins-doc-cache',
        command: [plugins_cache_generator, plugins_cache, '@OUTPUT@', '@INPUT@'],
        input: plugins,

--- a/ext/chromaprint/gstchromaprint.c
+++ b/ext/chromaprint/gstchromaprint.c
@@ -27,8 +27,8 @@
 *
 * The chromaprint element calculates an acoustic fingerprint for an
 * audio stream which can be used to identify a song and look up
- * further metadata from the <ulink url="http://acoustid.org/">Acoustid</ulink>
- * and Musicbrainz databases.
+ * further metadata from the [Acoustid](http://acoustid.org/) and Musicbrainz
+ * databases.
 *
 * ## Example launch line
 * |[

--- a/ext/directfb/dfbvideosink.c
+++ b/ext/directfb/dfbvideosink.c
@@ -23,19 +23,21 @@
 * @title: dfbvideosink
 *
 * DfbVideoSink renders video frames using the
- * <ulink url="http://www.directfb.org/">DirectFB</ulink> library.
+ * [DirectFB](http://www.directfb.org/) library.
 * Rendering can happen in two different modes :
 *
 * * Standalone: this mode will take complete control of the monitor forcing
- *   <ulink url="http://www.directfb.org/">DirectFB</ulink> to fullscreen layout.
+ *   DirectFB to fullscreen layout.
+ *
 *   This is convenient to test using the  gst-launch-1.0 command line tool or
 *   other simple applications. It is possible to interrupt playback while
 *   being in this mode by pressing the Escape key.
 *   This mode handles navigation events for every input device supported by
- *   the <ulink url="http://www.directfb.org/">DirectFB</ulink> library, it will
- *   look for available video modes in the fb.modes file and try to switch
- *   the framebuffer video mode to the most suitable one. Depending on
- *   hardware acceleration capabilities the element will handle scaling or not.
+ *   the DirectFB library, it will look for available video modes in the fb.modes
+ *   file and try to switch the framebuffer video mode to the most suitable one.
+ *   Depending on hardware acceleration capabilities the element will handle
+ *   scaling or not.
+ *
 *   If no acceleration is available it will do clipping or centering of the
 *   video frames respecting the original aspect ratio.
 *
@@ -43,7 +45,8 @@
 *   #GstDfbVideoSink:surface provided by the
 *   application developer. This is a more advanced usage of the element and
 *   it is required to integrate video playback in existing
- *   <ulink url="http://www.directfb.org/">DirectFB</ulink> applications.
+ *   DirectFB applications.
+ *
 *   When using this mode the element just renders to the
 *   #GstDfbVideoSink:surface provided by the
 *   application, that means it won't handle navigation events and won't resize

--- a/ext/fluidsynth/gstfluiddec.c
+++ b/ext/fluidsynth/gstfluiddec.c
@@ -25,7 +25,7 @@
 * @see_also: timidity, wildmidi
 *
 * This element renders midi-events as audio streams using
- * <ulink url="http://fluidsynth.sourceforge.net//">Fluidsynth</ulink>.
+ * [Fluidsynth](http://fluidsynth.sourceforge.net/).
 * It offers better sound quality compared to the timidity or wildmidi element.
 *
 * ## Example pipeline

--- a/ext/kate/gstkatedec.c
+++ b/ext/kate/gstkatedec.c
@@ -48,8 +48,9 @@
 * @title: katedec
 * @see_also: oggdemux
 *
- * This element decodes Kate streams
- * <ulink url="http://libkate.googlecode.com/">Kate</ulink> is a free codec
+ * This element decodes Kate streams.
+ *
+ * [Kate](http://libkate.googlecode.com/) is a free codec
 * for text based data, such as subtitles. Any number of kate streams can be
 * embedded in an Ogg stream.
 *

--- a/ext/kate/gstkateenc.c
+++ b/ext/kate/gstkateenc.c
@@ -49,10 +49,11 @@
 * @title: kateenc
 * @see_also: oggmux
 *
- * This element encodes Kate streams
- * <ulink url="http://libkate.googlecode.com/">Kate</ulink> is a free codec
- * for text based data, such as subtitles. Any number of kate streams can be
- * embedded in an Ogg stream.
+ * This element encodes Kate streams.
+ *
+ * [Kate](http://libkate.googlecode.com/) is a free codec for text based data,
+ * such as subtitles. Any number of kate streams can be embedded in an Ogg
+ * stream.
 *
 * libkate (see above url) is needed to build this plugin.
 *

--- a/ext/kate/gstkatetiger.c
+++ b/ext/kate/gstkatetiger.c
@@ -48,12 +48,12 @@
 * @title: tiger
 * @see_also: katedec
 *
- * This element decodes and renders Kate streams
- * <ulink url="http://libkate.googlecode.com/">Kate</ulink> is a free codec
- * for text based data, such as subtitles. Any number of kate streams can be
- * embedded in an Ogg stream.
+ * This element decodes and renders Kate streams.
+ * [Kate](http://libkate.googlecode.com/) is a free codec for text based data,
+ * such as subtitles. Any number of kate streams can be embedded in an Ogg
+ * stream.
 *
- * libkate (see above url) and <ulink url="http://libtiger.googlecode.com/">libtiger</ulink>
+ * libkate (see above url) and [libtiger](http://libtiger.googlecode.com/)
 * are needed to build this element.
 *
 * ## Example pipeline

--- a/ext/ladspa/gstladspa.c
+++ b/ext/ladspa/gstladspa.c
@@ -27,7 +27,8 @@
 * @see_also: #GstAudioConvert #GstAudioResample, #GstAudioTestSrc, #GstAutoAudioSink
 *
 * The LADSPA (Linux Audio Developer's Simple Plugin API) element is a bridge
- * for plugins using the <ulink url="http://www.ladspa.org/">LADSPA</ulink> API.
+ * for plugins using the [LADSPA](http://www.ladspa.org/) API.
+ *
 * It scans all installed LADSPA plugins and registers them as gstreamer
 * elements. If available it can also parse LRDF files and use the metadata for
 * element classification. The functionality you get depends on the LADSPA plugins

--- a/ext/lv2/gstlv2.c
+++ b/ext/lv2/gstlv2.c
@@ -30,8 +30,8 @@
 * a successor to LADSPA (Linux Audio Developer's Simple Plugin API).
 *
 * The LV2 element is a bridge for plugins using the
- * <ulink url="http://www.lv2plug.in/">LV2</ulink> API.  It scans all
- * installed LV2 plugins and registers them as gstreamer elements.
+ * [LV2](http://www.lv2plug.in/) API.  It scans all installed LV2 plugins and
+ * registers them as gstreamer elements.
 */

 #ifdef HAVE_CONFIG_H

--- a/ext/modplug/gstmodplug.cc
+++ b/ext/modplug/gstmodplug.cc
@@ -28,8 +28,8 @@
 /**
 * SECTION:element-modplug
 * 
- * Modplug uses the <ulink url="http://modplug-xmms.sourceforge.net/">modplug</ulink>
- * library to decode tracked music in the MOD/S3M/XM/IT and related formats.
+ * Modplug uses the [modplug](http://modplug-xmms.sourceforge.net/) library to
+ * decode tracked music in the MOD/S3M/XM/IT and related formats.
 * 
 * ## Example pipeline
 *

--- a/ext/mpeg2enc/gstmpeg2enc.cc
+++ b/ext/mpeg2enc/gstmpeg2enc.cc
@@ -25,9 +25,10 @@
 * @see_also: mpeg2dec
 *
 * This element encodes raw video into an MPEG-1/2 elementary stream using the
- * <ulink url="http://mjpeg.sourceforge.net/">mjpegtools</ulink> library.
+ * [mjpegtools](http://mjpeg.sourceforge.net/) library.
+ *
 * Documentation on MPEG encoding in general can be found in the 
- * <ulink url="https://sourceforge.net/docman/display_doc.php?docid=3456&group_id=5776">MJPEG Howto</ulink>
+ * [MJPEG Howto](https://sourceforge.net/docman/display_doc.php?docid=3456&group_id=5776)
 * and on the various available parameters in the documentation
 * of the mpeg2enc tool in particular, which shares options with this element.
 *

--- a/ext/mplex/gstmplex.cc
+++ b/ext/mplex/gstmplex.cc
@@ -26,9 +26,9 @@
 *
 * This element is an audio/video multiplexer for MPEG-1/2 video streams
 * and (un)compressed audio streams such as AC3, MPEG layer I/II/III.
- * It is based on the <ulink url="http://mjpeg.sourceforge.net/">mjpegtools</ulink> library.
+ * It is based on the [mjpegtools](http://mjpeg.sourceforge.net/) library.
 * Documentation on creating MPEG videos in general can be found in the
- * <ulink url="https://sourceforge.net/docman/display_doc.php?docid=3456&group_id=5776">MJPEG Howto</ulink>
+ * [MJPEG Howto](https://sourceforge.net/docman/display_doc.php?docid=3456&group_id=5776)
 * and the man-page of the mplex tool documents the properties of this element,
 * which are shared with the mplex tool.
 *

--- a/ext/openmpt/gstopenmptdec.c
+++ b/ext/openmpt/gstopenmptdec.c
@@ -23,8 +23,8 @@
 * @see_also: #GstOpenMptDec
 *
 * openmpdec decodes module music formats, such as S3M, MOD, XM, IT.
- * It uses the <ulink url="https://lib.openmpt.org">OpenMPT library</ulink>
- * for this purpose. It can be autoplugged and therefore works with decodebin.
+ * It uses the [OpenMPT library](https://lib.openmpt.org) for this purpose.
+ * It can be autoplugged and therefore works with decodebin.
 *
 * ## Example launch line
 *

--- a/ext/srt/gstsrtsink.c
+++ b/ext/srt/gstsrtsink.c
@@ -23,7 +23,7 @@
 * SECTION:element-srtsink
 * @title: srtsink
 *
- * srtsink is a network sink that sends <ulink url="http://www.srtalliance.org/">SRT</ulink>
+ * srtsink is a network sink that sends [SRT](http://www.srtalliance.org/)
 * packets to the network.
 *
 * ## Examples</title>

--- a/ext/srt/gstsrtsrc.c
+++ b/ext/srt/gstsrtsrc.c
@@ -23,7 +23,7 @@
 * SECTION:element-srtsrc
 * @title: srtsrc
 *
- * srtsrc is a network source that reads <ulink url="http://www.srtalliance.org/">SRT</ulink>
+ * srtsrc is a network source that reads [SRT](http://www.srtalliance.org/)
 * packets from the network.
 *
 * ## Examples

--- a/ext/voaacenc/gstvoaacenc.c
+++ b/ext/voaacenc/gstvoaacenc.c
@@ -21,8 +21,9 @@
 * SECTION:element-voaacenc
 * @title: voaacenc
 *
- * AAC audio encoder based on vo-aacenc library
- * <ulink url="http://sourceforge.net/projects/opencore-amr/files/vo-aacenc/">vo-aacenc library source file</ulink>.
+ * AAC audio encoder based on vo-aacenc library.
+ *
+ * [vo-aacenc library source file](http://sourceforge.net/projects/opencore-amr/files/vo-aacenc/)
 *
 * ## Example launch line
 * |[

--- a/ext/voamrwbenc/gstvoamrwbenc.c
+++ b/ext/voamrwbenc/gstvoamrwbenc.c
@@ -23,7 +23,7 @@
 * @see_also: #GstAmrWbDec, #GstAmrWbParse
 *
 * AMR wideband encoder based on the
- * <ulink url="http://www.penguin.cz/~utx/amr">reference codec implementation</ulink>.
+ * [reference codec implementation](http://www.penguin.cz/~utx/amr).
 *
 * ## Example launch line
 * |[

--- a/ext/wayland/gstwaylandsink.c
+++ b/ext/wayland/gstwaylandsink.c
@@ -27,8 +27,9 @@
 *
 *  The waylandsink is creating its own window and render the decoded video frames to that.
 *  Setup the Wayland environment as described in
- *  <ulink url="http://wayland.freedesktop.org/building.html">Wayland</ulink> home page.
- *  The current implementaion is based on weston compositor.
+ *  [Wayland](http://wayland.freedesktop.org/building.html) home page.
+ *
+ *  The current implementation is based on weston compositor.
 *
 * ## Example pipelines
 * |[
@@ -97,7 +98,7 @@ static GstCaps *gst_wayland_sink_get_caps (GstBaseSink * bsink,
 static gboolean gst_wayland_sink_set_caps (GstBaseSink * bsink, GstCaps * caps);
 static gboolean
 gst_wayland_sink_propose_allocation (GstBaseSink * bsink, GstQuery * query);
-static gboolean gst_wayland_sink_show_frame (GstVideoSink * bsink,
+static GstFlowReturn gst_wayland_sink_show_frame (GstVideoSink * bsink,
    GstBuffer * buffer);

 /* VideoOverlay interface */

--- a/ext/webrtc/webrtcdatachannel.c
+++ b/ext/webrtc/webrtcdatachannel.c
@@ -23,7 +23,7 @@
 * @title: GstWebRTCDataChannel
 * @see_also: #GstWebRTCRTPTransceiver
 *
- * <ulink url="http://w3c.github.io/webrtc-pc/#dom-rtcsctptransport">http://w3c.github.io/webrtc-pc/#dom-rtcsctptransport</ulink>
+ * <http://w3c.github.io/webrtc-pc/#dom-rtcsctptransport>
 */

 #ifdef HAVE_CONFIG_H

--- a/ext/wildmidi/gstwildmididec.c
+++ b/ext/wildmidi/gstwildmididec.c
@@ -23,8 +23,9 @@
 * @see_also: #GstWildmidiDec
 *
 * wildmididec decodes MIDI files.
- * It uses <ulink url="https://www.mindwerks.net/projects/wildmidi/">WildMidi</ulink>
- * for this purpose. It can be autoplugged and therefore works with decodebin.
+ *
+ * It uses [WildMidi](https://www.mindwerks.net/projects/wildmidi/) for this
+ * purpose. It can be autoplugged and therefore works with decodebin.
 *
 * ## Example launch line
 *
No results found