doc: remove xml from comments

diff --git a/ext/aom/gstav1dec.c b/ext/aom/gstav1dec.c
index 6e0a9bd..dcc4955 100644 (file)
--- a/ext/aom/gstav1dec.c
+++ b/ext/aom/gstav1dec.c
@@ -21,12 +21,11 @@
  *
  * AV1 Decoder.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 -v filesrc location=videotestsrc.webm ! matroskademux ! av1dec ! videoconvert ! videoscale ! autovideosink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/aom/gstav1enc.c b/ext/aom/gstav1enc.c
index c8bca7d..6dd2147 100644 (file)
--- a/ext/aom/gstav1enc.c
+++ b/ext/aom/gstav1enc.c
@@ -21,12 +21,11 @@
  *
  * AV1 Encoder.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc num-buffers=50 ! av1enc ! webmmux ! filesink location=av1.webm
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/closedcaption/sliced.h b/ext/closedcaption/sliced.h
index 1b209d4..e5c24b6 100644 (file)
--- a/ext/closedcaption/sliced.h
+++ b/ext/closedcaption/sliced.h
@@ -178,10 +178,11 @@ extern "C" {
  * "625-line television Wide Screen Signalling (WSS)"</a>.
  *
  * vbi_sliced payload:
- * <pre>
+ * ```
  * Byte         0                  1
  *       msb         lsb  msb             lsb
- * bit   7 6 5 4 3 2 1 0  x x 13 12 11 10 9 8<br></pre>
+ * bit   7 6 5 4 3 2 1 0  x x 13 12 11 10 9 8
+ * ```
  * according to EN 300 294, Table 1, lsb first transmitted.
  */
 #define VBI_SLICED_WSS_625              0x00000400
@@ -280,11 +281,11 @@ extern "C" {
  * Reference: <a href="http://www.jeita.or.jp">EIA-J CPR-1204</a>
  *
  * vbi_sliced payload:
- * <pre>
+ * ```
  * Byte         0                    1                  2
  *       msb         lsb  msb               lsb  msb             lsb
  * bit   7 6 5 4 3 2 1 0  15 14 13 12 11 10 9 8  x x x x 19 18 17 16
- * </pre>
+ * ```
  */
 
 #define VBI_SLICED_WSS_CPR1204         0x00000800

diff --git a/ext/colormanagement/gstlcms.c b/ext/colormanagement/gstlcms.c
index 831af2e..acb9de9 100644 (file)
--- a/ext/colormanagement/gstlcms.c
+++ b/ext/colormanagement/gstlcms.c
@@ -28,15 +28,14 @@
  * frames using the given ICC (International Color Consortium) profiles.
  * Falls back to internal sRGB profile if no ICC file is specified in property.
  *
- * <refsect2>
- * <title>Example launch line</title>
- * <para>(write everything in one line, without the backslash characters)</para>
+ * ## Example launch line
+ *
+ * (write everything in one line, without the backslash characters)
  * |[
  * gst-launch-1.0 filesrc location=photo_camera.png ! pngdec ! \
  * videoconvert ! lcms input-profile=sRGB.icc dest-profile=printer.icc \
  * pngenc ! filesink location=photo_print.png
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/curl/gstcurlhttpsrc.c b/ext/curl/gstcurlhttpsrc.c
index b115219..adecfcb 100644 (file)
--- a/ext/curl/gstcurlhttpsrc.c
+++ b/ext/curl/gstcurlhttpsrc.c
@@ -59,8 +59,8 @@
  * If the "http_proxy" environment variable is set, its value is used.
  * The #GstCurlHttpSrc:proxy property can be used to override the default.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 curlhttpsrc location=http://127.0.1.1/index.html ! fakesink dump=1
  * ]| The above pipeline reads a web page from the local machine using HTTP and
@@ -70,7 +70,6 @@
  * ]| The above pipeline will start up a DASH streaming session from the given
  * MPD file. This requires GStreamer to have been built with dashdemux from
  * gst-plugins-bad.
- * </refsect2>
  */
 
 /*

diff --git a/ext/modplug/gstmodplug.cc b/ext/modplug/gstmodplug.cc
index b5fbcb2..a106f8c 100644 (file)
--- a/ext/modplug/gstmodplug.cc
+++ b/ext/modplug/gstmodplug.cc
@@ -31,12 +31,11 @@
  * 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.
  * 
- * <refsect2>
- * <title>Example pipeline</title>
+ * ## Example pipeline
+ *
  * |[
  * gst-launch-1.0 -v filesrc location=1990s-nostalgia.xm ! modplug ! audioconvert ! alsasink
  * ]| Play a FastTracker xm file.
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/mpeg2enc/gstmpeg2enc.cc b/ext/mpeg2enc/gstmpeg2enc.cc
index 61bea2c..a86804d 100644 (file)
--- a/ext/mpeg2enc/gstmpeg2enc.cc
+++ b/ext/mpeg2enc/gstmpeg2enc.cc
@@ -31,13 +31,13 @@
  * and on the various available parameters in the documentation
  * of the mpeg2enc tool in particular, which shares options with this element.
  *
- * <refsect2>
- * <title>Example pipeline</title>
+ * ## Example pipeline
+ *
  * |[
  * gst-launch-1.0 videotestsrc num-buffers=1000 ! mpeg2enc ! filesink location=videotestsrc.m1v
  * ]| This example pipeline will encode a test video source to a an MPEG1
  * elementary stream (with Generic MPEG1 profile).
- * <para>
+ *
  * Likely, the #GstMpeg2enc:format property
  * is most important, as it selects the type of MPEG stream that is produced.
  * In particular, default property values are dependent on the format,
@@ -45,12 +45,11 @@
  * Note that the (S)VCD profiles also restrict the image size, so some scaling
  * may be needed to accomodate this.  The so-called generic profiles (as used
  * in the example above) allow most parameters to be adjusted.
- * </para>
+ *
  * |[
  * gst-launch-1.0 videotestsrc num-buffers=1000 ! videoscale ! mpeg2enc format=1 norm=p ! filesink location=videotestsrc.m1v
  * ]| This will produce an MPEG1 profile stream according to VCD2.0 specifications
  * for PAL #GstMpeg2enc:norm (as the image height is dependent on video norm).
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/mplex/gstmplex.cc b/ext/mplex/gstmplex.cc
index 7f7b4ec..f78e5bd 100644 (file)
--- a/ext/mplex/gstmplex.cc
+++ b/ext/mplex/gstmplex.cc
@@ -32,19 +32,17 @@
  * and the man-page of the mplex tool documents the properties of this element,
  * which are shared with the mplex tool.
  *
- * <refsect2>
- * <title>Example pipeline</title>
+ * ## Example pipeline
+ *
  * |[
  * gst-launch-1.0 -v videotestsrc num-buffers=1000 ! mpeg2enc ! mplex ! filesink location=videotestsrc.mpg
  * ]| This example pipeline will encode a test video source to an
  * MPEG1 elementary stream and multiplexes this to an MPEG system stream.
- * <para>
+ *
  * If several streams are being multiplexed, there should (as usual) be
  * a queue in each stream, and due to mplex' buffering the capacities of these
  * may have to be set to a few times the default settings to prevent the
  * pipeline stalling.
- * </para>
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstcameracalibrate.cpp b/ext/opencv/gstcameracalibrate.cpp
index b44a07b..ccf7aff 100644 (file)
--- a/ext/opencv/gstcameracalibrate.cpp
+++ b/ext/opencv/gstcameracalibrate.cpp
@@ -57,12 +57,11 @@
  * 
  * Based on this tutorial: https://docs.opencv.org/2.4/doc/tutorials/calib3d/camera_calibration/camera_calibration.html
  *
- * <refsect2>
- * <title>Example pipelines</title>
+ * ## Example pipelines
+ *
  * |[
  * gst-launch-1.0 -v v4l2src ! videoconvert ! cameraundistort ! cameracalibrate | autovideosink
  * ]| will correct camera distortion once camera calibration is done.
- * </refsect2>
  */
 
 /*

diff --git a/ext/opencv/gstcameraundistort.cpp b/ext/opencv/gstcameraundistort.cpp
index ca45ce2..baad9cb 100644 (file)
--- a/ext/opencv/gstcameraundistort.cpp
+++ b/ext/opencv/gstcameraundistort.cpp
@@ -55,15 +55,14 @@
  *
  * Based on this tutorial: https://docs.opencv.org/2.4/doc/tutorials/calib3d/camera_calibration/camera_calibration.html
  *
- * <refsect2>
- * <title>Example pipelines</title>
+ * ## Example pipelines
+ *
  * |[
  * gst-launch-1.0 -v v4l2src ! videoconvert ! cameraundistort settings="???" ! autovideosink
  * ]| will correct camera distortion based on provided settings.
  * |[
  * gst-launch-1.0 -v v4l2src ! videoconvert ! cameraundistort ! cameracalibrate ! autovideosink
  * ]| will correct camera distortion once camera calibration is done.
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstcvdilate.cpp b/ext/opencv/gstcvdilate.cpp
index 12802f0..defe2d4 100644 (file)
--- a/ext/opencv/gstcvdilate.cpp
+++ b/ext/opencv/gstcvdilate.cpp
@@ -46,12 +46,11 @@
  *
  * Dilates the image with the cvDilate OpenCV function.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! cvdilate ! videoconvert ! autovideosink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstcvequalizehist.cpp b/ext/opencv/gstcvequalizehist.cpp
index 9c4de60..742a414 100644 (file)
--- a/ext/opencv/gstcvequalizehist.cpp
+++ b/ext/opencv/gstcvequalizehist.cpp
@@ -47,12 +47,11 @@
  * Equalizes the histogram of a grayscale image with the cvEqualizeHist OpenCV
  * function.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc pattern=23 ! cvequalizehist ! videoconvert ! autovideosink
  * ]|
- * </refsect2>
  */
 
 

diff --git a/ext/opencv/gstcverode.cpp b/ext/opencv/gstcverode.cpp
index e7d2385..28551b0 100644 (file)
--- a/ext/opencv/gstcverode.cpp
+++ b/ext/opencv/gstcverode.cpp
@@ -46,12 +46,11 @@
  *
  * Erodes the image with the cvErode OpenCV function.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! cverode ! videoconvert ! autovideosink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstcvlaplace.cpp b/ext/opencv/gstcvlaplace.cpp
index b285b8f..e18e9e9 100644 (file)
--- a/ext/opencv/gstcvlaplace.cpp
+++ b/ext/opencv/gstcvlaplace.cpp
@@ -46,12 +46,11 @@
  *
  * Applies cvLaplace OpenCV function to the image.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! cvlaplace ! videoconvert ! autovideosink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstcvsmooth.cpp b/ext/opencv/gstcvsmooth.cpp
index 3186427..02c995d 100644 (file)
--- a/ext/opencv/gstcvsmooth.cpp
+++ b/ext/opencv/gstcvsmooth.cpp
@@ -46,12 +46,11 @@
  *
  * Smooths the image using thes cvSmooth OpenCV function.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! cvsmooth ! videoconvert ! autovideosink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstcvsobel.cpp b/ext/opencv/gstcvsobel.cpp
index ffeeba5..5cca14d 100644 (file)
--- a/ext/opencv/gstcvsobel.cpp
+++ b/ext/opencv/gstcvsobel.cpp
@@ -46,12 +46,11 @@
  *
  * Applies the cvSobel OpenCV function to the image.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! cvsobel ! videoconvert ! autovideosink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstdewarp.cpp b/ext/opencv/gstdewarp.cpp
index 1d5e912..3c123c5 100644 (file)
--- a/ext/opencv/gstdewarp.cpp
+++ b/ext/opencv/gstdewarp.cpp
@@ -47,12 +47,11 @@
  *
  * Dewarp fisheye images
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! videoconvert ! circle radius=0.1 height=80  ! dewarp outer-radius=0.35 inner-radius=0.1 ! videoconvert ! xvimagesink
  * ]|
