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

8 files changed, 232 insertions, 232 deletions

diff --git a/DOCS/xml/en/audio.xml b/DOCS/xml/en/audio.xml
index 2edc83cff0..5c42a6ca68 100644
--- a/DOCS/xml/en/audio.xml
+++ b/DOCS/xml/en/audio.xml
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<sect1 id="audio">
+<chapter id="audio">
 <title>Audio output devices</title>
-<sect2 id="sync">
+<sect1 id="sync">
 <title>Audio/Video synchronization</title>
 
 <para>
@@ -33,9 +33,9 @@ If you happen to have a bad audio driver, try the <option>-autosync</option>
 option, it should sort out your problems. See the man page for detailed
 information.
 </para>
-</sect2>
+</sect1>
 
-<sect2 id="troubleshooting">
+<sect1 id="troubleshooting">
 <title>Troubleshooting</title>
 
 <para>Some notes:</para>
@@ -53,6 +53,6 @@ DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!<!--
   If the sound clicks when playing from CD-ROM, turn on IRQ unmasking as
   described in the <link linkend="drives">CD-ROM</link> section.
 </para>
-</sect2>
-
 </sect1>
+
+</chapter>
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>
diff --git a/DOCS/xml/en/documentation.xml b/DOCS/xml/en/documentation.xml
index 5bd377c902..4d3b56aac8 100644
--- a/DOCS/xml/en/documentation.xml
+++ b/DOCS/xml/en/documentation.xml
@@ -172,14 +172,20 @@ can be distributed under the terms of the GNU General Public License Version 2.
 </para>
 
 &history.xml;
-&install.xml;
 </chapter>
 
+&install.xml;
 
-&features.xml;
 &usage.xml;
-&faq.xml;
 &cd-dvd.xml;
+&faq.xml;
+
+&formats.xml;
+&codecs.xml;
+&video.xml;
+&audio.xml;
+&tvinput.xml;
+
 &ports.xml;
 &mencoder.xml;
 &encoding-guide.xml;
diff --git a/DOCS/xml/en/features.xml b/DOCS/xml/en/features.xml
deleted file mode 100644
index 7acab002ee..0000000000
--- a/DOCS/xml/en/features.xml
+++ /dev/null
@@ -1,14 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision$ -->
-<chapter id="features">
-<title>Features</title>
-
-&formats.xml;
-&codecs.xml;
-
-&video.xml;
-&audio.xml;
-
-&tvinput.xml;
-
-</chapter>
diff --git a/DOCS/xml/en/formats.xml b/DOCS/xml/en/formats.xml
index f7f888234c..11582ebd58 100644
--- a/DOCS/xml/en/formats.xml
+++ b/DOCS/xml/en/formats.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<sect1 id="formats">
-<title>Supported formats</title>
+<chapter id="containers">
+<title>Containers</title>
 
 <para>
 It is important to clarify a common mistake. When people see a file with a
@@ -30,10 +30,10 @@ Or you might put MPEG-1 video into an AVI file.
 </para>
 
 
-<sect2 id="video-formats">
+<sect1 id="video-formats">
 <title>Video formats</title>
 
-<sect3 id="mpg-vob-dat">
+<sect2 id="mpg-vob-dat">
 <title>MPEG files</title>
 
 <para>
@@ -85,10 +85,10 @@ played at 640x480. AVI files do not have this field, so they have to be
 rescaled during encoding or played with the <option>-aspect</option>
 option.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="avi">
+<sect2 id="avi">
 <title>AVI files</title>
 
 <para>
@@ -167,10 +167,10 @@ that most AVI encoders/multiplexers create bad files when using VBR audio.
 There are only two known exceptions: <application>NanDub</application> and
 <link linkend="mencoder"><application>MEncoder</application></link>.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="asf-wmv">
+<sect2 id="asf-wmv">
 <title>ASF/WMV files</title>
 <para>
 ASF (Active Streaming Format) comes from Microsoft. They developed two
@@ -182,10 +182,10 @@ there is no compatibility at all (it is just another legal game).
 v2.0 files :). Note that ASF files nowadays come with the extension
 <filename>.WMA</filename> or <filename>.WMV</filename>.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="mov">
+<sect2 id="mov">
 <title>QuickTime/MOV files</title>
 
 <para>
@@ -204,10 +204,10 @@ Most new QuickTime files use <emphasis role="bold">Sorenson</emphasis> video and
 QDesign Music audio. See our <link linkend="sorenson">Sorenson</link> codec section.
 </para>
 </note>
-</sect3>
+</sect2>
 
 
-<sect3 id="vivo">
+<sect2 id="vivo">
 <title>VIVO files</title>
 
 <para>
