# HG changeset patch
# User diego
# Date 1224023332 0
# Node ID c59e6672574eaf4a6487b1d1bf1c82a83da20cad
# Parent  c89a913b5d5e8fbf8f60e092b0a71846abe8ff68
Remove some pointless and/or outdated codec documentation sections.

diff -r c89a913b5d5e -r c59e6672574e DOCS/xml/en/codecs.xml
--- a/DOCS/xml/en/codecs.xml	Tue Oct 14 22:28:19 2008 +0000
+++ b/DOCS/xml/en/codecs.xml	Tue Oct 14 22:28:52 2008 +0000
@@ -15,64 +15,6 @@
 </para>
 
 <para>
-The most important ones above all:
-</para>
-
-<itemizedlist>
-<listitem><para>
-  <emphasis role="bold">MPEG-1</emphasis> (<emphasis role="bold">VCD</emphasis>) and
-  <emphasis role="bold">MPEG-2</emphasis> (<emphasis role="bold">DVD</emphasis>) video
-</para></listitem>
-<listitem><para>
-  native decoders for <emphasis role="bold">all DivX variants,
-  3ivX, Microsoft MPEG-4</emphasis> v1, v2 and other MPEG-4 variants
-</para></listitem>
-<listitem><para>
-  native decoder for <emphasis role="bold">Windows Media Video 7/8</emphasis>
-  (<emphasis role="bold">WMV1/WMV2</emphasis>), and Win32 DLL decoder
-  for <emphasis role="bold">Windows Media Video 9</emphasis>
-  (<emphasis role="bold">WMV3</emphasis>),
-  both used in <filename>.wmv</filename> files
-</para></listitem>
-<listitem><para>
-  native <emphasis role="bold">Sorenson 1 (SVQ1)</emphasis> decoder
-</para></listitem>
-<listitem><para>
-  native <emphasis role="bold">Sorenson 3 (SVQ3)</emphasis> decoder
-</para></listitem>
-<listitem><para>
-  <emphasis role="bold">3ivx</emphasis> v1, v2 decoder
-</para></listitem>
-<listitem><para>
-  Cinepak and <emphasis role="bold">Intel Indeo</emphasis> codecs
-  (3.1,3.2,4.1,5.0)
-</para></listitem>
-<listitem><para>
-  <emphasis role="bold">MJPEG</emphasis>, AVID, VCR2, ASV2 and other hardware
-  formats
-</para></listitem>
-<listitem><para>
-  VIVO 1.0, 2.0, I263 and other <emphasis role="bold">H.263(+)</emphasis>
-  variants
-</para></listitem>
-<listitem><para>
-  FLI/FLC
-</para></listitem>
-<listitem><para>
-  <emphasis role="bold">RealVideo 1.0 &amp; 2.0</emphasis> from
-  <systemitem class="library">libavcodec</systemitem>, and
-  <emphasis role="bold">RealVideo 3.0 &amp; 4.0</emphasis> codecs using
-  RealPlayer libraries
-</para></listitem>
-<listitem><para>
-  native decoder for HuffYUV
-</para></listitem>
-<listitem><para>
-  Various old simple RLE-like formats
-</para></listitem>
-</itemizedlist>
-
-<para>
 If you have a Win32 codec not listed here which is not supported yet,
 please read the <link linkend="codec-importing">codec importing HOWTO</link>
 and help us add support for it.
@@ -196,103 +138,6 @@
 which have nothing to do with video quality per se; many of these
 are not yet implemented in <systemitem class="library">x264</systemitem>.
 </para>
