Index: multimedia/videoutils/transcode.xml
===================================================================
--- multimedia/videoutils/transcode.xml	(revision ec2270fc210edc8eaf236dcd5106ea9a9ca28f61)
+++ multimedia/videoutils/transcode.xml	(revision adcfe66f47e7189cf9d84f32e448d7f56be48a91)
@@ -12,5 +12,5 @@
 ]>
 
-<sect1 id="transcode" xreflabel="Transcode-&transcode-version;">
+<sect1 id="transcode-package" xreflabel="Transcode-&transcode-version;">
 <sect1info>
 <othername>$LastChangedBy$</othername>
@@ -19,4 +19,6 @@
 <?dbhtml filename="transcode.html"?>
 <title><application>Transcode</application>-&transcode-version;</title>
+<indexterm zone="transcode-package">
+<primary sortas="a-Transcode">Transcode</primary></indexterm>
 
 <sect2>
@@ -24,8 +26,7 @@
 
 <para><application>Transcode</application> is a fast, versatile and 
-command-line based audio/video everything to everything 
-converter. For a rundown of the features and capabilities, along with 
-usage examples, visit the Transcode Wiki at 
-<ulink url="http://www.transcoding.org/"/>.</para>
+command-line based audio/video everything to everything converter. For a 
+rundown of the features and capabilities, along with usage examples, visit 
+the Transcode Wiki at <ulink url="http://www.transcoding.org/"/>.</para>
 
 <sect3><title>Package information</title>
@@ -111,6 +112,9 @@
 
 <screen><userinput><command>./configure --prefix=/usr --without-x &amp;&amp;
-make &amp;&amp;
-make install</command></userinput></screen>
+make</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
 
 </sect2>
@@ -137,126 +141,219 @@
 <title>Contents</title>
 