- * </refsect2>
  */
 
 

diff --git a/ext/opencv/gstdisparity.cpp b/ext/opencv/gstdisparity.cpp
index d274b76..e584c26 100644 (file)
--- a/ext/opencv/gstdisparity.cpp
+++ b/ext/opencv/gstdisparity.cpp
@@ -97,8 +97,8 @@
  * [D] Scharstein, D. & Szeliski, R. (2001). A taxonomy and evaluation of dense two-frame stereo
  * correspondence algorithms, International Journal of Computer Vision 47: 7–42.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! video/x-raw,width=320,height=240 ! videoconvert ! disp0.sink_right videotestsrc ! video/x-raw,width=320,height=240 ! videoconvert ! disp0.sink_left disparity name=disp0 ! videoconvert ! ximagesink
  * ]|
@@ -112,7 +112,6 @@ gst-launch-1.0    multifilesrc  location=~/im3.png ! pngdec ! videoconvert  ! di
  * |[
  gst-launch-1.0    v4l2src device=/dev/video1 ! video/x-raw,width=320,height=240 ! videoconvert  ! disp0.sink_right     v4l2src device=/dev/video0 ! video/x-raw,width=320,height=240 ! videoconvert ! disp0.sink_left disparity   name=disp0 method=sgbm     disp0.src ! videoconvert ! ximagesink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstedgedetect.cpp b/ext/opencv/gstedgedetect.cpp
index e5a7063..04a4681 100644 (file)
--- a/ext/opencv/gstedgedetect.cpp
+++ b/ext/opencv/gstedgedetect.cpp
@@ -48,12 +48,11 @@
  *
  * Performs canny edge detection on videos and images
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! videoconvert ! edgedetect ! videoconvert ! xvimagesink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstfaceblur.cpp b/ext/opencv/gstfaceblur.cpp
index 9d99aca..7de576d 100644 (file)
--- a/ext/opencv/gstfaceblur.cpp
+++ b/ext/opencv/gstfaceblur.cpp
@@ -49,12 +49,11 @@
  *
  * Blurs faces in images and videos.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 autovideosrc ! videoconvert ! faceblur ! videoconvert ! autovideosink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstfacedetect.cpp b/ext/opencv/gstfacedetect.cpp
index c1b89ea..e6a32df 100644 (file)
--- a/ext/opencv/gstfacedetect.cpp
+++ b/ext/opencv/gstfacedetect.cpp
@@ -56,8 +56,8 @@
  * until the size is <= GstFaceDetect::min-size-width or
  * GstFaceDetect::min-size-height.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 autovideosrc ! decodebin ! colorspace ! facedetect ! videoconvert ! xvimagesink
  * ]| Detect and show faces
