From 6335307b9739beb568f986bfc8a4c1e1fb2b8e31 Mon Sep 17 00:00:00 2001
From: Stefan Kost <ensonic@users.sf.net>
Date: Thu, 29 Jan 2009 10:10:08 +0200
Subject: Update and add documentation for platform specific plugins (sys).

Link to properties. Correct titles for examples. Fix examples.
---
 sys/waveform/gstwaveformsink.c | 28 +++++++++-------------------
 1 file changed, 9 insertions(+), 19 deletions(-)

(limited to 'sys/waveform')

diff --git a/sys/waveform/gstwaveformsink.c b/sys/waveform/gstwaveformsink.c
index e709d649..a5614168 100644
--- a/sys/waveform/gstwaveformsink.c
+++ b/sys/waveform/gstwaveformsink.c
@@ -21,32 +21,23 @@
 
 /**
  * SECTION:element-waveformsink
- * @short_description: output sound using WaveForm API
  *
- * <refsect2>
- * <para>
- * This element lets you output sound using the WaveForm API.
- * </para>
- * <para>
+ * This element lets you output sound using the Windows WaveForm API.
+ *
  * Note that you should almost always use generic audio conversion elements
  * like audioconvert and audioresample in front of an audiosink to make sure
  * your pipeline works under all circumstances (those conversion elements will
  * act in passthrough-mode if no conversion is necessary).
- * </para>
+ *
+ * <refsect2>
  * <title>Example pipelines</title>
- * <para>
- * <programlisting>
+ * |[
  * gst-launch-0.10 -v audiotestsrc ! audioconvert ! volume volume=0.1 ! waveformsink
- * </programlisting>
- * will output a sine wave (continuous beep sound) to your sound card (with
+ * ]| will output a sine wave (continuous beep sound) to your sound card (with
  * a very low volume as precaution).
- * </para>
- * <para>
- * <programlisting>
+ * |[
  * gst-launch-0.10 -v filesrc location=music.ogg ! decodebin ! audioconvert ! audioresample ! waveformsink
- * </programlisting>
- * will play an Ogg/Vorbis audio file and output it.
- * </para>
+ * ]| will play an Ogg/Vorbis audio file and output it.
  * </refsect2>
  */
 
@@ -435,8 +426,7 @@ gst_waveform_sink_unprepare (GstAudioSink * asink)
 
     for (index = 0; index < wfsink->buffer_count; index++) {
       if (wfsink->wave_buffers[index].dwFlags & WHDR_PREPARED) {
-        MMRESULT mmresult =
-            waveOutUnprepareHeader (wfsink->hwaveout,
+        MMRESULT mmresult = waveOutUnprepareHeader (wfsink->hwaveout,
             &wfsink->wave_buffers[index], sizeof (WAVEHDR));
         if (mmresult != MMSYSERR_NOERROR) {
           waveOutGetErrorText (mmresult, wfsink->error_string,
-- 
cgit