-<para>The <application>Transcode</application> package contains 
-<command>transcode</command>,
-<command>tccat</command>, 
-<command>tcdecode</command>,
-<command>tcdemux</command>, 
-<command>tcextract</command>,
-<command>tcframe</command>, 
-<command>tcmodinfo</command>,
-<command>tcmp3cut</command>,
-<command>tcmplex</command>,
-<command>tcprobe</command>,
-<command>tcrequant</command>,
-<command>tcscan</command>, 
-<command>tcxmlcheck</command>,
-<command>tcxpm2rgb</command>,
-<command>avicodec</command>,
-<command>avidump</command>, 
-<command>avifix</command>,
-<command>aviindex</command>,
-<command>avimerge</command>,
-<command>avisplit</command>, 
-<command>avisync</command>
-and input/filter/output modules.</para>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directories</segtitle>
+<seglistitem>
+<seg>avicodec, avidump, avifix, aviindex, avimerge, avisplit, avisync, tccat, 
+tcdecode, tcdemux, tcextract, tcframe, tcmodinfo, tcmp3cut, tcmplex, tcprobe, 
+tcrequant, tcscan, tcxmlcheck, tcxpm2rgb and transcode</seg>
+<seg>a52_decore.so, af6_decore.so, export*.so, filter*.so and import*.so 
+output/filter/input modules</seg>
+<seg>/usr/lib/transcode and /usr/share/doc/transcode</seg>
+</seglistitem>
+</segmentedlist>
+
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="avicodec">
+<term><command>avicodec</command></term>
+<listitem><para>indicates or changes the <acronym>FOURCC</acronym> 
+<acronym>CODEC</acronym> flag in an <acronym>AVI</acronym> file.</para>
+<indexterm zone="transcode-package avicodec">
+<primary sortas="b-avicodec">avicodec</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="avidump">
+<term><command>avidump</command></term>
+<listitem><para>dumps audio or video stream of a given <acronym>AVI</acronym> 
+file to stdout (for <acronym>AVI</acronym> conversion or extraction of audio 
+streams).</para>
+<indexterm zone="transcode-package avidump">
+<primary sortas="b-avidump">avidump</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="avifix">
+<term><command>avifix</command></term>
+<listitem><para>fixes the header of an <acronym>AVI</acronym> file.</para>
+<indexterm zone="transcode-package avifix">
+<primary sortas="b-avifix">avifix</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="aviindex">
+<term><command>aviindex</command></term>
+<listitem><para>writes a text file describing the index of an 
+<acronym>AVI</acronym> file.</para>
+<indexterm zone="transcode-package aviindex">
+<primary sortas="b-aviindex">aviindex</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="avimerge">
+<term><command>avimerge</command></term>
+<listitem><para> merges <acronym>AVI</acronym> files of the same format. Do 
+not try to merge <acronym>AVI</acronym> files of different formats, it will 
+most likely result in errors (and format means same bitrates, too!).</para>
+<indexterm zone="transcode-package avimerge">
+<primary sortas="b-avimerge">avimerge</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="avisplit">
+<term><command>avisplit</command></term>
+<listitem><para>splits <acronym>AVI</acronym> files into multiple files.</para>
+<indexterm zone="transcode-package avisplit">
+<primary sortas="b-avisplit">avisplit</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="avisync">
+<term><command>avisync</command></term>
+<listitem><para>can shift audio in <acronym>AVI</acronym> files for better 
+synchronizing of the audio and video data signal.</para>
+<indexterm zone="transcode-package avisync">
+<primary sortas="b-avisync">avisync</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tccat">
+<term><command>tccat</command></term>
+<listitem><para>concatenates input files using the input plugins of 
+<application>Transcode</application>.</para>
+<indexterm zone="transcode-package tccat">
+<primary sortas="b-tccat">tccat</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tcdecode">
+<term><command>tcdecode</command></term>
+<listitem><para>is used to decode input files to raw video and 
+<acronym>PCM</acronym> audio streams.</para>
+<indexterm zone="transcode-package tcdecode">
+<primary sortas="b-tcdecode">tcdecode</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tcdemux">
+<term><command>tcdemux</command></term>
+<listitem><para>demultiplexes (separates) audio/video input that contains 
+multiple streams, e.g., <acronym>VOB</acronym> files.</para>
+<indexterm zone="transcode-package tcdemux">
+<primary sortas="b-tcdemux">tcdemux</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tcextract">
+<term><command>tcextract</command></term>
+<listitem><para>grabs single streams from a file containing multiple 
+streams.</para>
+<indexterm zone="transcode-package tcextract">
+<primary sortas="b-tcextract">tcextract</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tcframe">
+<term><command>tcframe</command></term>
+<listitem><para>processes single video frames for different color encodings 
+(<acronym>RGB</acronym> &gt;-&lt; <acronym>YUV</acronym> or similar).</para>
+<indexterm zone="transcode-package tcframe">
+<primary sortas="b-tcframe">tcframe</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tcmodinfo">
+<term><command>tcmodinfo</command></term>
+<listitem><para>loads a supplied <application>Transcode</application> filter 
+module and prints its parameters.</para>
+<indexterm zone="transcode-package tcmodinfo">
+<primary sortas="b-tcmodinfo">tcmodinfo</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tcmp3cut">
+<term><command>tcmp3cut</command></term>
+<listitem><para>is a tool which can cut <acronym>MP3</acronym> streams at 
+milliseconds positions.</para>
+<indexterm zone="transcode-package tcmp3cut">
+<primary sortas="b-tcmp3cut">tcmp3cut</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tcprobe">
+<term><command>tcprobe</command></term>
+<listitem><para>prints information about the input file format.</para>
+<indexterm zone="transcode-package tcprobe">
+<primary sortas="b-tcprobe">tcprobe</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tcrequant">
+<term><command>tcrequant</command></term>
+<listitem><para>is a tool which can requantize an <acronym>MPEG</acronym>-2 
+elementary stream.</para>
+<indexterm zone="transcode-package tcrequant">
+<primary sortas="b-tcrequant">tcrequant</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tcscan">
+<term><command>tcscan</command></term>
+<listitem><para> performs several measurements on the given input data.</para>
+<indexterm zone="transcode-package tcscan">
+<primary sortas="b-tcscan">tcscan</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tcxmlcheck">
+<term><command>tcxmlcheck</command></term>
+<listitem><para> checks information in a <acronym>SMIL</acronym> input 
+file.</para>
+<indexterm zone="transcode-package tcxmlcheck">
+<primary sortas="b-tcxmlcheck">tcxmlcheck</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="transcode">
+<term><command>transcode</command></term>
+<listitem><para>is the encoder's user interface that handles the plugins and 
+other programs, being the glue between the modules. There are several well 
+documented usage examples on both the homepage and the documentation included 
+in the package.</para>
+<indexterm zone="transcode-package transcode">
+<primary sortas="b-transcode">transcode</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><filename class='libraryfile'>a52_decore.so</filename></term>
+<listitem><para>is used to interface with the 
+<filename class='libraryfile'>liba52</filename> library for decoding 
+<acronym>AC</acronym>-3 streams.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><filename class='libraryfile'>af6_decore.so</filename></term>
+<listitem><para>is a support module used to decode 
+<filename class='libraryfile'>libaviplay</filename> library supported codecs 
+and file formats</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><filename class='libraryfile'>export/filter/import_*.so</filename></term>
+<listitem><para>&mdash; depending on the external libraries that are used, 
+there are a great number of plugins to convert audio and video input to raw 
+format, process raw video and audio and convert raw audio and video to other
+formats to be written into a file type of choice. Read the documentation for 
+complete information.</para></listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
 