@@ -65,7 +65,6 @@
  * gst-launch-1.0 autovideosrc ! video/x-raw,width=320,height=240 ! videoconvert ! facedetect min-size-width=60 min-size-height=60 ! colorspace ! xvimagesink
  * ]| Detect large faces on a smaller image
  *
- * </refsect2>
  */
 
 /* FIXME: development version of OpenCV has CV_HAAR_FIND_BIGGEST_OBJECT which

diff --git a/ext/opencv/gstgrabcut.cpp b/ext/opencv/gstgrabcut.cpp
index 0d8ec70..4c32c10 100644 (file)
--- a/ext/opencv/gstgrabcut.cpp
+++ b/ext/opencv/gstgrabcut.cpp
@@ -68,8 +68,8 @@
  * extraction using iterated graph cuts, ACM Trans. Graph., vol. 23, pp. 309–314,
  * 2004.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 --gst-debug=grabcut=4  v4l2src device=/dev/video0 ! videoconvert ! grabcut ! videoconvert ! video/x-raw,width=320,height=240 ! ximagesink
  * ]|
@@ -77,7 +77,6 @@
  * |[
  * gst-launch-1.0 --gst-debug=grabcut=4  v4l2src device=/dev/video0 ! videoconvert ! facedetect display=0 ! videoconvert ! grabcut test-mode=true ! videoconvert ! video/x-raw,width=320,height=240 ! ximagesink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gsthanddetect.cpp b/ext/opencv/gsthanddetect.cpp
index 73da2f8..912bebe 100644 (file)
--- a/ext/opencv/gsthanddetect.cpp
+++ b/ext/opencv/gsthanddetect.cpp
@@ -47,13 +47,12 @@
  * FIXME:operates hand gesture detection in video streams and images,
  * and enable media operation e.g. play/stop/fast forward/back rewind.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 autovideosrc ! videoconvert ! "video/x-raw, format=RGB, width=320, height=240" ! \
  * videoscale ! handdetect ! videoconvert ! xvimagesink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstmotioncells.cpp b/ext/opencv/gstmotioncells.cpp
index ac1350a..b0a6d1a 100644 (file)
--- a/ext/opencv/gstmotioncells.cpp
+++ b/ext/opencv/gstmotioncells.cpp
@@ -47,12 +47,11 @@
  *
  * Performs motion detection on videos.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc pattern=18 ! videorate ! videoscale ! video/x-raw,width=320,height=240,framerate=5/1 ! videoconvert ! motioncells ! videoconvert ! xvimagesink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstretinex.cpp b/ext/opencv/gstretinex.cpp
index c5c9f56..84706f0 100644 (file)
--- a/ext/opencv/gstretinex.cpp
+++ b/ext/opencv/gstretinex.cpp
@@ -50,12 +50,11 @@
  * color image enhancement." Image Processing, 1996. Proceedings., International
  * Conference on. Vol. 3. IEEE, 1996.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! videoconvert ! retinex ! videoconvert ! xvimagesink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstsegmentation.cpp b/ext/opencv/gstsegmentation.cpp
index b7de6f0..e0401d0 100644 (file)
--- a/ext/opencv/gstsegmentation.cpp
+++ b/ext/opencv/gstsegmentation.cpp
@@ -78,12 +78,11 @@
  * per Image Pixel for the Task of Background Subtraction", Pattern Recognition
  * Letters, vol. 27, no. 7, pages 773-780, 2006.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0  v4l2src device=/dev/video0 ! videoconvert ! segmentation test-mode=true method=2 ! videoconvert ! ximagesink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gstskindetect.cpp b/ext/opencv/gstskindetect.cpp
index c13c80b..60d0697 100644 (file)
--- a/ext/opencv/gstskindetect.cpp
+++ b/ext/opencv/gstskindetect.cpp
@@ -46,12 +46,11 @@
  *
  * Human skin detection on videos and images
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! decodebin ! videoconvert ! skindetect ! videoconvert ! xvimagesink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gsttemplatematch.cpp b/ext/opencv/gsttemplatematch.cpp
index b0b2aa8..9f613c0 100644 (file)
--- a/ext/opencv/gsttemplatematch.cpp
+++ b/ext/opencv/gsttemplatematch.cpp
@@ -49,12 +49,11 @@
  *
  * Performs template matching on videos and images, providing detected positions via bus messages.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! videoconvert ! templatematch template=/path/to/file.jpg ! videoconvert ! xvimagesink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/opencv/gsttextoverlay.cpp b/ext/opencv/gsttextoverlay.cpp
index f72b1ee..b8e2be3 100644 (file)
--- a/ext/opencv/gsttextoverlay.cpp
+++ b/ext/opencv/gsttextoverlay.cpp
@@ -48,12 +48,11 @@
  *
  * opencvtextoverlay renders the text on top of the video frames
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 videotestsrc ! videoconvert ! opencvtextoverlay text="Opencv Text Overlay " ! videoconvert ! xvimagesink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/openmpt/gstopenmptdec.c b/ext/openmpt/gstopenmptdec.c
index 4c0bba1..bc8c04f 100644 (file)
--- a/ext/openmpt/gstopenmptdec.c
+++ b/ext/openmpt/gstopenmptdec.c
@@ -26,12 +26,11 @@
  * It uses the <ulink url="https://lib.openmpt.org">OpenMPT library</ulink>
  * for this purpose. It can be autoplugged and therefore works with decodebin.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 filesrc location=media/example.it ! openmptdec ! audioconvert ! audioresample ! autoaudiosink
  * ]|
- * </refsect2>
  */
 
 

