Index: kde/add/kdevelop.xml
===================================================================
--- kde/add/kdevelop.xml	(revision 12fc0f715b3431fe9d3d6226753338b6fe146523)
+++ kde/add/kdevelop.xml	(revision 2c62b69a5cc9aef04b90e494a394e8d81d9f4fee)
@@ -15,9 +15,14 @@
 <sect1 id="kdevelop">
 <sect1info>
-<othername>$LastChangedBy$</othername>
-<date>$Date$</date>
+  <othername>$LastChangedBy$</othername>
+  <date>$Date$</date>
 </sect1info>
+
 <?dbhtml filename="kdevelop.html"?>
 <title><application>kdevelop</application>-&kdevelop-version;</title>
+
+<indexterm zone="kdevelop">
+  <primary sortas="a-kdevelop">kdevelop</primary>
+</indexterm>
 
 <sect2>
@@ -25,31 +30,32 @@
 
 <sect3><title>Package information</title>
-<itemizedlist spacing='compact'>
-<listitem><para>Download (HTTP): <ulink
-url="&kdevelop-download-http;"/></para></listitem>
-<listitem><para>Download (FTP): <ulink
-url="&kdevelop-download-ftp;"/></para></listitem>
-<listitem><para>Download MD5 sum: &kdevelop-md5sum;</para></listitem>
-<listitem><para>Download size: &kdevelop-size;</para></listitem>
-<listitem><para>Estimated disk space required:
-&kdevelop-buildsize;</para></listitem>
-<listitem><para>Estimated build time:
-&kdevelop-time;</para></listitem></itemizedlist>
+  <itemizedlist spacing='compact'>
+    <listitem><para>Download (HTTP): <ulink url="&kdevelop-download-http;"/></para></listitem>
+    <listitem><para>Download (FTP): <ulink url="&kdevelop-download-ftp;"/></para></listitem>
+    <listitem><para>Download MD5 sum: &kdevelop-md5sum;</para></listitem>
+    <listitem><para>Download size: &kdevelop-size;</para></listitem>
+    <listitem><para>Estimated disk space required: &kdevelop-buildsize;</para></listitem>
+    <listitem><para>Estimated build time: &kdevelop-time;</para></listitem>
+  </itemizedlist>
 </sect3>
 
-<sect3><title><application>kdevelop</application> dependencies</title>
+<sect3>
+  <title><application>kdevelop</application> dependencies</title>
+
 <sect4><title>Required</title>
-<para><xref linkend="kdebase"/></para>
+  <para><xref linkend="kdebase"/></para>
 </sect4>
 
 <sect4><title>Recommended</title>
-<para><xref linkend="libjpeg"/> and <xref linkend="libxml2"/></para>
+  <para><xref linkend="libjpeg"/> and <xref linkend="libxml2"/></para>
 </sect4>
 
-<sect4><title>Optional</title>
-<para><xref linkend="python"/>, 
-<ulink url="http://sourceforge.net/projects/docbase/">DocBase</ulink>, 
-<ulink url="http://www.graphviz.org/">GraphViz</ulink> 
-and <xref linkend="doxygen"/></para>
+<sect4>
+  <title>Optional</title>
+  <para><xref linkend="python"/>, 
+        <ulink url="http://sourceforge.net/projects/docbase/">DocBase</ulink>, 
+        <ulink url="http://www.graphviz.org/">GraphViz</ulink>, and 
+        <xref linkend="doxygen"/>
+  </para>
 </sect4>
 </sect3>
@@ -64,14 +70,18 @@
 <screen><userinput><command>./configure --prefix=&kde-dir; --disable-debug \
     --disable-dependency-tracking &amp;&amp;
-make &amp;&amp;
-make install &amp;&amp;
+make</command></userinput></screen>
+
+<note>
+  <para>If you wish to create the <acronym>API</acronym> documentation and
+  you have <application>Doxygen</application> and <application>GraphViz</application> 
+  installed, <command>make apidox</command> must be done before <command>make 
+  install</command>. You'll also need to run <command>make install-apidox</command> 
+  to install the API documentation.</para>
+</note>
+
+<para>Now, as the root user:</para>
+ 
+<screen><userinput role='root'><command>make install &amp;&amp;
 chown -R root:root &kde-dir;/kdevbdb</command></userinput></screen>
