diff --git a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
index 60b7ad1b7d..12485dcf49 100644
--- a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
@@ -1,326 +1,334 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO_8859-1/books/handbook/sound/chapter.sgml,v 1.4 2000/12/06 21:27:12 dannyboy Exp $
+     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.5 2001/04/09 00:33:57 dd Exp $
 -->
 
 <chapter id="sound">
   <title>Sound</title>
 
   <para><emphasis>Contributed by Moses Moore
     <email>jm-moses@home.com</email>, 20 November 2000.</emphasis></para>
 
   <sect1>
     <title>Synopsis</title>
 
     <para>This chapter of the handbook deals with setting up sound on a
       FreeBSD system.</para>
   </sect1>
 
   <sect1>
     <title>Locating the Correct Device</title>
 
+    <indexterm><primary>PCI</primary></indexterm>
+    <indexterm><primary>ISA</primary></indexterm>
+    <indexterm><primary>sound cards</primary></indexterm>
     <para>Before you begin, you should know the model of the card you
       have, the chip it uses, and whether it is a PCI or ISA card.
       FreeBSD supports a wide variety of both PCI and ISA cards.  If you
       do not see your card in the following list, check the &man.pcm.4;
       manual page.  This is not a complete list; however, it does list
       some of the most common cards.</para>
 
     <itemizedlist>
       <listitem>
 	<para>Crystal 4237, 4236, 4232, 4231</para>
       </listitem>
 
       <listitem>
 	<para>Yamaha OPL-SAx</para>
       </listitem>
 
       <listitem>
 	<para>OPTi931</para>
       </listitem>
 
       <listitem>
 	<para>Ensoniq AudioPCI 1370/1371</para>
       </listitem>
 
       <listitem>
 	<para>ESS Solo-1/1E</para>
       </listitem>
 
       <listitem>
 	<para>NeoMagic 256AV/ZX</para>
       </listitem>
 
       <listitem>
 	<para>Sound Blaster Pro, 16, 32, AWE64, AWE128, Live</para>
       </listitem>
 
       <listitem>
 	<para>Creative ViBRA16</para>
       </listitem>
 
       <listitem>
 	<para>Advanced Asound 100, 110, and Logic ALS120</para>
       </listitem>
 
       <listitem>
 	<para>ES 1868, 1869, 1879, 1888</para>
       </listitem>
 
       <listitem>
 	<para>Gravis UltraSound</para>
       </listitem>
 
       <listitem>
 	<para>Aureal Vortex 1 or 2</para>
       </listitem>
     </itemizedlist>
 