diff --git a/ext/openni2/gstopenni2.cpp b/ext/openni2/gstopenni2.cpp
index ee396cd..493f0a5 100644 (file)
--- a/ext/openni2/gstopenni2.cpp
+++ b/ext/openni2/gstopenni2.cpp
@@ -33,15 +33,9 @@
  * More concretely on the "libopenni2-dev" and "libopenni2" packages - that can
  * be downloaded in http://goo.gl/2H6SZ6.
  *
- * <refsect2>
- * <title>Examples</title>
- * <para>
- * Some recorded .oni files are available at:
- * <programlisting>
- *  http://people.cs.pitt.edu/~chang/1635/proj11/kinectRecord
- * </programlisting>
- * </para>
- * </refsect2>
+ * ## Examples
+ *
+ * Some recorded .oni files are available at <http://people.cs.pitt.edu/~chang/1635/proj11/kinectRecord>
  */
 
 

diff --git a/ext/openni2/gstopenni2src.cpp b/ext/openni2/gstopenni2src.cpp
index 88e6a16..6d8dc77 100644 (file)
--- a/ext/openni2/gstopenni2src.cpp
+++ b/ext/openni2/gstopenni2src.cpp
@@ -18,22 +18,17 @@
 /**
  * SECTION:element-openni2src
  *
- * <refsect2>
- * <title>Examples</title>
- * <para>
- * Some recorded .oni files are available at:
- * <programlisting>
- *  http://people.cs.pitt.edu/~chang/1635/proj11/kinectRecord
- * </programlisting>
+ * ## Examples
  *
- * <programlisting>
-  LD_LIBRARY_PATH=/usr/lib/OpenNI2/Drivers/ gst-launch-1.0 --gst-debug=openni2src:5   openni2src location='Downloads/mr.oni' sourcetype=depth ! videoconvert ! ximagesink
- * </programlisting>
- * <programlisting>
-  LD_LIBRARY_PATH=/usr/lib/OpenNI2/Drivers/ gst-launch-1.0 --gst-debug=openni2src:5   openni2src location='Downloads/mr.oni' sourcetype=color ! videoconvert ! ximagesink
- * </programlisting>
- * </para>
- * </refsect2>
+ * Some recorded .oni files are available at <http://people.cs.pitt.edu/~chang/1635/proj11/kinectRecord>
+ *
+ * ``` shell
+ * LD_LIBRARY_PATH=/usr/lib/OpenNI2/Drivers/ gst-launch-1.0 --gst-debug=openni2src:5   openni2src location='Downloads/mr.oni' sourcetype=depth ! videoconvert ! ximagesink
+ * ```
+ *
+ * ``` shell
+ * LD_LIBRARY_PATH=/usr/lib/OpenNI2/Drivers/ gst-launch-1.0 --gst-debug=openni2src:5   openni2src location='Downloads/mr.oni' sourcetype=color ! videoconvert ! ximagesink
+ * ```
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/ext/srt/gstsrtsink.c b/ext/srt/gstsrtsink.c
index 4af2bb1..8d499f2 100644 (file)
--- a/ext/srt/gstsrtsink.c
+++ b/ext/srt/gstsrtsink.c
@@ -26,8 +26,8 @@
  * srtsink is a network sink that sends <ulink url="http://www.srtalliance.org/">SRT</ulink>
  * packets to the network.
  *
- * <refsect2>
- * <title>Examples</title>
+ * ## Examples</title>
+ *
  * |[
  * gst-launch-1.0 -v audiotestsrc ! srtsink uri=srt://host
  * ]| This pipeline shows how to serve SRT packets through the default port.
@@ -35,7 +35,6 @@
  * |[
  * gst-launch-1.0 -v audiotestsrc ! srtsink uri=srt://:port
  * ]| This pipeline shows how to wait SRT callers.
- * </refsect2>
  * 
  */
 

