From 8e106460abc80cdce12753eb08d72eee758f9ef8 Mon Sep 17 00:00:00 2001
From: nicodvb <nicodvb@b3059339-0415-0410-9bf9-f77b7e298cf2>
Date: Thu, 19 Jan 2006 22:41:15 +0000
Subject: [PATCH] documented audio codec hwmpa

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@17433 b3059339-0415-0410-9bf9-f77b7e298cf2
---
 DOCS/xml/en/codecs.xml | 13 +++++++++++++
 DOCS/xml/en/usage.xml  | 17 +++++++++++++++++
 2 files changed, 30 insertions(+)

diff --git a/DOCS/xml/en/codecs.xml b/DOCS/xml/en/codecs.xml
index 21777c7ec1..3d8eb350a1 100644
--- a/DOCS/xml/en/codecs.xml
+++ b/DOCS/xml/en/codecs.xml
@@ -780,6 +780,19 @@ option.
 </para>
 </sect2>
 
+<sect2 id="hwmpa">
+<title>Hardware MPEG audio codec</title>
+
+<para>
+This codec (selected by -ac hwmpa) passes through MPEG audio packets 
+to hardware decoders, such as the ones found in full-featured DVB cards 
+and DXR2 adapters.
+Don't use it in combination with any other audio output device
+(such as OSS and ALSA) that isn't able to decode it (you will hear
+only white noise).
+</para>
+</sect2>
+
 
 <sect2 id="vivo-audio">
 <title>VIVO audio</title>
diff --git a/DOCS/xml/en/usage.xml b/DOCS/xml/en/usage.xml
index 6f2d129b52..edaccfd9c6 100644
--- a/DOCS/xml/en/usage.xml
+++ b/DOCS/xml/en/usage.xml
@@ -504,6 +504,23 @@ when an audio family is specified.
 
 </sect3>
 
+<sect3 id="hwmpa-surround-passthrough">
+<title>MPEG audio Passthrough</title>
+
+<para>
+Digital TV transmissions (such as DVB and ATSC) and some DVDs usually have 
+MPEG audio streams (in particular MP2).
+Some MPEG hardware decoders such as full-featured DVB cards and DXR2 
+adapters can natively decode this format. 
+<application>MPlayer</application> can be configured to relay the audio data 
+without decoding it.
+</para>
+
+<para>
+To use this codec:
+<screen> mplayer -ac hwmpa </screen>
+</para>
+</sect3>
 
 <sect3 id="advaudio-surround-matrix">
 <title>Matrix-encoded audio</title>