+    <indexterm><primary>kernel</primary><secondary>configuration</secondary></indexterm>
     <para>The driver you use in your kernel depends on the kind of card
       you have.  The sections below provide more information and what
       you will need to add to your <link linkend="kernelconfig">kernel
       configuration</link>.</para>
 
     <sect2>
       <title>Creative, Advance, and ESS Sound Cards</title>
 
       <para>If you have one of the above cards, you will need to
 	add</para>
 	
       <programlisting>device pcm</programlisting>
 
       <para>to your kernel.  If you have a PnP ISA card, you will also
 	need to add</para>
 
       <programlisting>device sbc</programlisting>
 
       <para>to your kernel.  For a non-PnP ISA card, add</para>
 
       <programlisting>device pcm</programlisting>
       
       <para>and</para>
 
       <programlisting>device sbc0 at isa? port0x220 irq 5 drq 1 flags 0x15</programlisting>
 
       <para>to your kernel.  Those are the default settings.  You may
 	need to change the IRQ, etc.  See the &man.sbc.4; man page for
 	more information.</para>
 
       <note>
 	<para>The Sound Blaster Live is not supported under FreeBSD 4.0
 	  without a patch, which this document will not cover.  It is
 	  recommended that you update to the latest -STABLE before
 	  trying to use this card.</para>
       </note>
     </sect2>
 
     <sect2>
       <title>Gravis UltraSound Cards</title>
 
       <para>For a PnP ISA card, you will need to add</para>
 
       <programlisting>device pcm</programlisting>
 
       <para>and</para>
 
       <programlisting>device gusc</programlisting>
 
       <para>to your kernel.  If you have a non-PnP ISA card, you will
 	need to add</para>
 
       <programlisting>device pcm</programlisting>
 
       <para>and</para>
 
       <programlisting>device gus0 at isa? port 0x220 irq 5 drq 1 flags 0x13</programlisting>
 
       <para>to your kernel.  You may need to change the IRQ, etc.  See
 	the &man.gusc.4; man page for more information.</para>
     </sect2>
 
     <sect2>
       <title>Crystal Sound Cards</title>
 
       <para>For Crystal cards, you will need both</para>
 
       <programlisting>device pcm</programlisting>
 
       <para>and</para>
 
       <programlisting>device csa</programlisting>
 
       <para>in your kernel.</para>
     </sect2>
 
     <sect2>
       <title>Generic Support</title>
 
       <para>For PnP ISA or PCI cards, you will need to add</para>
 
       <programlisting>device pcm</programlisting>
 
       <para>to your kernel configuration.  If you have a non-PnP ISA
 	sound card that does not have a bridge driver, you will need
 	to add</para>
 
       <programlisting>device pcm0 at isa? irq 10 drq 1 flags 0x0</programlisting>
 
       <para>to your kernel configuration.  You may need to change the
 	IRQ, etc., to match your hardware configuration.</para>
     </sect2>
   </sect1>
 
   <sect1>
     <title>Recompiling the Kernel</title>
 
     <para>After adding the driver(s) you need to your kernel
       configuration, you will need to recompile your kernel.  Please see
       <xref linkend="kernelconfig-building"> of the handbook for
       more information.</para>
   </sect1>
 
   <sect1>
     <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>
 
     <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>
 
     <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>If it reported no errors and returned
       <devicename>pcm0</devicename>, <command>su</command> to
       <username>root</username> and do the following:</para>
 
     <screen>
 &prompt.root; <userinput>cd /dev</userinput>
 &prompt.root; <userinput>sh MAKEDEV snd0</userinput></screen>
 
     <para>If it reported no errors and returned
       <devicename>pcm1</devicename>, <command>su</command> to
       <username>root</username> and do the following:</para>
 
     <screen>
 &prompt.root; <userinput>cd /dev</userinput>
 &prompt.root; <userinput>sh MAKEDEV snd1</userinput></screen>
 
     <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>
 
     <informaltable frame="none">
       <tgroup cols="2">
 	<thead>
 	  <row>
 	    <entry>Device</entry>
 	    <entry>Description</entry>
 	  </row>
 	</thead>
 
 	<tbody>
 	  <row>
 	    <entry><devicename>/dev/audio</devicename></entry>
 	    <entry>SPARC-compatible audio device</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/dsp</devicename></entry>
 	    <entry>Digitized voice device</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/dspW</devicename></entry>
 	    <entry>Like <devicename>/dev/dsp</devicename>, but 16 bits
 	      per sample</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/midi</devicename></entry>
 	    <entry>Raw midi access device</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/mixer</devicename></entry>
 	    <entry>Control port mixer device</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/music</devicename></entry>
 	    <entry>Level 2 sequencer interface</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/sequencer</devicename></entry>
 	    <entry>Sequencer device</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/pss</devicename></entry>
 	    <entry>Programmable device interface</entry>
 	  </row>
 	</tbody>
       </tgroup>
     </informaltable>
 
     <para>If all goes well, you should now have a functioning sound
       card.  If you do not, see the next section.</para>
   </sect1>
 
   <sect1>
     <title>Common Problems</title>
 
     <qandaset>
+      <indexterm><primary>device node</primary></indexterm>
       <qandaentry>
 	<question>
 	  <para>I get an unsupported subdevice XX error!</para>
 	</question>
 
 	<answer>
 	  <para>One or more of the device nodes wasn't created
 	    correctly.  Repeat the steps above.</para>
 	</answer>
       </qandaentry>
 
+      <indexterm><primary>I/O port</primary></indexterm>
       <qandaentry>
 	<question>
 	  <para>I get a sb_dspwr(XX) timed out error!</para>
 	</question>
 
 	<answer>
 	  <para>The I/O port is not set correctly.</para>
 	</answer>
       </qandaentry>
 
+      <indexterm><primary>IRQ</primary></indexterm>
       <qandaentry>
 	<question>
 	  <para>I get a bad irq XX error!</para>
 	</question>
 
 	<answer>
 	  <para>The IRQ is set incorrectly.  Make sure that the set IRQ
 	    and the sound IRQ are the same.</para>
 	</answer>
       </qandaentry>
 
       <qandaentry>
 	<question>
 	  <para>I get a "xxx: gus pcm not attached, out of memory"
 	    error.  What causes that?</para>
 	</question>
 
 	<answer>
 	  <para>If this happens, it is because there is not enough
 	    available memory to use the device.</para>
 	</answer>
       </qandaentry>
     </qandaset>
   </sect1>
 </chapter>