diff --git a/ext/srt/gstsrtsrc.c b/ext/srt/gstsrtsrc.c
index f929e3f..cc52a60 100644 (file)
--- a/ext/srt/gstsrtsrc.c
+++ b/ext/srt/gstsrtsrc.c
@@ -26,8 +26,7 @@
  * srtsrc is a network source that reads <ulink url="http://www.srtalliance.org/">SRT</ulink>
  * packets from the network.
  *
- * <refsect2>
- * <title>Examples</title>
+ * ## Examples
  * |[
  * gst-launch-1.0 -v srtsrc uri="srt://127.0.0.1:7001" ! fakesink
  * ]| This pipeline shows how to connect SRT server by setting #GstSRTSrc:uri property.
@@ -39,7 +38,6 @@
  * |[
  * gst-launch-1.0 -v srtclientsrc uri="srt://192.168.1.10:7001?mode=rendez-vous" ! fakesink
  * ]| This pipeline shows how to connect SRT server by setting #GstSRTSrc:uri property and using the rendez-vous mode.
- * </refsect2>
  *
  */
 

diff --git a/ext/wildmidi/gstwildmididec.c b/ext/wildmidi/gstwildmididec.c
index 3a38148..ea88f74 100644 (file)
--- a/ext/wildmidi/gstwildmididec.c
+++ b/ext/wildmidi/gstwildmididec.c
@@ -26,12 +26,11 @@
  * It uses <ulink url="https://www.mindwerks.net/projects/wildmidi/">WildMidi</ulink>
  * for this purpose. It can be autoplugged and therefore works with decodebin.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 filesrc location=media/example.mid ! wildmididec ! audioconvert ! audioresample ! autoaudiosink
  * ]|
- * </refsect2>
  */
 
 

diff --git a/gst-libs/gst/audio/gstnonstreamaudiodecoder.c b/gst-libs/gst/audio/gstnonstreamaudiodecoder.c
index 4889ca6..ef1361c 100644 (file)
--- a/gst-libs/gst/audio/gstnonstreamaudiodecoder.c
+++ b/gst-libs/gst/audio/gstnonstreamaudiodecoder.c
@@ -74,110 +74,85 @@
  * @get_property then reports the corrected versions.
  *
  * The base class operates as follows:
