docs: unify doc style

Use gtkdoc syntax and add short desc for the examples.

diff --git a/ext/faac/gstfaac.c b/ext/faac/gstfaac.c
index 176c735..16c5fdc 100644 (file)
--- a/ext/faac/gstfaac.c
+++ b/ext/faac/gstfaac.c
@@ -36,9 +36,9 @@
  *
  * <refsect2>
  * <title>Example launch line</title>
- * <programlisting>
+ * |[
  * gst-launch audiotestsrc wave=sine num-buffers=100 ! audioconvert ! faac ! matroskamux ! filesink location=sine.mkv
- * </programlisting>
+ * ]| Encode a sine beep as aac and write to matroska container.
  * </refsect2>
  */
 

diff --git a/ext/faad/gstfaad.c b/ext/faad/gstfaad.c
index de9f32b..2ed9189 100644 (file)
--- a/ext/faad/gstfaad.c
+++ b/ext/faad/gstfaad.c
@@ -26,12 +26,12 @@
  *
  * <refsect2>
  * <title>Example launch lines</title>
- * <programlisting>
+ * |[
  * gst-launch filesrc location=example.mp4 ! qtdemux ! faad ! audioconvert ! audioresample ! autoaudiosink
- * </programlisting>
- * <programlisting>
+ * ]| Play aac from mp4 file.
+ * |[
  * gst-launch filesrc location=example.adts ! faad ! audioconvert ! audioresample ! autoaudiosink
- * </programlisting>
+ * ]| Play standalone aac bitstream.
  * </refsect2>
  */