Improve overall structure by adding a few top-level chapters so that

sections no longer nest as deeply.  This has the added benefit of
removing a few sections that only consisted of the section title.


git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@17322 b3059339-0415-0410-9bf9-f77b7e298cf2

1 files changed, 54 insertions, 53 deletions

diff --git a/DOCS/xml/en/codecs.xml b/DOCS/xml/en/codecs.xml
index 49b4b553a9..21777c7ec1 100644
--- a/DOCS/xml/en/codecs.xml
+++ b/DOCS/xml/en/codecs.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<sect1 id="codecs">
-<title>Supported codecs</title>
+<chapter id="codecs">
+<title>Codecs</title>
 
-<sect2 id="video-codecs">
+<sect1 id="video-codecs">
 <title>Video codecs</title>
 
 <para>
@@ -76,7 +76,7 @@ and help us add support for it.
 </para>
 
 
-<sect3 id="divx4-5">
+<sect2 id="divx4-5">
 <title>DivX4/DivX5</title>
 
 <para>
@@ -188,10 +188,10 @@ did not install or configure it correctly.
 
 </note>
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="ffmpeg" xreflabel="FFmpeg/libavcodec">
+<sect2 id="ffmpeg" xreflabel="FFmpeg/libavcodec">
 <title>FFmpeg/libavcodec</title>
 
 <para>
@@ -276,10 +276,10 @@ You must follow the steps above to obtain the source for this library.
 With FFmpeg and my Matrox G400, I can view even the highest resolution DivX
 movies without dropped frames on my K6-2 500.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="xanim">
+<sect2 id="xanim">
 <title>XAnim codecs</title>
 
 <note>
@@ -339,10 +339,10 @@ to use them if possible.
 Tested codecs include: <emphasis role="bold">Indeo 3.2, 4.1, 5.0, CVID, 3ivX,
 H.263.</emphasis>
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="vivo-video">
+<sect2 id="vivo-video">
 <title>VIVO video</title>
 <para>
 <application>MPlayer</application> can play Vivo (1.0 and 2.0) videos. The
@@ -352,10 +352,10 @@ Win32 DLL through the <option>-vc vivo</option> option. If you do not supply
 command line options <application>MPlayer</application> selects the best codec
 automatically.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="mpeg12">
+<sect2 id="mpeg12">
 <title>MPEG-1/2 video</title>
 <para>
 MPEG-1 and MPEG-2 are decoded by the multiplatform native <systemitem
@@ -366,10 +366,10 @@ video files by catching <systemitem>Signal 11</systemitem>
 reinitializing the codec, continuing exactly from where the failure
 occurred.  This recovery technique has no measurable speed penalty.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="avicodecs">
+<sect2 id="avicodecs">
 <title>MS Video1, Cinepak CVID, and other older codecs</title>
 <para>
 <application>MPlayer</application> is able to play most of the older codecs
@@ -378,10 +378,10 @@ In the past they were decoded with binary Win32 codecs, but now we have
 <emphasis role="bold">native codecs</emphasis> for most of them using
 <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="realvideo">
+<sect2 id="realvideo">
 <title>RealVideo</title>
 
 <para>
@@ -414,10 +414,10 @@ If you want to store them in a different location, pass the
 <emphasis role="bold">only work with Linux, FreeBSD, NetBSD and Cygwin on the x86,
 Alpha and PowerPC (Linux/Alpha and Linux/PowerPC have been tested) platforms and with Mac OS X</emphasis>.
 </para></note>
-</sect3>
+</sect2>
 
 
-<sect3 id="xvid">
+<sect2 id="xvid">
 <title>XviD</title>
 
 <para>
@@ -478,10 +478,10 @@ then started XviD. So both projects have the same origin.
   <option>--with-xvidincdir=<replaceable>/path/to/</replaceable>xvid.h</option>
   </para></step>
 </procedure>
-</sect3>
+</sect2>
 
 
-<sect3 id="sorenson">
+<sect2 id="sorenson">
 <title>Sorenson</title>
 
 <para>
@@ -517,12 +517,12 @@ decoders:
 <step><para>compile <application>MPlayer</application></para></step>
 </procedure>
 
-</sect3>
+</sect2>
 
-<sect3 id="codec-x264">
+<sect2 id="codec-x264">
 <title>x264</title>
 
-<sect4 id="codec-x264-whatis">
+<sect3 id="codec-x264-whatis">
 <title>What is x264?</title>
 <para>
   <systemitem class="library">x264</systemitem> is a library for
@@ -557,9 +557,9 @@ decoders:
   <listitem><para>Parallel encoding of multiple slices</para></listitem>
 </itemizedlist>
 
-</sect4>
+</sect3>
 
-<sect4 id="codec-h264-whatis">
+<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
@@ -597,9 +597,9 @@ decoders:
   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>
-</sect4>
+</sect3>
 
-<sect4 id="codec-x264-playback">
+<sect3 id="codec-x264-playback">
 <title>How can I play H.264 videos with <application>MPlayer</application>?</title>
 <para>
   <application>MPlayer</application> uses
@@ -619,9 +619,9 @@ decoders:
   H.264 decoding, you might keep an eye on 
   <ulink url="http://mplayerhq.hu/cgi-bin/cvsweb.cgi/ffmpeg/libavcodec/h264.c?cvsroot=FFMpeg">FFmpeg CVS repository's web interface</ulink>.
 </para>
-</sect4>
+</sect3>
 
