cvs commit: doc/en_US.ISO8859-1/books/handbook/multimedia chapter.sgml

[Marc Fonvieille]

On Sun, Jun 20, 2004 at 04:34:40PM +0000, Josef El-Rayes wrote:
> josef       2004-06-20 16:34:40 UTC
> 
>   FreeBSD doc repository
> 
>   Modified files:
>     en_US.ISO8859-1/books/handbook/multimedia chapter.sgml 
>   Log:
>   Document the possibility of setting default values for
>   mixer channels via boot loader.
>   While I am here, document the snd_driver metadriver.
>   
 
Hello,

     <para>To use your sound device, you will need to load the proper
-      device driver.  This may be accomplished in one of two ways.
+      device driver.  If you are not sure which driver to use, you may
+      try to load snd_driver, which is a metadriver loading the most common
+      device drivers at once, this speeds up the search for the correct driver.
+      Loading the device driver 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; which can either be done from the
       command line:</para>

I think you had to put that later just after

    <para>These examples are for a Creative &soundblaster; Live! sound
      card.  Other available loadable sound modules are listed in
      <filename>/boot/defaults/loader.conf</filename>.</para>

cause in your case you "break" the "This may be accomplished in one of
two ways." statement and it could be confusing for the reader.
"snd_driver" must also be tagged.

@@ -522,7 +525,34 @@ pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</scr
       to 4 as in the above example.  On a system using &man.devfs.5;, the above will automatically be
       allocated transparently to the user.</para>
    </sect2>
-  </sect1>
+
+  <sect2>
+    <sect2info>
+      <authorgroup>
+	<author>
+	  <firstname>Josef</firstname>
+	  <surname>El-Rayes</surname>
+	  <contrib>Contributed by </contrib>
+	</author>
+      </authorgroup>
+    </sect2info>
+
+    <title>Setting default values for mixer channels</title>

		Chicago Style?

+
+    <para>The default values for the different mixer channels are
+      hardcoded in the sourcecode of the pcm driver.  There are

					&man.pcm.4; ?

+      a lot of different applications and daemons that allow
+      you to set values for the mixer they remember and set

				     ^^^ punctuation is missing ?

+      each time they are started, but this is not a clean
+      solution, we want to have default values at the driver
+      level.  This is accomplished by defining the apropriate
+      values in <filename>/boot/loader.conf</filename>. E.g.:</para>
+<programlisting>pcm0.vol="100"</programlisting>
+
+    <para>This will set the vol channel to a default value of

			     volume?

+      100, as soon as the pcm module gets loaded.</para>

			  &man.pcm.4; ?

+  </sect2>
+</sect1>
 

Marc