3 files changed, 14 insertions, 28 deletions
diff --git a/ext/pulse/pulsemixer.c b/ext/pulse/pulsemixer.c
index 3a0de9da..5ced971b 100644
--- a/ext/pulse/pulsemixer.c
+++ b/ext/pulse/pulsemixer.c
@@ -21,16 +21,14 @@
 
 /**
  * SECTION:element-pulsemixer
- * @short_description: Element to control sound input and output levels for the PulseAudio sound server
  * @see_also: pulsesrc, pulsesink
  *
- * <refsect2>
- * <para>
  * This element lets you adjust sound input and output levels for the
  * PulseAudio sound server. It supports the GstMixer interface, which can be
  * used to obtain a list of available mixer tracks. Set the mixer element to
  * READY state before using the GstMixer interface on it.
- * </para>
+ *
+ * <refsect2>
  * <title>Example pipelines</title>
  * <para>
  * pulsemixer can't be used in a sensible way in gst-launch.
diff --git a/ext/pulse/pulsesink.c b/ext/pulse/pulsesink.c
index df774990..b41dba50 100644
--- a/ext/pulse/pulsesink.c
+++ b/ext/pulse/pulsesink.c
@@ -21,28 +21,20 @@
 
 /**
  * SECTION:element-pulsesink
- * @short_description: Output audio to a PulseAudio sound server
  * @see_also: pulsesrc, pulsemixer
  *
+ * This element outputs audio to a
+ * <ulink href="http://www.pulseaudio.org">PulseAudio sound server</ulink>.
+ *
  * <refsect2>
- * <para>
- * This element outputs audio to a PulseAudio sound server.
- * </para>
  * <title>Example pipelines</title>
- * <para>
- * <programlisting>
+ * |[
  * gst-launch -v filesrc location=sine.ogg ! oggdemux ! vorbisdec ! audioconvert ! audioresample ! pulsesink
- * </programlisting>
- * Play an Ogg/Vorbis file.
- * </para>
- * <para>
- * <programlisting>
+ * ]| Play an Ogg/Vorbis file.
+ * |[
  * gst-launch -v audiotestsrc ! audioconvert ! volume volume=0.4 ! pulsesink
- * </programlisting>
- * Play a 440Hz sine wave.
- * </para>
+ * ]| Play a 440Hz sine wave.
  * </refsect2>
- *
  */
 
 #ifdef HAVE_CONFIG_H
diff --git a/ext/pulse/pulsesrc.c b/ext/pulse/pulsesrc.c
index 0e1ca20e..08fec595 100644
--- a/ext/pulse/pulsesrc.c
+++ b/ext/pulse/pulsesrc.c
@@ -21,20 +21,16 @@
 
 /**
  * SECTION:element-pulsesrc
- * @short_description: Capture audio from a PulseAudio sound server
  * @see_also: pulsesink, pulsemixer
  *
+ * This element captures audio from a
+ * <ulink href="http://www.pulseaudio.org">PulseAudio sound server</ulink>.
+ *
  * <refsect2>
- * <para>
- * This element captures audio from a PulseAudio sound server.
- * </para>
  * <title>Example pipelines</title>
- * <para>
- * <programlisting>
+ * |[
  * gst-launch -v pulsesrc ! audioconvert ! vorbisenc ! oggmux ! filesink location=alsasrc.ogg
- * </programlisting>
- * Record from a sound card using ALSA and encode to Ogg/Vorbis.
- * </para>
+ * ]| Record from a sound card using ALSA and encode to Ogg/Vorbis.
  * </refsect2>
  */