-
-<note><para>If you wish to create the <acronym>API</acronym> documentation and
-you have <application>Doxygen</application> and
-<application>GraphViz</application> installed, <command>make apidox</command>
-must be done before <command>make install</command>. You'll also need to run
-<command>make install-apidox</command> to install the API documentation.</para>
-</note>
 
 </sect2>
@@ -80,8 +90,9 @@
 <title>Command explanations</title>
 
-<para><command>chown -R root:root &kde-dir;/kdevbdb</command>: If 
-<application>kdevelop</application> is built by any user other than root, 
-the installed <application>Berkeley-DB</application> files will have incorrect 
-ownership. This command changes the ownership to root:root.</para>
+<para><command>chown -R root:root &kde-dir;/kdevbdb</command>: 
+  If <application>kdevelop</application> is built by any user other than root, 
+  the installed <application>Berkeley-DB</application> files will have incorrect 
+  ownership. This command changes the ownership to root:root.
+</para>
 
 </sect2>
@@ -90,21 +101,29 @@
 <title>Contents</title>
 
-<para>The <application>kdevelop</application> package provides 
-<command>kdevelop-htdig</command>, 
-<command>r++</command>, 
-<command>kdevelop</command>, 
-<command>kdevassistant</command> and 
-<command>kdevdesigner</command>.</para>
+<segmentedlist>
+  <segtitle>Installed Programs</segtitle>
+ 
+  <seglistitem>
+    <seg>kdevelop and supporting programs</seg>
+  </seglistitem>
+</segmentedlist>
+ 
+<variablelist>
+  <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+  <?dbfo list-presentation="list"?>
 
+
+<varlistentry id="kdevelop-prog">
+  <term><command>kdevelop</command></term>
+  <listitem>
+    <para>is an Integrated Development Environment to be used for a wide 
+          variety of programming tasks in many programming languages.</para>
+    <indexterm zone="kdevelop kdevelop-prog">
+      <primary sortas="b-kdevelop">Kdevelop</primary>
+    </indexterm>
+  </listitem>
+</varlistentry>
+
+</variablelist>
 </sect2>
-
-<sect2><title>Description</title>
-
-<sect3><title>kdevelop</title>
-<para><command>kdevelop</command> is an Integrated Development
-Environment to be used for a wide variety of programming
-tasks in many programming languages.</para></sect3>
-
-</sect2>
-
 </sect1>
Index: kde/add/kdewebdev.xml
===================================================================
--- kde/add/kdewebdev.xml	(revision 12fc0f715b3431fe9d3d6226753338b6fe146523)
+++ kde/add/kdewebdev.xml	(revision 2c62b69a5cc9aef04b90e494a394e8d81d9f4fee)
@@ -14,37 +14,47 @@
 
 <sect1 id="kdewebdev">
+
 <sect1info>
-<othername>$LastChangedBy$</othername>
-<date>$Date$</date>
+  <othername>$LastChangedBy$</othername>
+  <date>$Date$</date>
 </sect1info>
+
 <?dbhtml filename="kdewebdev.html"?>
 <title><application>kdewebdev</application>-&kde-version;</title>
+
+<indexterm zone="kdewebdev">
+  <primary sortas="a-kdewebdev">kdewebdev</primary>
+</indexterm>
+
 
 <sect2>
 <title>Introduction to <application>kdewebdev</application></title>
 
