diff --git a/gst/interleave/deinterleave.c b/gst/interleave/deinterleave.c
index 6f2b0cefbe..4c81d39db0 100644
--- a/gst/interleave/deinterleave.c
+++ b/gst/interleave/deinterleave.c
@@ -32,35 +32,29 @@
 
 /**
  * SECTION:element-deinterleave
+ * @see_also: interleave
  *
- * <refsect2>
- * <para>
  * Splits one interleaved multichannel audio stream into many mono audio streams.
- * </para>
- * <para>
+ * 
  * This element handles all raw audio formats and supports changing the input caps as long as
  * all downstream elements can handle the new caps and the number of channels and the channel
  * positions stay the same. This restriction will be removed in later versions by adding or
  * removing some source pads as required.
- * </para>
- * <para>
+ * 
  * In most cases a queue and an audioconvert element should be added after each source pad
  * before further processing of the audio data.
- * </para>
+ * 
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
- * <programlisting>
+ * |[
  * gst-launch-0.10 filesrc location=/path/to/file.mp3 ! decodebin ! audioconvert ! "audio/x-raw-int,channels=2 ! deinterleave name=d  d.src0 ! queue ! audioconvert ! vorbisenc ! oggmux ! filesink location=channel1.ogg  d.src1 ! queue ! audioconvert ! vorbisenc ! oggmux ! filesink location=channel2.ogg
- * </programlisting>
- * Decodes an MP3 file and encodes the left and right channel into separate Ogg Vorbis files.
- * </para>
- * <para>
- * <programlisting>
+ * ]| Decodes an MP3 file and encodes the left and right channel into separate
+ * Ogg Vorbis files.
+ * |[
  * gst-launch-0.10 filesrc location=file.mp3 ! decodebin ! audioconvert ! "audio/x-raw-int,channels=2" ! deinterleave name=d  interleave name=i ! audioconvert ! wavenc ! filesink location=test.wav    d.src0 ! queue ! audioconvert ! i.sink1    d.src1 ! queue ! audioconvert ! i.sink0
- * </programlisting>
- * Decodes and deinterleaves a Stereo MP3 file into separate channels and then interleaves the channels
- * again to a WAV file with the channel with the channels exchanged.
- * </para>
+ * ]| Decodes and deinterleaves a Stereo MP3 file into separate channels and
+ * then interleaves the channels again to a WAV file with the channel with the
+ * channels exchanged.
  * </refsect2>
  */
 
diff --git a/gst/interleave/interleave.c b/gst/interleave/interleave.c
index 76843e45a7..831e928fcb 100644
--- a/gst/interleave/interleave.c
+++ b/gst/interleave/interleave.c
@@ -30,38 +30,30 @@
 
 /**
  * SECTION:element-interleave
+ * @see_also: deinterleave
  *
- * <refsect2>
- * <para>
  * Merges separate mono inputs into one interleaved stream.
- * </para>
- * <para>
+ * 
  * This element handles all raw floating point sample formats and all signed integer sample formats. The first
  * caps on one of the sinkpads will set the caps of the output so usually an audioconvert element should be
  * placed before every sinkpad of interleave.
- * </para>
- * <para>
+ * 
  * It's possible to change the number of channels while the pipeline is running by adding or removing
  * some of the request pads but this will change the caps of the output buffers. Changing the input
  * caps is _not_ supported yet.
- * </para>
- * <para>
+ * 
  * The channel number of every sinkpad in the out can be retrieved from the "channel" property of the pad.
- * </para>
+ * 
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
- * <programlisting>
+ * |[
  * gst-launch-0.10 filesrc location=file.mp3 ! decodebin ! audioconvert ! "audio/x-raw-int,channels=2" ! deinterleave name=d  interleave name=i ! audioconvert ! wavenc ! filesink location=test.wav    d.src0 ! queue ! audioconvert ! i.sink1    d.src1 ! queue ! audioconvert ! i.sink0
- * </programlisting>
- * Decodes and deinterleaves a Stereo MP3 file into separate channels and then interleaves the channels
- * again to a WAV file with the channel with the channels exchanged.
- * </para>
- * <para>
- * <programlisting>
+ * ]| Decodes and deinterleaves a Stereo MP3 file into separate channels and
+ * then interleaves the channels again to a WAV file with the channel with the
+ * channels exchanged.
+ * |[
  * gst-launch-0.10 interleave name=i ! audioconvert ! wavenc ! filesink location=file.wav  filesrc location=file1.wav ! decodebin ! audioconvert ! "audio/x-raw-int,channels=1" ! queue ! i.sink0   filesrc location=file2.wav ! decodebin ! audioconvert ! "audio/x-raw-int,channels=1" ! queue ! i.sink1
- * </programlisting>
- * Interleaves two Mono WAV files to a single Stereo WAV file.
- * </para>
+ * ]| Interleaves two Mono WAV files to a single Stereo WAV file.
  * </refsect2>
  */