-
-<itemizedlist>
-<title>Encoder features</title>
-  <listitem><para>CAVLC/CABAC</para></listitem>
-  <listitem><para>Multi-references</para></listitem>
-  <listitem><para>
-  Intra: all macroblock types (16x16, 8x8, and 4x4 with all predictions)
-  </para></listitem>
-  <listitem><para>
-  Inter P: all partitions (from 16x16 down to 4x4)
-  </para></listitem>
-  <listitem><para>
-  Inter B: partitions from 16x16 down to 8x8 (including SKIP/DIRECT)
-  </para></listitem>
-  <listitem><para>
-  Ratecontrol: constant quantizer, constant bitrate, single or multipass ABR,
-  optional VBV
-  </para></listitem>
-  <listitem><para>Scene cut detection</para></listitem>
-  <listitem><para>Adaptive B-frame placement</para></listitem>
-  <listitem><para>
-  B-frames as references / arbitrary frame order
-  </para></listitem>
-  <listitem><para>8x8 and 4x4 adaptive spatial transform</para></listitem>
-  <listitem><para>Lossless mode</para></listitem>
-  <listitem><para>Custom quantization matrices</para></listitem>
-  <listitem><para>Parallel encoding of multiple slices</para></listitem>
-  <listitem><para>Interlacing</para></listitem>
-</itemizedlist>
-</sect3>
-
-
-<sect3 id="codec-h264-whatis">
-<title>What is H.264?</title>
-
-<para>
-H.264 is one name for a new digital video codec jointly developed
-by the ITU and MPEG.
-It can also be correctly referred to by the cumbersome names of
-"ISO/IEC 14496-10" or "MPEG-4 Part 10".
-More frequently, it is referred to as "MPEG-4 AVC" or just "AVC".
-</para>
-
-<para>
-Whatever you call it, H.264 may be worth trying because it can typically match
-the quality of MPEG-4 ASP with 5%-30% less bitrate.
-Actual results will depend on both the source material and the encoder.
-The gains from using H.264 do not come for free: Decoding H.264
-streams seems to have steep CPU and memory requirements.
-For instance, on a 1733 MHz Athlon, a DVD-resolution 1500kbps H.264
-video requires around 35% CPU to decode.
-By comparison, decoding a DVD-resolution 1500kbps MPEG-4 ASP stream
-requires around 10% CPU.
-This means that decoding high-definition streams is almost out of
-the question for most users.
-It also means that even a decent DVD rip may sometimes stutter on
-processors slower than 2.0 GHz or so.
-</para>
-
-<para>
-At least with <systemitem class="library">x264</systemitem>,
-encoding requirements are not much worse than what you are used to
-with MPEG-4 ASP.
-For instance, on a 1733 MHz Athlon a typical DVD encode would run
-at 5-15fps.
-</para>
-
-<para>
-This document is not intended to explain the details of H.264,
-but if you are interested in a brief overview, you may want to read
-<ulink url="http://www.cdt.luth.se/~peppar/kurs/smd151/spie04-h264OverviewPaper.pdf">The H.264/AVC Advanced Video Coding Standard: Overview and Introduction to the Fidelity Range Extensions</ulink>.
-</para>
-</sect3>
-
-
-<sect3 id="codec-x264-playback">
-<title>How can I play H.264 videos with
-  <application>MPlayer</application>?</title>
-  
-<para>
-<application>MPlayer</application> uses
-<systemitem class="library">libavcodec</systemitem>'s H.264 decoder.
-<systemitem class="library">libavcodec</systemitem> has had at
-least minimally usable H.264 decoding since around July 2004,
-however major changes and improvements have been implemented since
-that time, both in terms of more functionality supported and in
-terms of improved CPU usage.
-Just to be certain, it is always a good idea to use a recent Subversion
-checkout.
-</para>
-
-<para>
-If you want a quick and easy way to know whether there have been
-recent changes to <systemitem class="library">libavcodec</systemitem>'s
-H.264 decoding, you might keep an eye on 
-<ulink url="http://svn.mplayerhq.hu/ffmpeg/trunk/libavcodec/h264.c?view=log">FFmpeg Subversion repository's web interface</ulink>.
-</para>
 </sect3>
 
 
@@ -342,55 +187,6 @@
 <sect1 id="audio-codecs">
 <title>Audio codecs</title>
 
-<itemizedlist>
-<title>The most important audio codecs above all:</title>
-<listitem><para>
-  MPEG layer 1/2/3 (MP1/2/3) audio (<emphasis role="bold">native</emphasis>
-  code, with MMX/SSE/3DNow! optimization)
-</para></listitem>
-<listitem><para>
-  Windows Media Audio 7 and 8 (AKA WMAv1 and WMAv2)
-  (<emphasis role="bold">native</emphasis> code, with
-  <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>)
-</para></listitem>
-<listitem><para>
-  Windows Media Audio 9 (WMAv3) (using DMO DLL)
-</para></listitem>
-<listitem><para>
-  AC-3 Dolby audio (<emphasis role="bold">native</emphasis> code, with
-  MMX/SSE/3DNow! optimization)
-</para></listitem>
-<listitem><para>
-  AC-3 passing through sound card hardware
-</para></listitem>
-<listitem><para>
-  AAC
-</para></listitem>
-<listitem><para>
-  Ogg Vorbis audio codec (<emphasis role="bold">native</emphasis> library)
-</para></listitem>
-<listitem><para>
-  RealAudio: DNET (low bitrate AC-3), Cook, Sipro and ATRAC3
-</para></listitem>
-<listitem><para>
-  QuickTime: Qualcomm and QDesign audio codecs
-</para></listitem>
-<listitem><para>
-  VIVO audio (g723, Vivo Siren)
-</para></listitem>
-<listitem><para>
-  Voxware audio (using DirectShow DLL)
-</para></listitem>
-<listitem><para>
-  alaw and ulaw, various GSM, ADPCM and PCM formats and other simple old
-  audio codecs
-</para></listitem>
-<listitem><para>
-  Adaptive Multi-Rate (AMR) speech codecs
-</para></listitem>
-</itemizedlist>
-
-<!-- ********** -->
 
 <sect2 id="swac3">
 <title>Software AC-3 decoding</title>