docs/53316: Small update/correction to multimedia/chapter.sgml

[Alexey Dokuchaev]

>Number:         53316
>Category:       docs
>Synopsis:       Small update/correction to multimedia/chapter.sgml
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jun 14 06:30:10 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Alexey Dokuchaev
>Release:        FreeBSD 4.8-RC i386
>Organization:
CNIT NSU
>Environment:
System: FreeBSD regency.nsu.ru 4.8-RC FreeBSD 4.8-RC #2: Fri Mar 7 17:30:50 NOVT 2003 root at regency.nsu.ru:/usr/obj/usr/src/sys/REGENCY i386
>Description:
It seems like multimedia/chapter.sgml can (should) be tweaked so it

	- mention (explicitly + example) ability to load snd_* KLD in
	  /boot/loader.conf

	- correct a typo in output of mpg123(1) utility (used in
	  example)

	- add information about audio/cdparanoia, since it's generally
	  considered the best software for ripping audio CDs.  Since it
	  was included in the ports rather recently, for now, it seems
	  natural to leave cdda2wav tool the default, but later we migth
	  want to write a bit more on cdparanoia.  By the way, mention
	  audio/dagrab as well, since quite a few people are using it
>How-To-Repeat:
N/A
>Fix:
Apply the following patch:

--- chapter.sgml.orig	Sat Jun 14 19:40:05 2003
+++ chapter.sgml	Sat Jun 14 20:27:24 2003
@@ -190,12 +190,18 @@
     <para>To use your sound device, you will need to load the proper
       device driver.  This may be accomplished in one of two ways.
       The easiest way is to simply load a kernel module for your sound
-      card with &man.kldload.8;.  Alternatively, you may statically
-      compile in support for your sound card in your kernel.  The
-      sections below provide the information you need to add support
-      for your hardware in this manner.  For more information about
-      recompiling your kernel, please see <xref
-      linkend="kernelconfig">.</para>
+      card with &man.kldload.8; which can either be done on fly, or
+      (a bit more handy way) by adding appropriate line to
+      <filename>/boot/loader.conf</filename> like this (below example is
+      for Creative Sound Blaster Live! sound card):</para>
+
+    <programlisting>snd_emu10k1_load="YES"</programlisting>
+
+    <para>Alternatively, you may statically compile in support for your
+      sound card in your kernel.  The sections below provide the
+      information you need to add support for your hardware in this
+      manner.  For more information about recompiling your kernel,
+      please see <xref linkend="kernelconfig">.</para>
 
     <sect3>
       <title>Creative, Advance, and ESS Sound Cards</title>
@@ -544,7 +550,7 @@
 	the sound device and the MP3 file on the command line, as
 	shown below:</para>
 
-      <screen>&prompt.root; <userinput>mpg123 -a <replaceable>/dev/dsp1.0</replaceable> Foobar-GreatestHits.mp3</userinput>
+      <screen>&prompt.root; <userinput>mpg123 -a <replaceable>/dev/dsp1.0</replaceable> "BT - Foobar-GreatestHits.mp3"</userinput>
 High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2 and 3.
 Version 0.59r (1999/Jun/15). Written and copyrights by Michael Hipp.
 Uses code from various people. See 'README' for more!
@@ -554,7 +560,7 @@
 
 
 
-Playing MPEG stream from BT - Foobar-GreastHits.mp3 ...
+Playing MPEG stream from BT - Foobar-GreatestHits.mp3 ...
 MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
 </screen>
 
@@ -604,6 +610,17 @@
 	range:</para>
 
       <screen>&prompt.root; <userinput>cdda2wav -D <replaceable>0,1,0</replaceable> -t 1+7</userinput></screen>
+
+      <para>You may also use <filename
+	role="package">audio/dagrab</filename> package as an alternative
+	to <filename role="package">sysutils/cdrtools</filename>.</para>
+
+      <para>There is another excellend utility for CD ripping available
+	in the Ports Collection: <filename
+	role="package">audio/cdparanoia</filename>, as well as several
+	scripts for automation of process of ripping, encoding, tagging,
+	and managing your MP3 and/or Ogg files (<filename
+	role="package">audio/cd2mp3</filename> is one of alike).<para>
 
       <para>The utility &man.dd.1; can also be used to extract audio tracks
 	on ATAPI drives, read <xref linkend="duplicating-audiocds">

>Release-Note:
>Audit-Trail:
>Unformatted: