[MPlayer-DOCS] Some install.xml suggestions

[Diego Biurrun]

On Mon, Nov 27, 2006 at 11:15:09AM +0100, Torinthiel wrote:
> After the last changes in install.xml, I've reached a few suggestions:
> 
> The periods are used inconsistently, as some non-sentences end in
> period, most don't. See patch
> 
> FreeType description stands out from the croud, as it's formatted
> differently. See patch
> 
> libjpeg is said to be DEcoder, but using it as vo requires an ENcoder
> IMHO
> 
> libpng is similar, but here both en/decoding capability is used.

Just write ", also required for the xx vo" and you'll work around this
ambiguity.

> I'm not sure I like the
> "optional, non-sentence. At least *.* is required." form, as it mixes
> non-sentences and sentences. Not that I have a good alternative.

I'm not very happy either, suggestions welcome.

> --- DOCS/xml/en/install.xml	(revision 21283)
> +++ DOCS/xml/en/install.xml	(working copy)
> @@ -23,7 +23,7 @@
>  <itemizedlist>
>  <listitem><para>
>    <emphasis role="bold">binutils</emphasis> - recommended version is
> -  <emphasis role="bold">2.11.x</emphasis>.
> +  <emphasis role="bold">2.11.x</emphasis>

That's a sentence, it contains a verb.

> @@ -66,7 +66,7 @@
>    - optional, needed for some RTSP/RTP streams
>    </para></listitem>
>  <listitem><para>
> -  <emphasis role="bold">directfb</emphasis> - optional, use 0.9.13 or later.
> +  <emphasis role="bold">directfb</emphasis> - optional, use 0.9.13 or later

That's a sentence, it contains a verb.

Apply the rest.

Diego