diff --git a/en_US.ISO8859-1/books/handbook/sound/chapter.sgml b/en_US.ISO8859-1/books/handbook/sound/chapter.sgml
index 60b7ad1b7d..12485dcf49 100644
--- a/en_US.ISO8859-1/books/handbook/sound/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/sound/chapter.sgml
@@ -1,326 +1,334 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO_8859-1/books/handbook/sound/chapter.sgml,v 1.4 2000/12/06 21:27:12 dannyboy Exp $
+     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.5 2001/04/09 00:33:57 dd Exp $
 -->
 
 <chapter id="sound">
   <title>Sound</title>
 
   <para><emphasis>Contributed by Moses Moore
     <email>jm-moses@home.com</email>, 20 November 2000.</emphasis></para>
 
   <sect1>
     <title>Synopsis</title>
 
     <para>This chapter of the handbook deals with setting up sound on a
       FreeBSD system.</para>
   </sect1>
 
   <sect1>
     <title>Locating the Correct Device</title>
 
+    <indexterm><primary>PCI</primary></indexterm>
+    <indexterm><primary>ISA</primary></indexterm>
+    <indexterm><primary>sound cards</primary></indexterm>
     <para>Before you begin, you should know the model of the card you
       have, the chip it uses, and whether it is a PCI or ISA card.
       FreeBSD supports a wide variety of both PCI and ISA cards.  If you
       do not see your card in the following list, check the &man.pcm.4;
       manual page.  This is not a complete list; however, it does list
       some of the most common cards.</para>
 
     <itemizedlist>
       <listitem>
 	<para>Crystal 4237, 4236, 4232, 4231</para>
       </listitem>
 
       <listitem>
 	<para>Yamaha OPL-SAx</para>
       </listitem>
 
       <listitem>
 	<para>OPTi931</para>
       </listitem>
 
       <listitem>
 	<para>Ensoniq AudioPCI 1370/1371</para>
       </listitem>
 
       <listitem>
 	<para>ESS Solo-1/1E</para>
       </listitem>
 
       <listitem>
 	<para>NeoMagic 256AV/ZX</para>
       </listitem>
 
       <listitem>
 	<para>Sound Blaster Pro, 16, 32, AWE64, AWE128, Live</para>
       </listitem>
 
       <listitem>
 	<para>Creative ViBRA16</para>
       </listitem>
 
       <listitem>
 	<para>Advanced Asound 100, 110, and Logic ALS120</para>
       </listitem>
 
       <listitem>
 	<para>ES 1868, 1869, 1879, 1888</para>
       </listitem>
 
       <listitem>
 	<para>Gravis UltraSound</para>
       </listitem>
 
       <listitem>
 	<para>Aureal Vortex 1 or 2</para>
       </listitem>
     </itemizedlist>
 
