From a99d3f8769ed3fd1266d5216ecefebfd1bdcf663 Mon Sep 17 00:00:00 2001
From: Stefan Kost <ensonic@users.sf.net>
Date: Wed, 28 Jan 2009 12:29:42 +0200
Subject: Update and add documentation for plugins with no deps (gst).

Link to properties. Correct titles for examples. Document a few trivial cases. Keep lists in section file and docs/plugins/Makefile.am alphabetically ordered.
---
 gst/avi/gstavidemux.c | 15 +++++----------
 gst/avi/gstavimux.c   | 26 ++++++++------------------
 2 files changed, 13 insertions(+), 28 deletions(-)

(limited to 'gst/avi')

diff --git a/gst/avi/gstavidemux.c b/gst/avi/gstavidemux.c
index 9170935d..cf7b0c12 100644
--- a/gst/avi/gstavidemux.c
+++ b/gst/avi/gstavidemux.c
@@ -22,24 +22,19 @@
 /**
  * SECTION:element-avidemux
  *
- * <refsect2>
- * <para>
  * Demuxes an .avi file into raw or compressed audio and/or video streams.
- * </para>
- * <para>
+ *
  * This element supports both push and pull-based scheduling, depending on the
  * capabilities of the upstream elements.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
- * <programlisting>
+ * |[
  * gst-launch filesrc location=test.avi ! avidemux name=demux  demux.audio_00 ! decodebin ! audioconvert ! audioresample ! autoaudiosink   demux.video_00 ! queue ! decodebin ! ffmpegcolorspace ! videoscale ! autovideosink
- * </programlisting>
- * Play (parse and decode) an .avi file and try to output it to
+ * ]| Play (parse and decode) an .avi file and try to output it to
  * an automatically detected soundcard and videosink. If the AVI file contains
  * compressed audio or video data, this will only work if you have the
  * right decoder elements/plugins installed.
- * </para>
  * </refsect2>
  *
  * Last reviewed on 2006-12-29 (0.10.6)
diff --git a/gst/avi/gstavimux.c b/gst/avi/gstavimux.c
index b432c6aa..e648d3e4 100644
--- a/gst/avi/gstavimux.c
+++ b/gst/avi/gstavimux.c
@@ -28,42 +28,32 @@
 /**
  * SECTION:element-avimux
  *
- * <refsect2>
- * <para>
  * Muxes raw or compressed audio and/or video streams into an AVI file.
- * </para>
- * <title>Example launch line</title>
- * <para>
- * (write everything in one line, without the backslash characters)
- * <programlisting>
+ *
+ * <refsect2>
+ * <title>Example launch lines</title>
+ * <para>(write everything in one line, without the backslash characters)</para>
+ * |[
  * gst-launch-0.10 videotestsrc num-buffers=250 \
  * ! 'video/x-raw-yuv,format=(fourcc)I420,width=320,height=240,framerate=(fraction)25/1' \
  * ! queue ! mux. \
  * audiotestsrc num-buffers=440 ! audioconvert \
  * ! 'audio/x-raw-int,rate=44100,channels=2' ! queue ! mux. \
  * avimux name=mux ! filesink location=test.avi
- * </programlisting>
- * This will create an .AVI file containing an uncompressed video stream
+ * ]| This will create an .AVI file containing an uncompressed video stream
  * with a test picture and an uncompressed audio stream containing a 
  * test sound.
- * </para>
- * <title>Another example launch line</title>
- * <para>
- * (write everything in one line, without the backslash characters)
- * <programlisting>
+ * |[
  * gst-launch-0.10 videotestsrc num-buffers=250 \
  * ! 'video/x-raw-yuv,format=(fourcc)I420,width=320,height=240,framerate=(fraction)25/1' \
  * ! xvidenc ! queue ! mux. \
  * audiotestsrc num-buffers=440 ! audioconvert ! 'audio/x-raw-int,rate=44100,channels=2' \
  * ! lame ! queue ! mux. \
  * avimux name=mux ! filesink location=test.avi
- * </programlisting>
- * This will create an .AVI file containing the same test video and sound
+ * ]| This will create an .AVI file containing the same test video and sound
  * as above, only that both streams will be compressed this time. This will
  * only work if you have the necessary encoder elements installed of course.
- * </para>
  * </refsect2>
- *
  */
 
 #ifdef HAVE_CONFIG_H
-- 
cgit