-<sect3><title>Package information</title>
-<itemizedlist spacing='compact'>
-<listitem><para>Download (HTTP): <ulink
-url="&kdewebdev-download-http;"/></para></listitem>
-<listitem><para>Download (FTP): <ulink
-url="&kdewebdev-download-ftp;"/></para></listitem>
-<listitem><para>Download MD5 sum: &kdewebdev-md5sum;</para></listitem>
-<listitem><para>Download size: &kdewebdev-size;</para></listitem>
-<listitem><para>Estimated disk space required:
-&kdewebdev-buildsize;</para></listitem>
-<listitem><para>Estimated build time:
-&kdewebdev-time;</para></listitem></itemizedlist>
+<sect3>
+  <title>Package information</title>
+  <itemizedlist spacing='compact'>
+    <listitem><para>Download (HTTP): <ulink url="&kdewebdev-download-http;"/></para></listitem>
+    <listitem><para>Download (FTP): <ulink url="&kdewebdev-download-ftp;"/></para></listitem>
+    <listitem><para>Download MD5 sum: &kdewebdev-md5sum;</para></listitem>
+    <listitem><para>Download size: &kdewebdev-size;</para></listitem>
+    <listitem><para>Estimated disk space required: &kdewebdev-buildsize;</para></listitem>
+    <listitem><para>Estimated build time: &kdewebdev-time;</para></listitem>
+  </itemizedlist>
 </sect3>
 
-<sect3><title><application>kdewebdev</application> dependencies</title>
-<sect4><title>Required</title>
-<para><xref linkend="kdebase"/></para>
+<sect3>
+  <title><application>kdewebdev</application> dependencies</title>
+
+<sect4>
+  <title>Required</title>
+  <para><xref linkend="kdebase"/></para>
 </sect4>
 
-<sect4><title>Recommended</title>
-<para><xref linkend="libjpeg"/>, 
-<xref linkend="libxml2"/> and 
-<xref linkend="libxslt"/></para>
+<sect4>
+  <title>Recommended</title>
+  <para><xref linkend="libjpeg"/>, 
+        <xref linkend="libxml2"/> and 
+        <xref linkend="libxslt"/>
+  </para>
 </sect4>
 </sect3>
@@ -59,6 +69,9 @@
 <screen><userinput><command>./configure --prefix=&kde-dir; --disable-debug \
     --disable-dependency-tracking &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>
@@ -67,23 +80,41 @@
 <title>Contents</title>
 
-<para>Major programs in <application>kdewebdev</application> include
-<command>kxsldbg</command> and <command>quanta</command>.</para>
+<segmentedlist>
+  <segtitle>Installed Programs</segtitle>
+ 
+  <seglistitem>
+    <seg>kxsldbg, quanta</seg>
+  </seglistitem>
+</segmentedlist>
+ 
+<variablelist>
+  <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+  <?dbfo list-presentation="list"?>
 
+<varlistentry id="kxsldbg">
+  <term><command>kxsldbg</command></term>
+  <listitem>
+    <para>is a <acronym>GUI</acronym> front-end to <command>xsldbg</command>, 
+          the <acronym>XSLT</acronym> debugger.</para>
+    <indexterm zone="kdewebdev kxsldbg">
+      <primary sortas="b-kxsldbg">Kxsldbg</primary>
+    </indexterm>
+  </listitem>
+</varlistentry>
+
+<varlistentry id="quanta">
+  <term><command>quanta</command></term>
+  <listitem>
+    <para>is a web development tool that strives to be neutral and transparent 
+          to all markup languages, while supporting popular web-based scripting 
+          languages, <acronym>CSS</acronym>, and other emerging <acronym>W3C</acronym>
+          recommendations.</para>
+    <indexterm zone="kdewebdev quanta">
+      <primary sortas="b-quanta">quanta</primary>
+    </indexterm>
+  </listitem>
+</varlistentry>
+
+</variablelist>   
 </sect2>
-
-<sect2><title>Description</title>
-
-<sect3><title>kxsldbg</title>
-<para><command>kxsldbg</command> is a <acronym>GUI</acronym> front-end to 
-<command>xsldbg</command>, the <acronym>XSLT</acronym> debugger.</para></sect3>
-
-<sect3><title>quanta</title>
-<para><command>quanta</command> is a web development tool that
-strives to be neutral and transparent to all markup languages, while
-supporting popular web-based scripting languages,
-<acronym>CSS</acronym>, and other emerging <acronym>W3C</acronym>
-recommendations.</para></sect3>
-
-</sect2>
-
 </sect1>