- * <orderedlist>
- * <listitem>
- *   <itemizedlist><title>Unloaded mode</title>
- *     <listitem><para>
- *       Initial values are set. If a current subsong has already been
- *       defined (for example over the command line with gst-launch), then
- *       the subsong index is copied over to current_subsong .
- *       Same goes for the num-loops and output-mode properties.
- *       Media is NOT loaded yet.
- *     </para></listitem>
- *     <listitem><para>
- *       Once the sinkpad is activated, the process continues. The sinkpad is
- *       activated in push mode, and the class accumulates the incoming media
- *       data in an adapter inside the sinkpad's chain function until either an
- *       EOS event is received from upstream, or the number of bytes reported
- *       by upstream is reached. Then it loads the media, and starts the decoder
- *       output task.
- *     <listitem><para>
- *       If upstream cannot respond to the size query (in bytes) of @load_from_buffer
- *       fails, an error is reported, and the pipeline stops.
- *     </para></listitem>
- *     <listitem><para>
- *       If there are no errors, @load_from_buffer is called to load the media. The
- *       subclass must at least call gst_nonstream_audio_decoder_set_output_audioinfo()
- *       there, and is free to make use of the initial subsong, output mode, and
- *       position. If the actual output mode or position differs from the initial
- *       value,it must set the initial value to the actual one (for example, if
- *       the actual starting position is always 0, set *initial_position to 0).
- *       If loading is unsuccessful, an error is reported, and the pipeline
- *       stops. Otherwise, the base class calls @get_current_subsong to retrieve
- *       the actual current subsong, @get_subsong_duration to report the current
- *       subsong's duration in a duration event and message, and @get_subsong_tags
- *       to send tags downstream in an event (these functions are optional; if
- *       set to NULL, the associated operation is skipped). Afterwards, the base
- *       class switches to loaded mode, and starts the decoder output task.
- *     </para></listitem>
- *   </itemizedlist>
- *   <itemizedlist><title>Loaded mode</title>
- *     <listitem><para>
- *       Inside the decoder output task, the base class repeatedly calls @decode,
- *       which returns a buffer with decoded, ready-to-play samples. If the
- *       subclass reached the end of playback, @decode returns FALSE, otherwise
- *       TRUE.
- *     </para></listitem>
- *     <listitem><para>
- *       Upon reaching a loop end, subclass either ignores that, or loops back
- *       to the beginning of the loop. In the latter case, if the output mode is set
- *       to LOOPING, the subclass must call gst_nonstream_audio_decoder_handle_loop()
- *       *after* the playback position moved to the start of the loop. In
- *       STEADY mode, the subclass must *not* call this function.
- *       Since many decoders only provide a callback for when the looping occurs,
- *       and that looping occurs inside the decoding operation itself, the following
- *       mechanism for subclass is suggested: set a flag inside such a callback.
- *       Then, in the next @decode call, before doing the decoding, check this flag.
- *       If it is set, gst_nonstream_audio_decoder_handle_loop() is called, and the
- *       flag is cleared.
- *       (This function call is necessary in LOOPING mode because it updates the
- *       current segment and makes sure the next buffer that is sent downstream
- *       has its DISCONT flag set.)
- *     </para></listitem>
- *     <listitem><para>
- *       When the current subsong is switched, @set_current_subsong is called.
- *       If it fails, a warning is reported, and nothing else is done. Otherwise,
- *       it calls @get_subsong_duration to get the new current subsongs's
- *       duration, @get_subsong_tags to get its tags, reports a new duration
- *       (i.e. it sends a duration event downstream and generates a duration
- *       message), updates the current segment, and sends the subsong's tags in
- *       an event downstream. (If @set_current_subsong has been set to NULL by
- *       the subclass, attempts to set a current subsong are ignored; likewise,
- *       if @get_subsong_duration is NULL, no duration is reported, and if
- *       @get_subsong_tags is NULL, no tags are sent downstream.)
- *     </para></listitem>
- *     <listitem><para>
- *       When an attempt is made to switch the output mode, it is checked against
- *       the bitmask returned by @get_supported_output_modes. If the proposed
- *       new output mode is supported, the current segment is updated
- *       (it is open-ended in STEADY mode, and covers the (sub)song length in
- *       LOOPING mode), and the subclass' @set_output_mode function is called
- *       unless it is set to NULL. Subclasses should reset internal loop counters
- *       in this function.
- *     </para></listitem>
- *   </itemizedlist>
- * </listitem>
- * </orderedlist>
+ * * Unloaded mode
+ *   - Initial values are set. If a current subsong has already been
+ *     defined (for example over the command line with gst-launch), then
+ *     the subsong index is copied over to current_subsong .
+ *     Same goes for the num-loops and output-mode properties.
+ *     Media is NOT loaded yet.
+ *   - Once the sinkpad is activated, the process continues. The sinkpad is
+ *     activated in push mode, and the class accumulates the incoming media
+ *     data in an adapter inside the sinkpad's chain function until either an
+ *     EOS event is received from upstream, or the number of bytes reported
+ *     by upstream is reached. Then it loads the media, and starts the decoder
+ *     output task.
+ *   - If upstream cannot respond to the size query (in bytes) of @load_from_buffer
+ *     fails, an error is reported, and the pipeline stops.
+ *   - If there are no errors, @load_from_buffer is called to load the media. The
+ *     subclass must at least call gst_nonstream_audio_decoder_set_output_audioinfo()
+ *     there, and is free to make use of the initial subsong, output mode, and
+ *     position. If the actual output mode or position differs from the initial
+ *     value,it must set the initial value to the actual one (for example, if
+ *     the actual starting position is always 0, set *initial_position to 0).
+ *     If loading is unsuccessful, an error is reported, and the pipeline
+ *     stops. Otherwise, the base class calls @get_current_subsong to retrieve
+ *     the actual current subsong, @get_subsong_duration to report the current
+ *     subsong's duration in a duration event and message, and @get_subsong_tags
+ *     to send tags downstream in an event (these functions are optional; if
+ *     set to NULL, the associated operation is skipped). Afterwards, the base
+ *     class switches to loaded mode, and starts the decoder output task.
+ *
+ * * Loaded mode</title>
+ *   - Inside the decoder output task, the base class repeatedly calls @decode,
+ *     which returns a buffer with decoded, ready-to-play samples. If the
+ *     subclass reached the end of playback, @decode returns FALSE, otherwise
+ *     TRUE.
+ *   - Upon reaching a loop end, subclass either ignores that, or loops back
+ *     to the beginning of the loop. In the latter case, if the output mode is set
+ *     to LOOPING, the subclass must call gst_nonstream_audio_decoder_handle_loop()
+ *     *after* the playback position moved to the start of the loop. In
+ *     STEADY mode, the subclass must *not* call this function.
+ *     Since many decoders only provide a callback for when the looping occurs,
+ *     and that looping occurs inside the decoding operation itself, the following
+ *     mechanism for subclass is suggested: set a flag inside such a callback.
+ *     Then, in the next @decode call, before doing the decoding, check this flag.
+ *     If it is set, gst_nonstream_audio_decoder_handle_loop() is called, and the
+ *     flag is cleared.
+ *     (This function call is necessary in LOOPING mode because it updates the
+ *     current segment and makes sure the next buffer that is sent downstream
+ *     has its DISCONT flag set.)
+ *   - When the current subsong is switched, @set_current_subsong is called.
+ *     If it fails, a warning is reported, and nothing else is done. Otherwise,
+ *     it calls @get_subsong_duration to get the new current subsongs's
+ *     duration, @get_subsong_tags to get its tags, reports a new duration
+ *     (i.e. it sends a duration event downstream and generates a duration
+ *     message), updates the current segment, and sends the subsong's tags in
+ *     an event downstream. (If @set_current_subsong has been set to NULL by
+ *     the subclass, attempts to set a current subsong are ignored; likewise,
+ *     if @get_subsong_duration is NULL, no duration is reported, and if
+ *     @get_subsong_tags is NULL, no tags are sent downstream.)
+ *   - When an attempt is made to switch the output mode, it is checked against
+ *     the bitmask returned by @get_supported_output_modes. If the proposed
+ *     new output mode is supported, the current segment is updated
+ *     (it is open-ended in STEADY mode, and covers the (sub)song length in
+ *     LOOPING mode), and the subclass' @set_output_mode function is called
+ *     unless it is set to NULL. Subclasses should reset internal loop counters
+ *     in this function.
  *
  * The relationship between (sub)song duration, output mode, and number of loops
  * is defined this way (this is all done by the base class automatically):