@@ -231,10 +231,10 @@ See the
 <link linkend="vivo-audio">VIVO audio codec</link>
 sections for installation instructions.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="fli">
+<sect2 id="fli">
 <title>FLI files</title>
 <para>
 <emphasis role="bold">FLI</emphasis> is a very old file format used by
@@ -244,10 +244,10 @@ even able to seek within them (useful when looping with the
 <option>-loop</option> option). FLI files do not have keyframes, so the
 picture will be messy for a short time after seeking.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="realmedia">
+<sect2 id="realmedia">
 <title>RealMedia (RM) files</title>
 
 <para>
@@ -257,10 +257,10 @@ Here are the lists of the supported <link
 linkend="realvideo">RealVideo</link> and <link
 linkend="realaudio">RealAudio</link> codecs.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="nuppelvideo">
+<sect2 id="nuppelvideo">
 <title>NuppelVideo files</title>
 <para>
 <ulink url="http://frost.htu.tuwien.ac.at/~roman/nuppelvideo/">NuppelVideo</ulink>
@@ -272,10 +272,10 @@ compressed, and YV12+lzo compressed frames.
 them with <application>MEncoder</application> to MPEG-4 (DivX)/etc!) them all.
 Seeking works.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="yuv4mpeg">
+<sect2 id="yuv4mpeg">
 <title>yuv4mpeg files</title>
 <para>
 <ulink url="http://mjpeg.sf.net">yuv4mpeg / yuv4mpeg2</ulink>
@@ -284,27 +284,27 @@ is a file format used by the
 You can grab, produce, filter or encode video in this format using these tools.
 The file format is really a sequence of uncompressed YUV 4:2:0 images.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="film">
+<sect2 id="film">
 <title>FILM files</title>
 <para>
 This format is used on old Sega Saturn CD-ROM games.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="roq">
+<sect2 id="roq">
 <title>RoQ files</title>
 <para>
 RoQ files are multimedia files used in some ID games such as Quake III and
 Return to Castle Wolfenstein.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="ogg">
+<sect2 id="ogg">
 <title>OGG/OGM files</title>
 <para>
 This is a new fileformat from <ulink url="http://www.xiph.org">Xiphophorus</ulink>.
@@ -313,10 +313,10 @@ It can contain any video or audio codec, CBR or VBR. You'll need
 <systemitem class="library">libvorbis</systemitem> installed before
 compiling <application>MPlayer</application> to be able to play it.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="sdp">
+<sect2 id="sdp">
 <title>SDP files</title>
 <para>
 <ulink url="ftp://ftp.rfc-editor.org/in-notes/rfc2327.txt">SDP</ulink> is an
@@ -324,19 +324,19 @@ IETF standard format for describing video and/or audio RTP streams.
 (The &quot;<ulink url="http://www.live.com/mplayer/">LIVE.COM Streaming Media</ulink>&quot;
 are required.)
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="pva">
+<sect2 id="pva">
 <title>PVA files</title>
 <para>
 PVA is an MPEG-like format used by DVB TV boards' software (e.g.:
 <application>MultiDec</application>, <application>WinTV</application> under Windows).
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="nsv">
+<sect2 id="nsv">
 <title>NSV files</title>
 <para>
 NSV (NullSoft Video) is the file format used by the
@@ -350,29 +350,29 @@ can't be decoded yet. Moreover streams from that site need an extra
 depacketization layer that still has to be implemented (those files are
 unplayable anyway because they use VLB audio).
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="matroska">
+<sect2 id="matroska">
 <title>Matroska files</title>
 <para>
 Matroska is an open container format.
 Read more on the <ulink url="http://www.matroska.org/">official site</ulink>.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="nut">
+<sect2 id="nut">
 <title>NUT files</title>
 <para>
 NUT is the container format developed by <application>MPlayer</application> and
 <application>FFmpeg</application> folks. Both projects support it.
 Read more on the <ulink url="http://www.nut.hu/">official site</ulink>.
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="gif">
+<sect2 id="gif">
 <title>GIF files</title>
 <para>
 The <emphasis role="bold">GIF</emphasis> format is a common format for web
@@ -406,12 +406,12 @@ download a copy from the
 homepage</ulink>. For detailed technical information, have a look at the
 <ulink url="http://www.w3.org/Graphics/GIF/spec-gif89a.txt">GIF89a specification</ulink>.
 </para>
-</sect3>
 </sect2>
+</sect1>
 
 <!-- ********** -->
 
-<sect2 id="audio-formats">
+<sect1 id="audio-formats">
 <title>Audio formats</title>
 
 <para>
@@ -422,7 +422,7 @@ a recommended usage of <application>MPlayer</application>, you better use <ulink
 url="http://www.xmms.org">XMMS</ulink>.
 </para>
 
