Add a more comprehensive Synopsis to this chapter. Ideally, each

chapter should start out with a parapgraph about the content, a list
of things that will be covered, and a list of things that you should
already know.

Hashed out with: Nik

1 files changed, 43 insertions, 6 deletions

diff --git a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
index c6456fe25a..5c29bdf292 100644
--- a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
@@ -1,20 +1,57 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.8 2001/07/19 23:18:09 chern Exp $
+     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.9 2001/07/20 23:25:05 chern Exp $
 -->
 
 <chapter id="sound">
-  <title>Sound</title>
+  <chapterinfo>
+    <authorgroup>
+      <author>
+        <firstname>Moses</firstname>
+	<surname>Moore</surname>
+	<contrib>Contributed</contrib>
+      </author>
+    </authorgroup>
+    <!-- 20 November 2000 -->
+  </chapterinfo>
 
-  <para><emphasis>Contributed by Moses Moore
-    <email>jm-moses@home.com</email>, 20 November 2000.</emphasis></para>
+  <title>Sound</title>
 
   <sect1>
     <title>Synopsis</title>
 
-    <para>This chapter of the handbook deals with setting up sound on a
-      FreeBSD system.</para>
+    <para>FreeBSD supports a wide variety of sound cards, allowing you
+      to enjoy high fidelity output from your computer.  This includes
+      the ability to record and playback audio in the MPEG Audio Layer
+      3 (MP3), WAV, and Ogg Vorbis formats as well as many other
+      formats.  The FreeBSD Ports Collection also contains
+      applications allowing you to edit your recorded audio, add sound
+      effects, and control attached MIDI devices.</para>
+
+<!-- XXX we need to talk about ripping MP3s here. -->
+
+    <para>After reading this chapter you will know how to :</para>
+    <itemizedlist>
+      <listitem><para>Find your sound card.</para></listitem>
+      <listitem><para>Configure your system so that your sound card is
+      recognized.</para></listitem>
+      <listitem><para>Test that your card is working using
+      sample applications.</para></listitem>
+      <listitem><para>Troubleshoot your sound setup.</para></listitem>
+    </itemizedlist>
+
+    <para>Before reading this chapter, you should be comfortable doing
+      the following :</para>
+
+    <itemizedlist>
+      <listitem><para>Installing and configuring a new kernel (<xref
+        linkend="kernelconfig">)</para></listitem>
+    </itemizedlist>
+
+<!--      <listitem><para>It is assumed that you understand how to
+      configure and build a custom kernel (<xref
+      linkend="kernelconfig">). -->
   </sect1>
 
   <sect1>