Revise sound chapter:

 * Include correct instructions to create sound device nodes
 * Mention 'options PNPBIOS' for onboard sound

Partially Submitted by: Gerald Pfeifer <pfeifer@dbai.tuwien.ac.at>
PR:		23910

1 files changed, 34 insertions, 24 deletions

diff --git a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
index 0a47a77442..fac0de747a 100644
--- a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
@@ -1,7 +1,7 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.17 2001/09/12 20:26:59 chern Exp $
+     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.18 2001/09/12 21:50:21 chern Exp $
 -->
 
 <chapter id="sound">
@@ -199,6 +199,16 @@ device csa</programlisting>
 	the IRQ or the other settings to match your card.</para>
 
     </sect2>
+
+    <sect2>
+      <title>Onboard Sound</title>
+
+      <para>Some systems with built-in motherboard sound devices may
+	require the following option in your kernel
+	configuration:</para>
+
+      <programlisting>options PNPBIOS</programlisting>
+    </sect2>
   </sect1>
 
   <sect1>
@@ -214,36 +224,36 @@ device csa</programlisting>
     <title>Creating and Testing the Device Nodes</title>
 
     <indexterm><primary>device nodes</primary></indexterm>
-    <para>After you reboot, log in and run <command>cat
-      /dev/sndstat</command>.  You should see output similar to the
-      following:</para>
+    <para>After you reboot, log in and run <command>dmesg | grep pcm</command> as shown
+      below:</para>
 
-    <programlisting>FreeBSD Audio Driver (newpcm) Sep 21 2000 18:29:53
-Installed devices:
-pcm0: &lt;Aureal Vortex 8830&gt; at memory 0xfeb40000 irq 5 (4p/1r +channels duplex)</programlisting>
+    <screen>&prompt.root; dmesg | grep pcm
+pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen>
 
-    <para>If you see an error message, something went wrong earlier.  If
-      that happens, go through your kernel configuration file again and
-      make sure you chose the correct device.</para>
+    <para>The output from your system may look different.  If no
+      <devicename>pcm</devicename> devices show up, something went wrong
+      earlier.  If that happens, go through your kernel configuration
+      file again and make sure you chose the correct device.  Consult
+      the troubleshooting section for additional options.</para>
 
-    <para>If it reported no errors and returned
-      <devicename>pcm0</devicename>, <command>su</command> to
-      <username>root</username> and do the following:</para>
+    <para>If the previous command returned <devicename>pcm0</devicename>,
+      you will have to run the following as root:</para>
 
-    <screen>&prompt.root; <userinput>cd /dev</userinput>
-&prompt.root; <userinput>sh MAKEDEV snd0</userinput></screen>
+    <screen>&prompt.root; cd /dev
+&prompt.root; sh MAKEDEV snd0</screen>
 
-    <para>If it reported no errors and returned
-      <devicename>pcm1</devicename>, <command>su</command> to
-      <username>root</username> and do the following:</para>
+    <para>If the command returned <devicename>pcm1</devicename>,
+      follow the same steps as shown above, replacing
+      <devicename>snd0</devicename> with
+      <devicename>snd1</devicename>.</para>
 
-    <screen>&prompt.root; <userinput>cd /dev</userinput>
-&prompt.root; <userinput>sh MAKEDEV snd1</userinput></screen>
+    <note>
+      <para>The above commands will <emphasis>not</emphasis> create a
+	<devicename>/dev/snd</devicename> device!</para>
+    </note>
 
-    <para>Please note that either of the above commands will
-      <emphasis>not</emphasis> create a
-      <devicename>/dev/snd</devicename> device!  Instead it creates a
-      group of device nodes including:</para>
+    <para><command>MAKEDEV</command> will create a group of device
+      nodes, including:</para>
 
     <informaltable frame="none">
       <tgroup cols="2">