[MPlayer-DOCS] [PATCH] document -ac hwmpa

[Guillaume POIRIER]

Hi,

On 1/16/06, Nico Sabbi <nsabbi at email.it> wrote:
> Hi,
> this patch documents how to use -ac hwmpa.
> Since I'm not very familiar with XML and with the structure of docs I'd
> like
> that someone of you would review it.

General note: It's better to keep lines between 70 and 80 characters
per line. That helps diffs readability.

+<sect2 id="hwmpa">
+<title>Hardware MPEG audio codec</title>
+
+<para>
+This codec passes through MPEG audio packets to hardare decoders,
such as the ones

I'd add the name of the codec here, like:

+This codec (selected by) -ac hwmpa) passes through MPEG audio packets
to hardware decoders, such as the ones

+<itemizedlist>
+<title>To enable passthrough on the command line:</title>
+<listitem>
+<para>
+ <option>-ac hwmpa</option>
+</para>
+</listitem>
+</itemizedlist>

I's not really what you wanna write. You should either use just the
<screen> tag:

<para>
Two pass encode of the second track a DVD to an MPEG-4 (&quot;DivX&quot;)
AVI while copying the audio track.
<screen>
mencoder dvd://2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=1 -oac copy -o /dev/null
mencoder dvd://2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=2 -oac copy -o
<replaceable>output.avi</replaceable>
</screen>
</para>


or use the more sophisticated <example> structure.

Example:

<example>
<title>copy audio track</title>
<para>
Two pass encode of the second track a DVD to an MPEG-4 (&quot;DivX&quot;)
AVI while copying the audio track.
<screen>
mencoder dvd://2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=1 -oac copy -o /dev/null
mencoder dvd://2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=2 -oac copy -o
<replaceable>output.avi</replaceable>
</screen>
</para>
</example>


Cheers,
Guillaume
--
Life is pleasant. Death is peaceful. It's the transition that's troublesome.
    Isaac Asimov (1920 - 1992)

MPlayer's doc is offline. Find some fresh one here:
http://tuxrip.free.fr//MPlayer-DOCS-HTML/en/
http://tuxrip.free.fr//MPlayer-DOCS-HTML/fr/