Updated the outdated audio section somewhat.

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@14633 b3059339-0415-0410-9bf9-f77b7e298cf2

2 files changed, 13 insertions, 22 deletions

diff --git a/DOCS/xml/en/audio.xml b/DOCS/xml/en/audio.xml
index c22d04c0ae..3373c8a6aa 100644
--- a/DOCS/xml/en/audio.xml
+++ b/DOCS/xml/en/audio.xml
@@ -33,17 +33,14 @@ If you happen to have a bad audio driver, try the <option>-autosync</option>
 option, it should sort out your problems. See the man page for detailed
 information.
 </para>
+</sect2>
 
-<itemizedlist>
-<title>Some notes:</title>
-<listitem><para>
-  If you have an OSS driver, first try <option>-ao oss</option> (this is
-  the default).  If you experience glitches, halts or anything out of the
-  ordinary, try <option>-ao sdl</option> (NOTE: you need to have SDL libraries
-  and header files installed). The SDL audio driver helps in a lot of cases
-  and also supports ESD (GNOME) and ARTS (KDE).
-  </para></listitem>
-<listitem><para>
+<sect2 id="troubleshooting">
+<title>Troubleshooting</title>
+
+<para>Some notes:</para>
+
+<para>
   If you have ALSA version 0.5, then you almost always have to use
   <option>-ao alsa5</option>, since ALSA 0.5 has buggy OSS emulation code,
   and will <emphasis role="bold">crash <application>MPlayer</application></emphasis>
@@ -51,18 +48,11 @@ information.
   <screen>
 DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!<!--
 --></screen>
-  </para></listitem>
-<listitem><para>
-  On Solaris, use the SUN audio driver with the <option>-ao sun</option> option,
-  otherwise neither video nor audio will work.
-  </para></listitem>
-<listitem><para>
-  If the sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g.
-  <command>hdparm -u1 /dev/cdrom</command> (<command>man hdparm</command>).
-  This is generally beneficial and described in more detail in the
-  <link linkend="drives">CD-ROM</link> section.
- </para></listitem>
-</itemizedlist>
+</para>
+<para>
+  If the sound clicks when playing from CD-ROM, turn on IRQ unmasking as
+  described in the <link linkend="drives">CD-ROM</link> section.
+</para>
 </sect2>
 
 <sect2 id="experiences">
diff --git a/DOCS/xml/en/ports.xml b/DOCS/xml/en/ports.xml
index 8a4c48c209..6020cd5a20 100644
--- a/DOCS/xml/en/ports.xml
+++ b/DOCS/xml/en/ports.xml
@@ -145,6 +145,7 @@ See the <link linkend="macos">Mac OS</link> section.
 <title>Sun Solaris</title>
 <para>
 <application>MPlayer</application> should work on Solaris 2.6 or newer.
+Use the SUN audio driver with the <option>-ao sun</option> option for sound.
 </para>
 
 <para>