[libvirt] [PATCH] Add documentation for <sound> device XML format.

[Cole Robinson]

---
 docs/formatdomain.html    |   20 ++++++++++++++++++++
 docs/formatdomain.html.in |   24 ++++++++++++++++++++++++
 2 files changed, 44 insertions(+), 0 deletions(-)

diff --git a/docs/formatdomain.html b/docs/formatdomain.html
index 17dc0cd..27e42ac 100644
--- a/docs/formatdomain.html
+++ b/docs/formatdomain.html
@@ -183,6 +183,8 @@
                       </li><li>
                         <a href="#elementsCharUNIX">UNIX domain socket client/server</a>
                       </li></ul>
+                  </li><li>
+                    <a href="#elementsSound">Sound devices</a>
                   </li></ul>
               </li></ul>
           </li><li>
@@ -916,6 +918,24 @@ qemu-kvm -net nic,model=? /dev/null
         <target port="1"/>
       </serial>
       ...</pre>
+        <h4>
+          <a name="elementsSound" id="elementsSound">Sound devices</a>
+        </h4>
+        <p>
+      A virtual sound card can be attached to the host via the
+      <code>sound</code> element. <span class="since">Since 0.4.3</span>
+    </p>
+        <pre>
+      ...
+      <sound model='es1370'/>
+      ...</pre>
+        <dl><dt><code>sound</code></dt><dd>
+        The <code>sound</code> element has one mandatory attribute,
+        <code>model</code>, which specifies what real sound device is emulated.
+        Valid values are specific to the underlying hypervisor, though typical
+        choices are 'es1370', 'sb16', and 'ac97'
+        (<span class="since">'ac97' only since 0.6.0</span>)
+      </dd></dl>
         <h2>
           <a name="examples" id="examples">Example configs</a>
         </h2>
diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index ee32354..4479a6e 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -886,6 +886,30 @@ qemu-kvm -net nic,model=? /dev/null
       </serial>
       ...</pre>
 
+
+    <h4><a name="elementsSound">Sound devices</a></h4>
+
+    <p>
+      A virtual sound card can be attached to the host via the
+      <code>sound</code> element. <span class="since">Since 0.4.3</span>
+    </p>
+
+    <pre>
+      ...
+      <sound model='es1370'/>
+      ...</pre>
+
+    <dl>
+      <dt><code>sound</code></dt>
+      <dd>
+        The <code>sound</code> element has one mandatory attribute,
+        <code>model</code>, which specifies what real sound device is emulated.
+        Valid values are specific to the underlying hypervisor, though typical
+        choices are 'es1370', 'sb16', and 'ac97'
+        (<span class="since">'ac97' only since 0.6.0</span>)
+      </dd>
+    </dl>
+
     <h2><a name="examples">Example configs</a></h2>
 
     <p>
-- 
1.6.2.2