[MPlayer-DOCS] [PATCH] Fix outdated "Encoding to MPEG format" section in xml docs

[Jeff Clagg]

See http://mplayerhq.hu/DOCS/HTML/en/menc-feat-mpeg.html

> MEncoder can create MPEG (MPEG-PS) format output files. It is probably
> useful only with libavcodec's mpeg1video codec, because players - except
> MPlayer - expect MPEG-1 video, and MPEG-1 layer 2 (MP2) audio streams in
> MPEG files.

This isn't really even true, btw - it all depends on the application.

> This feature is not very useful right now, aside that it probably has
> many bugs,

Maybe it's reached the point where we can stop saying this.

> but the more importantly because MEncoder currently cannot
> encode MPEG-1 layer 2 (MP2) audio, which all other players expect in
> MPEG files.

Outdated, wrong, and confusing to the people who are nice enough to
check the xml docs. Today I saw someone on #mplayer who read this and
believed it.

> To change MEncoder's output file format, use the -of mpeg option.
>
> Example:
>
> mencoder -of mpeg -ovc lavc -lavcopts vcodec=mpeg1video -oac copy
> other_options media.avi -o output.mpg

Maybe not the world's best example, but not really wrong either. I left
this alone.
-------------- next part --------------
Index: DOCS/xml/en/mencoder.xml
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/xml/en/mencoder.xml,v
retrieving revision 1.86
diff -u -r1.86 mencoder.xml
--- DOCS/xml/en/mencoder.xml	24 Jul 2005 14:22:14 -0000	1.86
+++ DOCS/xml/en/mencoder.xml	31 Jul 2005 17:29:36 -0000
@@ -57,17 +57,12 @@
 <title>Encoding to MPEG format</title>
 <para>
 <application>MEncoder</application> can create MPEG (MPEG-PS) format output
-files. It is probably useful only with
-<link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>'s
-<emphasis>mpeg1video</emphasis> codec, because players - except
-<application>MPlayer</application> - expect MPEG-1 video, and MPEG-1 layer 2 (MP2)
-audio streams in MPEG files.
-</para>
-
-<para>
-This feature is not very useful right now, aside that it probably has many bugs,
-but the more importantly because <application>MEncoder</application> currently
-cannot encode MPEG-1 layer 2 (MP2) audio, which all other players expect in MPEG files.
+files.
+Usually, when you are using MPEG-1 or MPEG-2 video, it is because you are
+encoding for a constrained format such as SVCD, VCD, or DVD.
+The specific requirements for these formats are explained in the
+<link linkend="menc-feat-vcd-dvd"> VCD and DVD creation guide</link>
+section.
 </para>
 
 <para>