+    <indexterm><primary>kernel</primary><secondary>configuration</secondary></indexterm>
     <para>The driver you use in your kernel depends on the kind of card
       you have.  The sections below provide more information and what
       you will need to add to your <link linkend="kernelconfig">kernel
       configuration</link>.</para>
 
     <sect2>
       <title>Creative, Advance, and ESS Sound Cards</title>
 
       <para>If you have one of the above cards, you will need to
 	add</para>
 	
       <programlisting>device pcm</programlisting>
 
       <para>to your kernel.  If you have a PnP ISA card, you will also
 	need to add</para>
 
       <programlisting>device sbc</programlisting>
 
       <para>to your kernel.  For a non-PnP ISA card, add</para>
 
       <programlisting>device pcm</programlisting>
       
       <para>and</para>
 
       <programlisting>device sbc0 at isa? port0x220 irq 5 drq 1 flags 0x15</programlisting>
 
       <para>to your kernel.  Those are the default settings.  You may
 	need to change the IRQ, etc.  See the &man.sbc.4; man page for
 	more information.</para>
 
       <note>
 	<para>The Sound Blaster Live is not supported under FreeBSD 4.0
 	  without a patch, which this document will not cover.  It is
 	  recommended that you update to the latest -STABLE before
 	  trying to use this card.</para>
       </note>
     </sect2>
 
     <sect2>
       <title>Gravis UltraSound Cards</title>
 
       <para>For a PnP ISA card, you will need to add</para>
 
       <programlisting>device pcm</programlisting>
 
       <para>and</para>
 
       <programlisting>device gusc</programlisting>
 
       <para>to your kernel.  If you have a non-PnP ISA card, you will
 	need to add</para>
 
       <programlisting>device pcm</programlisting>
 
       <para>and</para>
 
       <programlisting>device gus0 at isa? port 0x220 irq 5 drq 1 flags 0x13</programlisting>
 
       <para>to your kernel.  You may need to change the IRQ, etc.  See
 	the &man.gusc.4; man page for more information.</para>
     </sect2>
 
     <sect2>
       <title>Crystal Sound Cards</title>
 
       <para>For Crystal cards, you will need both</para>
 
       <programlisting>device pcm</programlisting>
 
       <para>and</para>
 
       <programlisting>device csa</programlisting>
 
       <para>in your kernel.</para>
     </sect2>
 
     <sect2>
       <title>Generic Support</title>
 
       <para>For PnP ISA or PCI cards, you will need to add</para>
 
       <programlisting>device pcm</programlisting>
 
       <para>to your kernel configuration.  If you have a non-PnP ISA
 	sound card that does not have a bridge driver, you will need
 	to add</para>
 
       <programlisting>device pcm0 at isa? irq 10 drq 1 flags 0x0</programlisting>
 
       <para>to your kernel configuration.  You may need to change the
 	IRQ, etc., to match your hardware configuration.</para>
     </sect2>
   </sect1>
 
   <sect1>
     <title>Recompiling the Kernel</title>
 
     <para>After adding the driver(s) you need to your kernel
       configuration, you will need to recompile your kernel.  Please see
       <xref linkend="kernelconfig-building"> of the handbook for
       more information.</para>
   </sect1>
 
   <sect1>
     <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>
 
     <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>
 
     <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>If it reported no errors and returned
       <devicename>pcm0</devicename>, <command>su</command> to
       <username>root</username> and do the following:</para>
 
     <screen>
 &prompt.root; <userinput>cd /dev</userinput>
 &prompt.root; <userinput>sh MAKEDEV snd0</userinput></screen>
 
     <para>If it reported no errors and returned
       <devicename>pcm1</devicename>, <command>su</command> to
       <username>root</username> and do the following:</para>
 
     <screen>
 &prompt.root; <userinput>cd /dev</userinput>
 &prompt.root; <userinput>sh MAKEDEV snd1</userinput></screen>
 
     <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>
 
     <informaltable frame="none">
       <tgroup cols="2">
 	<thead>
 	  <row>
 	    <entry>Device</entry>
 	    <entry>Description</entry>
 	  </row>
 	</thead>
 
 	<tbody>
 	  <row>
 	    <entry><devicename>/dev/audio</devicename></entry>
 	    <entry>SPARC-compatible audio device</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/dsp</devicename></entry>
 	    <entry>Digitized voice device</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/dspW</devicename></entry>
 	    <entry>Like <devicename>/dev/dsp</devicename>, but 16 bits
 	      per sample</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/midi</devicename></entry>
 	    <entry>Raw midi access device</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/mixer</devicename></entry>
 	    <entry>Control port mixer device</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/music</devicename></entry>
 	    <entry>Level 2 sequencer interface</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/sequencer</devicename></entry>
 	    <entry>Sequencer device</entry>
 	  </row>
 
 	  <row>
 	    <entry><devicename>/dev/pss</devicename></entry>
 	    <entry>Programmable device interface</entry>
 	  </row>
 	</tbody>
       </tgroup>
     </informaltable>
 
     <para>If all goes well, you should now have a functioning sound
       card.  If you do not, see the next section.</para>
   </sect1>
 
   <sect1>
     <title>Common Problems</title>
 
     <qandaset>
+      <indexterm><primary>device node</primary></indexterm>
       <qandaentry>
 	<question>
 	  <para>I get an unsupported subdevice XX error!</para>
 	</question>
 
 	<answer>
 	  <para>One or more of the device nodes wasn't created
 	    correctly.  Repeat the steps above.</para>
 	</answer>
       </qandaentry>
 
+      <indexterm><primary>I/O port</primary></indexterm>
       <qandaentry>
 	<question>
 	  <para>I get a sb_dspwr(XX) timed out error!</para>
 	</question>
 
 	<answer>
 	  <para>The I/O port is not set correctly.</para>
 	</answer>
       </qandaentry>
 
+      <indexterm><primary>IRQ</primary></indexterm>
       <qandaentry>
 	<question>
 	  <para>I get a bad irq XX error!</para>
 	</question>
 
 	<answer>
 	  <para>The IRQ is set incorrectly.  Make sure that the set IRQ
 	    and the sound IRQ are the same.</para>
 	</answer>
       </qandaentry>
 
       <qandaentry>
 	<question>
 	  <para>I get a "xxx: gus pcm not attached, out of memory"
 	    error.  What causes that?</para>
 	</question>
 
 	<answer>
 	  <para>If this happens, it is because there is not enough
 	    available memory to use the device.</para>
 	</answer>
       </qandaentry>
     </qandaset>
   </sect1>
 </chapter>