diff --git a/gst/audioparsers/gstaacparse.c b/gst/audioparsers/gstaacparse.c
index 005f1bdd3a..4dd2dc761b 100644
--- a/gst/audioparsers/gstaacparse.c
+++ b/gst/audioparsers/gstaacparse.c
@@ -24,24 +24,17 @@
  * @short_description: AAC parser
  * @see_also: #GstAmrParse
  *
+ * This is an AAC parser which handles both ADIF and ADTS stream formats.
+ *
+ * As ADIF format is not framed, it is not seekable and stream duration cannot
+ * be determined either. However, ADTS format AAC clips can be seeked, and parser
+ * can also estimate playback position and clip duration.
+ *
  * <refsect2>
- * <para>
- * This is an AAC parser. It can handle both ADIF and ADTS stream formats.
- * The parser inherits from #GstBaseParse and therefore in only needs to
- * implement AAC-specific functionality.
- * </para>
- * <para>
- * As ADIF format is not framed, it is not seekable. From the same reason
- * stream duration cannot be calculated either. Instead, AAC clips that are
- * in ADTS format can be seeked, and parser also is able to calculate their
- * playback position and clip duration.
- * </para>
  * <title>Example launch line</title>
- * <para>
- * <programlisting>
+ * |[
  * gst-launch filesrc location=abc.aac ! aacparse ! faad ! audioresample ! audioconvert ! alsasink
- * </programlisting>
- * </para>
+ * ]|
  * </refsect2>
  */
 
diff --git a/gst/audioparsers/gstac3parse.c b/gst/audioparsers/gstac3parse.c
index 2ce112bf37..96e9a911ea 100644
--- a/gst/audioparsers/gstac3parse.c
+++ b/gst/audioparsers/gstac3parse.c
@@ -24,16 +24,13 @@
  * @short_description: AC3 parser
  * @see_also: #GstAmrParse, #GstAACParse
  *
- * <refsect2>
- * <para>
  * This is an AC3 parser.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
- * <programlisting>
+ * |[
  * gst-launch filesrc location=abc.ac3 ! ac3parse ! a52dec ! audioresample ! audioconvert ! autoaudiosink
- * </programlisting>
- * </para>
+ * ]|
  * </refsect2>
  */
 
diff --git a/gst/audioparsers/gstamrparse.c b/gst/audioparsers/gstamrparse.c
index 6fb797ebb8..a182e765b4 100644
--- a/gst/audioparsers/gstamrparse.c
+++ b/gst/audioparsers/gstamrparse.c
@@ -25,17 +25,14 @@
  * @short_description: AMR parser
  * @see_also: #GstAmrnbDec, #GstAmrnbEnc
  *
- * <refsect2>
- * <para>
  * This is an AMR parser capable of handling both narrow-band and wideband
  * formats.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
- * <programlisting>
+ * |[
  * gst-launch filesrc location=abc.amr ! amrparse ! amrdec ! audioresample ! audioconvert ! alsasink
- * </programlisting>
- * </para>
+ * ]|
  * </refsect2>
  */