[xiph-cvs] cvs commit: ao/doc drivers.html

[Stan Seibert]

volsung     04/03/11 22:37:46

  Modified:    doc      drivers.html
  Log:
  Clean up ALSA driver descriptions.

Revision  Changes    Path
1.10      +10 -9     ao/doc/drivers.html

Index: drivers.html
===================================================================
RCS file: /usr/local/cvsroot/ao/doc/drivers.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- a/drivers.html	12 Mar 2004 03:22:38 -0000	1.9
+++ b/drivers.html	12 Mar 2004 03:37:46 -0000	1.10
@@ -44,13 +44,13 @@
 <h3>alsa</h3>
 
 Advanced Linux Sound Architecture.  This driver borrows some code from
-Jaroslav Kysela's <perex at suse.cz> GPLed aplay that is included with
+Jaroslav Kysela's &lt;perex at suse.cz&gt; GPLed aplay that is included with
 the alsa-util distribution.  It defaults to device 0 on card 0.
 Because of the way ALSA reads data, this driver packs sound from
 successive calls into a fixed size buffer (defaults to 32kB) and sends
-it to the card.  Note that this driver only works with ALSA 0.5.x.  It
-will be updated to the newer API once it stabilizes and is better
-documented.
+it to the card.  Note that this driver only works with ALSA 0.5.x.
+You should use the <tt>alsa09</tt> driver for the ALSA 0.9.x or 1.0.x
+series.
 <p>
 
 <b>Option keys:</b>
@@ -66,15 +66,16 @@
 
 <h3>alsa09</h3>
 
-Advanced Linux Sound Architecture, version 0.9.x API.  This is
-essentially the alsa driver modified to use the newer API.
+Advanced Linux Sound Architecture, version 0.9.x and 1.0.x API.  This 
+is essentially the alsa driver modified to use the newer API.
 <p>
 
 <b>Option keys:</b>
 <ul>
 <li>"dev" - Device name of sound card.  Defaults to "default".
-<li>"buf_size" - Override the internal buffer size (in bytes).  
-Experiment with this if the sound skips.  Default is 32768.
+<li>"buf_time" - Override the hardward buffer size (in milliseconds).  
+<li>"period_time" - Override the size of periods ALSA uses.
+<li>"use_mmap" - Set to "1" to enable the use of memory-mapped I/O API.
 </ul>
 <p>
 
@@ -217,7 +218,7 @@
 <center>
 <table border="1">
   <tr><th>Priority</th><th>Drivers</th>              </tr>
-  <tr><td>30</td>      <td>alsa</td>                 </tr>
+  <tr><td>30</td>      <td>alsa, alsa09</td>         </tr>
   <tr><td>20</td>      <td>oss, irix, sun</td>       </tr>
   <tr><td>10</td>      <td>esd,arts</td>             </tr>
   <tr bgcolor="#888888"><td> 0</td>      <td>null, all file output</td></tr>

<p><p>--- >8 ----
List archives:  http://www.xiph.org/archives/
Ogg project homepage: http://www.xiph.org/ogg/
To unsubscribe from this list, send a message to 'cvs-request at xiph.org'
containing only the word 'unsubscribe' in the body.  No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.