-<sect2><title>Description</title>
-
-<sect3><title>transcode</title>
-<para><command>transcode</command> is the encoder's user interface that handles
-the plugins and other programs, being the glue between the modules.
-There are several well documented usage examples on both the homepage
-and the documentation included in the package.</para></sect3>
-
-<sect3><title>tccat</title>
-<para><command>tccat</command> concatenates input files using the input plugins
-of <application>Transcode</application>.</para></sect3>
-
-<sect3><title>tcdecode</title>
-<para><command>tcdecode</command> is used to decode input files to
-raw video and <acronym>PCM</acronym> audio stream.</para></sect3>
-
-<sect3><title>tcdemux</title>
-<para><command>tcdemux</command> demultiplexes (separates) audio/video input 
-that contains multiple streams, e.g., <acronym>VOB</acronym> files.</para>
-</sect3>
-
-<sect3><title>tcextract</title>
-<para><command>tcextract</command> grabs single streams from a file containing 
-multiple streams.</para></sect3>
-
-<sect3><title>tcframe</title>
-<para><command>tcframe</command> processes single video frames for different 
-color encodings (<acronym>RGB</acronym> &gt;-&lt; <acronym>YUV</acronym> or 
-similar).</para></sect3>
-
-<sect3><title>tcmodinfo</title>
-<para><command>tcmodinfo</command> loads a supplied
-<application>Transcode</application> filter module and prints its
-parameters.</para></sect3>
-
-<sect3><title>tcmp3cut</title>
-<para><command>tcmp3cut</command> is a tool which can cut
-<acronym>MP3</acronym> streams at milliseconds positions.</para></sect3>
-
-<sect3><title>tcprobe</title>
-<para><command>tcprobe</command> prints information about the input file 
-format.</para></sect3>
-
-<sect3><title>tcrequant</title>
-<para><command>tcrequant</command> is a tool which can requantize an
-<acronym>MPEG</acronym>-2 elementary stream.</para></sect3> 
-
-<sect3><title>tcscan</title>
-<para><command>tcscan</command> performs several measurements on the given 
-input data.</para></sect3>
-
-<sect3><title>tcxmlcheck</title>
-<para><command>tcxmlcheck</command> checks information in a
-<acronym>SMIL</acronym> input file.</para></sect3>
-
-<sect3><title>avicodec</title>
-<para><command>avicodec</command> indicates or changes
-<acronym>FOURCC</acronym> <acronym>CODEC</acronym> flag in an
-<acronym>AVI</acronym> file.</para></sect3>
-
-<sect3><title>avidump</title>
-<para><command>avidump</command> dumps audio or video stream of a given 
-<acronym>AVI</acronym> file to stdout (for <acronym>AVI</acronym>
-conversion or extraction of audio streams).</para></sect3>
-
-<sect3><title>avifix</title>
-<para><command>avifix</command> fixes the header of an
-<acronym>AVI</acronym> file.</para></sect3>
-
-<sect3><title>aviindex</title>
-<para><command>aviindex</command> writes a text file describing the
-index of an <acronym>AVI</acronym> file.</para></sect3>
-
-<sect3><title>avimerge</title>
-<para><command>avimerge</command> merges <acronym>AVI</acronym> files of the 
-same format. Do not try to merge <acronym>AVI</acronym> files of different 
-formats, it will most likely result in errors (and format means same bitrates, 
-too!).</para></sect3>
-
-<sect3><title>avisplit</title>
-<para><command>avisplit</command> splits <acronym>AVI</acronym> files
-into multiple files.</para></sect3>
-
-<sect3><title>avisync</title>
-<para><command>avisync</command> can shift audio in
-<acronym>AVI</acronym> files for better synchronizing of audio and video
-data signal.</para></sect3>
-
-<sect3><title>input/filter/output modules</title>
-<para>Depending on the external libraries that are used, there are a
-great number of plugins to convert audio and video input to raw format,
-process raw video and audio and convert raw audio and video to other
-formats to be written into a file type of choice. Read the
-documentation.</para></sect3>
-
-</sect2>
-
 </sect1>