- * <itemizedlist>
- * <listitem><para>
- *   Segments have their duration and stop values set to GST_CLOCK_TIME_NONE in
+ *
+ * * Segments have their duration and stop values set to GST_CLOCK_TIME_NONE in
  *   STEADY mode, and to the duration of the (sub)song in LOOPING mode.
- * </para></listitem>
- * <listitem><para>
- *   The duration that is returned to a DURATION query is always the duration
+ *
+ * * The duration that is returned to a DURATION query is always the duration
  *   of the (sub)song, regardless of number of loops or output mode. The same
  *   goes for DURATION messages and tags.
- * </para></listitem>
- * <listitem><para>
- *   If the number of loops is >0 or -1, durations of TOC entries are set to
+ *  
+ * * If the number of loops is >0 or -1, durations of TOC entries are set to
  *   the duration of the respective subsong in LOOPING mode and to G_MAXINT64 in
  *   STEADY mode. If the number of loops is 0, entry durations are set to the
  *   subsong duration regardless of the output mode.
- * </para></listitem>
- * </itemizedlist>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/gst-libs/gst/audio/gstnonstreamaudiodecoder.h b/gst-libs/gst/audio/gstnonstreamaudiodecoder.h
index 563a99e..4de1fc7 100644 (file)
--- a/gst-libs/gst/audio/gstnonstreamaudiodecoder.h
+++ b/gst-libs/gst/audio/gstnonstreamaudiodecoder.h
@@ -293,11 +293,11 @@ struct _GstNonstreamAudioDecoder
  *
  * All functions are called with a locked decoder mutex.
  *
- * <note> If GST_ELEMENT_ERROR, GST_ELEMENT_WARNING, or GST_ELEMENT_INFO are called from
- * inside one of these functions, it is strongly recommended to unlock the decoder mutex
- * before and re-lock it after these macros to prevent potential deadlocks in case the
- * application does something with the element when it receives an ERROR/WARNING/INFO
- * message. Same goes for gst_element_post_message() calls and non-serialized events. </note>
+ * > If GST_ELEMENT_ERROR, GST_ELEMENT_WARNING, or GST_ELEMENT_INFO are called from
+ * > inside one of these functions, it is strongly recommended to unlock the decoder mutex
+ * > before and re-lock it after these macros to prevent potential deadlocks in case the
+ * > application does something with the element when it receives an ERROR/WARNING/INFO
+ * > message. Same goes for gst_element_post_message() calls and non-serialized events.
  *
  * By default, this class works by reading media data from the sinkpad, and then commencing
  * playback. Some decoders cannot be given data from a memory block, so the usual way of

diff --git a/gst-libs/gst/basecamerabinsrc/gstbasecamerasrc.c b/gst-libs/gst/basecamerabinsrc/gstbasecamerasrc.c
index ed3e74c..889355e 100644 (file)
--- a/gst-libs/gst/basecamerabinsrc/gstbasecamerasrc.c
+++ b/gst-libs/gst/basecamerabinsrc/gstbasecamerasrc.c
@@ -29,13 +29,8 @@
  *
  * The design mandates that the subclasses implement the following features and
  * behaviour:
- * <itemizedlist>
- *   <listitem><para>
- *     3 pads: viewfinder, image capture, video capture
- *   </para></listitem>
- *   <listitem><para>
- *   </para></listitem>
- * </itemizedlist>
+ *
+ * * 3 pads: viewfinder, image capture, video capture
  *
  * During construct_pipeline() vmethod a subclass can add several elements into
  * the bin and expose 3 srcs pads as ghostpads implementing the 3 pad templates.

diff --git a/gst-libs/gst/interfaces/photography.c b/gst-libs/gst/interfaces/photography.c
index 1799c52..72fda1d 100644 (file)
--- a/gst-libs/gst/interfaces/photography.c
+++ b/gst-libs/gst/interfaces/photography.c
@@ -34,10 +34,8 @@
  *
  * The interface allows access to some common digital image capture parameters.
  *
- * <note>
- *   The GstPhotography interface is unstable API and may change in future.
- *   One can define GST_USE_UNSTABLE_API to acknowledge and avoid this warning.
- * </note>
+ * > The GstPhotography interface is unstable API and may change in future.
+ * > One can define GST_USE_UNSTABLE_API to acknowledge and avoid this warning.
  */
 
 static void gst_photography_iface_base_init (GstPhotographyInterface * iface);

diff --git a/gst-libs/gst/interfaces/photography.h b/gst-libs/gst/interfaces/photography.h
index 9a09c55..a43d420 100644 (file)
--- a/gst-libs/gst/interfaces/photography.h
+++ b/gst-libs/gst/interfaces/photography.h
@@ -50,38 +50,17 @@ G_BEGIN_DECLS
  * Name of custom GstMessage that will be posted to #GstBus when autofocusing
  * is complete.
  * This message contains following fields:
- * <itemizedlist>
- * <listitem>
- *   <para>
- *   #GstPhotographyFocusStatus
- *   <classname>&quot;status&quot;</classname>:
- *   Tells if focusing succeeded or failed.
- *   </para>
- * </listitem>
- * <listitem>
- *   <para>
- *   #G_TYPE_INT
- *   <classname>&quot;focus-window-rows&quot;</classname>:
- *   Tells number of focus matrix rows.
- *   </para>
- * </listitem>
- * <listitem>
- *   <para>
- *   #G_TYPE_INT
- *   <classname>&quot;focus-window-columns&quot;</classname>:
- *   Tells number of focus matrix columns.
- *   </para>
- * </listitem>
- * <listitem>
- *   <para>
- *   #G_TYPE_INT
- *   <classname>&quot;focus-window-mask&quot;</classname>:
- *   Bitmask containing rows x columns bits which mark the focus points in the
- *   focus matrix. Lowest bit (LSB) always represents the top-left corner of the
- *   focus matrix. This field is only valid when focusing status is SUCCESS.
- *   </para>
- * </listitem>
- * </itemizedlist>
+ *
+ * * `status` (#GstPhotographyFocusStatus): Tells if focusing succeeded or failed.
+ *
+ * * `focus-window-rows` (#G_TYPE_INT): Tells number of focus matrix rows.
+ *
+ * * `focus-window-columns` (#G_TYPE_INT): Tells number of focus matrix columns.
+ *
+ * * `focus-window-mask` (#G_TYPE_INT): Bitmask containing rows x columns bits
+ *   which mark the focus points in the focus matrix. Lowest bit (LSB) always
+ *   represents the top-left corner of the focus matrix. This field is only valid
+ *   when focusing status is SUCCESS.
  */
 #define GST_PHOTOGRAPHY_AUTOFOCUS_DONE "autofocus-done"
 
@@ -93,15 +72,8 @@ G_BEGIN_DECLS
  * becoming "shaken" due to camera movement and too long exposure time.
  *
  * This message contains following fields:
- * <itemizedlist>
- * <listitem>
- *   <para>
- *   #GstPhotographyShakeRisk
- *   <classname>&quot;status&quot;</classname>:
- *   Tells risk level of capturing shaken image.
- *   </para>
- * </listitem>
- * </itemizedlist>
+ *
+ * * `status` (#GstPhotographyShakeRisk): Tells risk level of capturing shaken image.
  */
 #define GST_PHOTOGRAPHY_SHAKE_RISK "shake-risk"
 

diff --git a/gst/faceoverlay/gstfaceoverlay.c b/gst/faceoverlay/gstfaceoverlay.c
index c5c8fe0..236d483 100644 (file)
--- a/gst/faceoverlay/gstfaceoverlay.c
+++ b/gst/faceoverlay/gstfaceoverlay.c
@@ -47,12 +47,11 @@
  * x, y, w, and h properties are optional, and change the image position and
  * size relative to the detected face position and size.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 autovideosrc ! videoconvert ! faceoverlay location=/path/to/gnome-video-effects/pixmaps/bow.svg x=0.5 y=0.5 w=0.7 h=0.7 ! videoconvert ! autovideosink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/gst/festival/gstfestival.c b/gst/festival/gstfestival.c
index 407fa3b..e3206ef 100644 (file)
--- a/gst/festival/gstfestival.c
+++ b/gst/festival/gstfestival.c
@@ -67,7 +67,7 @@
  * This element connects to a
  * <ulink url="http://www.festvox.org/festival/index.html">festival</ulink>
  * server process and uses it to synthesize speech. Festival need to run already
- * in server mode, started as <screen>festival --server</screen>
+ * in server mode, started as `festival --server`
  *
  * ## Example pipeline
  * |[

diff --git a/sys/applemedia/avfassetsrc.m b/sys/applemedia/avfassetsrc.m
index f7de87e..20478bd 100644 (file)
--- a/sys/applemedia/avfassetsrc.m
+++ b/sys/applemedia/avfassetsrc.m
@@ -26,12 +26,11 @@
  *
  * Read and decode samples from AVFoundation assets using the AVFAssetReader API
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 -v -m avfassetsrc uri="file://movie.mp4" ! autovideosink
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/sys/applemedia/iosassetsrc.m b/sys/applemedia/iosassetsrc.m
index 6a8b937..0ea3a07 100644 (file)
--- a/sys/applemedia/iosassetsrc.m
+++ b/sys/applemedia/iosassetsrc.m
@@ -26,12 +26,11 @@
  *
  * Read data from an iOS asset from the media library.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 iosassetsrc uri=assets-library://asset/asset.M4V?id=11&ext=M4V ! decodebin ! autoaudiosink
  * ]| Plays asset with id a song.ogg from local dir.
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/sys/vdpau/mpeg/gstvdpmpegdec.c b/sys/vdpau/mpeg/gstvdpmpegdec.c
index 1bcf9d9..b7f9569 100644 (file)
--- a/sys/vdpau/mpeg/gstvdpmpegdec.c
+++ b/sys/vdpau/mpeg/gstvdpmpegdec.c
@@ -23,12 +23,11 @@
  *
  * FIXME:Describe vdpaumpegdec here.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 -v -m fakesrc ! vdpaumpegdec ! fakesink silent=TRUE
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/sys/vdpau/mpeg4/gstvdpmpeg4dec.c b/sys/vdpau/mpeg4/gstvdpmpeg4dec.c
index ccbdbc6..a871f5a 100644 (file)
--- a/sys/vdpau/mpeg4/gstvdpmpeg4dec.c
+++ b/sys/vdpau/mpeg4/gstvdpmpeg4dec.c
@@ -23,12 +23,11 @@
  *
  * FIXME:Describe vdpaumpeg4dec here.
  *
- * <refsect2>
- * <title>Example launch line</title>
+ * ## Example launch line
+ *
  * |[
  * gst-launch-1.0 -v -m fakesrc ! vdpaumpeg4dec ! fakesink silent=TRUE
  * ]|
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H