-<sect4 id="codec-x264-encode">
+<sect3 id="codec-x264-encode">
 <title>How can I encode videos using <application>MEncoder</application> and <systemitem class="library">x264</systemitem>?</title>
 <para>
   If you have the subversion client installed, the latest x264
@@ -657,13 +657,13 @@ decoders:
   The configure script will autodetect that you have satisfied the
   requirements for <systemitem class="library">x264</systemitem>.
 </para>
-</sect4>
 </sect3>
 </sect2>
+</sect1>
 
 <!-- ********** -->
 
-<sect2 id="audio-codecs">
+<sect1 id="audio-codecs">
 <title>Audio codecs</title>
 
 <itemizedlist>
@@ -711,7 +711,7 @@ decoders:
 </itemizedlist>
 
 
-<sect3 id="swac3">
+<sect2 id="swac3">
 <title>Software AC3 decoding</title>
 
 <para>
@@ -747,10 +747,10 @@ SNDCTL_DSP_CHANNELS ioctl.  An example of a suitable driver is emu10k1
 (used by Soundblaster Live! cards) from August 2001 or newer (ALSA CVS is
 also supposed to work).
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="hwac3">
+<sect2 id="hwac3">
 <title>Hardware AC3 decoding</title>
 <para>
 You need an AC3 capable sound card, with digital out (S/PDIF). The card's
@@ -760,10 +760,10 @@ hwac3</option> option. It is experimental but known to work with C-Media
 cards and Soundblaster Live! + ALSA (but not OSS) drivers and DXR3/Hollywood+
 MPEG decoder cards.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="libmad">
+<sect2 id="libmad">
 <title>libmad support</title>
 
 <para>
@@ -778,10 +778,10 @@ sometimes has problems with seeking, but it may perform better on FPU-less
 To enable support, compile with the <option>--enable-mad</option> configure
 option.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="vivo-audio">
+<sect2 id="vivo-audio">
 <title>VIVO audio</title>
 <para>
 The audio codec used in VIVO files depends on whether it is a VIVO/1.0 or
@@ -789,10 +789,10 @@ VIVO/2.0 file. VIVO/1.0 files have <emphasis role="bold">g.723</emphasis> audio,
 and VIVO/2.0 files have <emphasis role="bold">Vivo Siren</emphasis> audio. Both are
 supported.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="realaudio">
+<sect2 id="realaudio">
 <title>RealAudio</title>
 
 <para>
@@ -815,9 +815,9 @@ RealAudio:
 Instructions on how to install the RealPlayer libraries are in the
 <link linkend="realvideo">RealVideo</link> section.
 </para>
-</sect3>
+</sect2>
 
-<sect3 id="qdesign">
+<sect2 id="qdesign">
 <title>QDesign codecs</title>
 <para>
 QDesign audio streams (fourcc:<emphasis>QDMC, QDM2</emphasis>) are found
@@ -825,9 +825,9 @@ in MOV/QT files. Both versions of this codec can be decoded with QuickTime
 libraries. For installation instructions please see the
 <link linkend="sorenson">Sorenson video codec</link> section.
 </para>
-</sect3>
+</sect2>
 
-<sect3 id="qualcomm">
+<sect2 id="qualcomm">
 <title>Qualcomm codecs</title>
 <para>
 Qualcomm audio streams (fourcc:<emphasis>Qclp</emphasis>) is found
@@ -835,9 +835,9 @@ in MOV/QT files. It can be decoded with QuickTime
 libraries. For installation instructions please see the
 <link linkend="sorenson">Sorenson video codec</link> section.
 </para>
-</sect3>
+</sect2>
 
-<sect3 id="aac">
+<sect2 id="aac">
 <title>AAC codec</title>
 <para>
 AAC (Advanced Audio Coding) is an audio codec sometimes found in MOV and MP4
@@ -867,18 +867,18 @@ packages from <ulink url="http://hpisi.nerim.net">Christian Marillat's homepage<
 Mandrake/Mandriva RPMs from the <ulink url="http://plf.zarb.org">P.L.F</ulink> and RedHat RPMs
 from <ulink url="http://greysector.rangers.eu.org/">Grey Sector</ulink>.
 </para>
-</sect3>
-
 </sect2>
 
+</sect1>
+
 <!-- ********** -->
 
-<sect2 id="codec-importing">
+<sect1 id="codec-importing">
 <title>Win32 codecs importing HOWTO</title>
 
 <!-- TODO: a short paragraph of text would be nice here... -->
 
-<sect3 id="vfw-codecs">
+<sect2 id="vfw-codecs">
 <title>VFW codecs</title>
 
 <para>
@@ -917,10 +917,10 @@ ftp://ftp.mplayerhq.hu/MPlayer/incoming/[codecname]/
 e.g. search for &quot;VIDC.HFYU&quot;. To find out how to do this, look at
 the old DirectShow method below.
 </para></note>
-</sect3>
+</sect2>
 
 
-<sect3 id="dshow-codecs">
+<sect2 id="dshow-codecs">
 <title>DirectShow codecs</title>
 
 <para>
@@ -1030,6 +1030,7 @@ If you want to add a codec yourself, read
 <ulink url="http://www.mplayerhq.hu/MPlayer/DOCS/tech/codecs.conf.txt">DOCS/tech/codecs.conf.txt</ulink>.
 </para>
 
-</sect3>
 </sect2>
 </sect1>
+
+</chapter>