-<sect3 id="mp3">
+<sect2 id="mp3">
 <title>MP3 files</title>
 <para>
 You may have problems playing certain MP3 files that
@@ -432,35 +432,35 @@ for certain broken MPEG files and thus will remain like this for the
 foreseeable future. The <option>-demuxer</option> flag described in the
 man page may help you in these cases.
 </para>
-</sect3>
+</sect2>
 
-<sect3 id="wav">
+<sect2 id="wav">
 <title>WAV files</title>
 <para>
 </para>
-</sect3>
+</sect2>
 
-<sect3 id="ogg-vorbis">
+<sect2 id="ogg-vorbis">
 <title>OGG/OGM files (Vorbis)</title>
 <para>
 Requires properly installed
 <systemitem class="library">libogg</systemitem> and
 <systemitem class="library">libvorbis</systemitem>.
 </para>
-</sect3>
+</sect2>
 
-<sect3 id="wma-asf">
+<sect2 id="wma-asf">
 <title>WMA/ASF files</title>
 <para>
 </para>
-</sect3>
+</sect2>
 
-<sect3 id="mp4">
+<sect2 id="mp4">
 <title>MP4 files</title>
 <para></para>
-</sect3>
+</sect2>
 
-<sect3 id="cdda">
+<sect2 id="cdda">
 <title>CD audio</title>
 <para>
 <application>MPlayer</application> can use <application>cdparanoia</application>
@@ -472,9 +472,9 @@ to play CDDA (Audio CD). The scope of this section does not contain enumerating
 See the man page's <option>-cdda</option> option which can be used to pass
 options to <application>cdparanoia</application>.
 </para>
-</sect3>
+</sect2>
 
-<sect3 id="xmms">
+<sect2 id="xmms">
 <title>XMMS</title>
 <para>
 <application>MPlayer</application> can use <application>XMMS</application> input
@@ -491,6 +491,7 @@ If that does not work, you might need to set the <application>XMMS</application>
 plugin and library path explicitly by way of the <option>--with-xmmsplugindir</option>
 and <option>--with-xmmslibdir</option> options.
 </para>
-</sect3>
 </sect2>
 </sect1>
+
+</chapter>
diff --git a/DOCS/xml/en/install.xml b/DOCS/xml/en/install.xml
index 1b7e64617d..8b04078b6b 100644
--- a/DOCS/xml/en/install.xml
+++ b/DOCS/xml/en/install.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<sect1 id="install">
+<chapter id="install">
 <title>Installation</title>
 
 <para>
@@ -22,8 +22,7 @@ contain. It will take some time, but it IS worth it.
 You need a fairly recent system. On Linux, 2.4.x kernels are recommended.
 </para>
 
-
-<sect2 id="softreq">
+<sect1 id="softreq">
 <title>Software requirements</title>
 
 <itemizedlist>
@@ -132,10 +131,10 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended.
   <filename>./configure</filename> where that file is.
   </para></listitem>
 </itemizedlist>
-</sect2>
+</sect1>
 
 
-<sect2>
+<sect1 id="installation_codecs">
 <title>Codecs</title>
 
 <itemizedlist>
@@ -258,10 +257,10 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended.
   section for installation instructions and more information.
   </para></listitem>
 </itemizedlist>
-</sect2>
+</sect1>
 
 
-<sect2 id="video-cards">
+<sect1 id="video-cards">
 <title>Video cards</title>
 
 <para>
@@ -271,7 +270,7 @@ the other cards don't.
 </para>
 
 
-<sect3 id="yuv-cards">
+<sect2 id="yuv-cards">
 <title>YUV cards</title>
 
 <para>
@@ -348,10 +347,10 @@ zooming), thus fullscreen is nice and very fast.
   </para></listitem>
 </itemizedlist>
 </para>
-</sect3>
+</sect2>
 
 
-<sect3 id="non-yuv-cards" xreflabel="Non-YUV cards">
+<sect2 id="non-yuv-cards" xreflabel="Non-YUV cards">
 <title>Non-YUV cards</title>
 
 <para>
@@ -377,10 +376,10 @@ it works with the following drivers:
   </simpara></listitem>
 </itemizedlist>
 </para>
-</sect3>
+</sect2>
 
 <!-- FIXME: find a more logical organization for this section -->
-<sect3 id="cirrus-logic-cards" xreflabel="Cirrus-Logic cards">
+<sect2 id="cirrus-logic-cards" xreflabel="Cirrus-Logic cards">
 <title>Cirrus-Logic cards</title>
 <itemizedlist>
 <listitem><para>
@@ -410,11 +409,11 @@ it works with the following drivers:
 </itemizedlist>
 </para></listitem>
 </itemizedlist>
-</sect3>
 </sect2>
+</sect1>
 
 
-<sect2 id="sound-cards">
+<sect1 id="sound-cards">
 <title>Sound cards</title>
 
 <itemizedlist>
@@ -435,10 +434,10 @@ it works with the following drivers:
   to read the <link linkend="audio">sound card</link> section!</emphasis>
   </simpara></listitem>
 </itemizedlist>
-</sect2>
+</sect1>
 
 
-<sect2>
+<sect1 id="features">
 <title>Features</title>
 
 <itemizedlist>
@@ -521,7 +520,6 @@ font file and telling <application>MPlayer</application> to use it.
 See the <link linkend="subosd">Subtitles and OSD</link> section for details.
 </para>
 
-</sect2>
 </sect1>
 
 <!-- ********** -->
@@ -957,3 +955,5 @@ It's a clear way for everyone to become root.
 </para></note>
 </para>
 </sect1>
+
+</chapter>
diff --git a/DOCS/xml/en/tvinput.xml b/DOCS/xml/en/tvinput.xml
index 399f659d99..5586c90f42 100644
--- a/DOCS/xml/en/tvinput.xml
+++ b/DOCS/xml/en/tvinput.xml
@@ -1,5 +1,8 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
+<chapter id="tv">
+<title>TV</title>
+
 <sect1 id="tv-input" xreflabel="TV input">
 <title>TV input</title>
 
@@ -211,3 +214,5 @@ pixel averaging only in the horizontal direction due to a hardware limitation.
 </informalexample>
 </sect2>
 </sect1>
+
+</chapter>
diff --git a/DOCS/xml/en/video.xml b/DOCS/xml/en/video.xml
index a0e5f4a80f..bcaaffffb3 100644
--- a/DOCS/xml/en/video.xml
+++ b/DOCS/xml/en/video.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<sect1 id="video">
+<chapter id="video">
 <title>Video output devices</title>
 
-<sect2 id="mtrr">
+<sect1 id="mtrr">
 <title>Setting up MTRR</title>
 
 <para>
@@ -83,11 +83,11 @@ Not all CPUs have MTRRs. For example older K6-2 (around 266MHz,
 stepping 0) CPUs don't have MTRRs, but stepping 12 does
 (execute <command>cat /proc/cpuinfo</command> to check it).
 </para>
-</sect2>
+</sect1>
 
-<sect2 id="output-trad">
+<sect1 id="output-trad">
 <title>Video outputs for traditional video cards</title>
-<sect3 id="xv">
+<sect2 id="xv">
 <title>Xv</title>
 
 <para>
@@ -161,7 +161,7 @@ screen #0
 </orderedlist>
 </para>
 
-<sect4 id="tdfx">
+<sect3 id="tdfx">
 <title>3dfx cards</title>
 
 <para>
@@ -179,10 +179,10 @@ If you experience strange effects using <option>-vo xv</option>, try SDL
 <option>-vo tdfxfb</option> driver! See the <link linkend="tdfxfb">tdfxfb</link>
 section.
 </para>
-</sect4>
+</sect3>
 
 
-<sect4 id="s3">
+<sect3 id="s3">
 <title>S3 cards</title>
 
 <para>
@@ -198,10 +198,10 @@ driver (slow). If you suspect your card, get a newer driver, or ask politely
 on the MPlayer-users mailing list for an MMX/3DNow! enabled driver.
 </para>
 </note>
-</sect4>
+</sect3>
 
 
-<sect4 id="nvidia">
+<sect3 id="nvidia">
 <title>nVidia cards</title>
 
 <para>
@@ -224,10 +224,10 @@ However, <application>MPlayer</application> contains a
 is in beta stage, and has some drawbacks. For more information, see
 <link linkend="vidix-nvidia">nVidia VIDIX</link> section.
 </para>
-</sect4>
+</sect3>
 
 
-<sect4 id="ati">
+<sect3 id="ati">
 <title>ATI cards</title>
 
 <para>
@@ -245,10 +245,10 @@ happily get <emphasis role="bold">accelerated</emphasis> display, with or withou
 <emphasis role="bold">TV output</emphasis>, and no libraries or X are needed.
 Read the <link linkend="vidix">VIDIX</link> section.
 </para>
-</sect4>
+</sect3>
 
 
-<sect4 id="neomagic">
+<sect3 id="neomagic">
 <title>NeoMagic cards</title>
 
 <para>
@@ -277,10 +277,10 @@ Section "Device"
 EndSection<!--
 --></programlisting>
 </para>
-</sect4>
+</sect3>
 
 
-<sect4 id="trident">
+<sect3 id="trident">
 <title>Trident cards</title>
 <para>
 If you want to use Xv with a Trident card, provided that it doesn't w