Index: postlfs/shells/tcsh.xml
===================================================================
--- postlfs/shells/tcsh.xml	(revision ee0047b434c47f2fbcc7a81e830cc7a4b5099fe0)
+++ postlfs/shells/tcsh.xml	(revision eab549f25de6231b82ad34ff3cb7a40a7402bdb3)
@@ -14,134 +14,167 @@
 
 <sect1 id="tcsh" xreflabel="Tcsh-&tcsh-version;">
-<sect1info>
-<othername>$LastChangedBy$</othername>
-<date>$Date$</date>
-</sect1info>
-<?dbhtml filename="tcsh.html"?>
-<title>Tcsh-&tcsh-version;</title>
-<indexterm zone="tcsh">
-<primary sortas="a-Tcsh">Tcsh</primary></indexterm>
+  <?dbhtml filename="tcsh.html"?>
 
-<sect2>
-<title>Introduction to <application>Tcsh</application></title>
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
 
-<para>The <application>Tcsh</application> package contains "an enhanced but 
-completely compatible version of the Berkeley Unix C shell (csh)". This is 
-useful as an alternative shell for those who prefer C syntax to that of the 
-bash shell, and also because some programs require the C shell in order to
-install.</para>
+  <title>Tcsh-&tcsh-version;</title>
 
-<sect3><title>Package information</title>
-<itemizedlist spacing='compact'>
-<listitem><para>Download (HTTP): <ulink
-url="&tcsh-download-http;"/></para></listitem>
-<listitem><para>Download (FTP): <ulink
-url="&tcsh-download-ftp;"/></para></listitem>
-<listitem><para>Download MD5 sum: &tcsh-md5sum;</para></listitem>
-<listitem><para>Download size: &tcsh-size;</para></listitem>
-<listitem><para>Estimated disk space required:
-&tcsh-buildsize;</para></listitem>
-<listitem><para>Estimated build time:
-&tcsh-time;</para></listitem></itemizedlist>
-</sect3>
+  <indexterm zone="tcsh">
+    <primary sortas="a-Tcsh">Tcsh</primary>
+  </indexterm>
 
-</sect2>
+  <sect2 role="package">
+    <title>Introduction to Tcsh</title>
 
-<sect2>
-<title>Installation of <application>Tcsh</application></title>
+    <para>The <application>Tcsh</application> package contains "an enhanced but
+    completely compatible version of the Berkeley Unix C shell (csh)". This is
+    useful as an alternative shell for those who prefer C syntax to that of the
+    bash shell, and also because some programs require the C shell in order to
+    install.</para>
 
-<para>Install <application>Tcsh</application> by running the following 
-commands:</para>
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&tcsh-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&tcsh-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &tcsh-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &tcsh-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &tcsh-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &tcsh-time;</para>
+      </listitem>
+    </itemizedlist>
 
-<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
-make</command></userinput></screen>
+  </sect2>
 
-<para>Now, as the root user:</para>
+  <sect2 role="installation">
+    <title>Installation of Tcsh</title>
 
-<screen><userinput role='root'><command>make install &amp;&amp;
+    <para>Install <application>Tcsh</application> by running the following
+    commands:</para>
+
+<screen><userinput>./configure --prefix=/usr &amp;&amp;
+make</userinput></screen>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install &amp;&amp;
 make install.man &amp;&amp;
-ln -sf /usr/bin/tcsh /bin/csh</command></userinput></screen>
+ln -v -sf /usr/bin/tcsh /bin/csh</userinput></screen>
 
-</sect2>
+  </sect2>
 
-<sect2>
-<title>Command explanations</title>
+  <sect2 role="commands">
+    <title>Command Explanations</title>
 
-<para><command>ln -sf /usr/bin/tcsh /bin/csh</command>: The
-<acronym>FHS</acronym> states that if there is a <application>C</application> 
-shell installed, there should be a symlink from
-<filename>/bin/csh</filename> to it.  This creates that symlink.</para>
+    <para><command>ln -v -sf /usr/bin/tcsh /bin/csh</command>: The
+    FHS states that if there is a <application>C</application> shell
+    installed, there should be a symlink from <filename>/bin/csh</filename>
+    to it. This creates that symlink.</para>
 
-</sect2>
+  </sect2>
 
-<sect2>
-<title>Configuring <application>Tcsh</application></title>
+  <sect2 role="configuration">
+    <title>Configuring Tcsh</title>
 
-<sect3 id="tcsh-config"><title>Config files</title>
-<para>There are numerous configuration files for the C shell. Examples 
-of these are <filename>/etc/csh.cshrc</filename>, 
-<filename>/etc/csh.login</filename>, 
-<filename>/etc/csh.logout</filename>, 
-<filename>~/.tcshrc</filename>, 
-<filename>~/.cshrc</filename>, 
-<filename>~/.history</filename>, 
-<filename>~/.cshdirs</filename>, 
-<filename>~/.login</filename>, 
-<filename>~/.logout</filename>. More information on these files can be 
-found in the <filename>tcsh(1)</filename> man page.</para>
+    <sect3 id="tcsh-config">
+      <title>Config Files</title>
 
-<indexterm zone="tcsh tcsh-config">
-<primary sortas="e-etc-csh.cshrc">/etc/csh.cshrc</primary></indexterm>
-<indexterm zone="tcsh tcsh-config">
-<primary sortas="e-etc-csh.login">/etc/csh.login</primary></indexterm>
-<indexterm zone="tcsh tcsh-config">
-<primary sortas="e-etc-csh.logout">/etc/csh.logout</primary></indexterm>
-<indexterm zone="tcsh tcsh-config">
-<primary sortas="e-AA.tcshrc">~/.tcshrc</primary></indexterm>
-<indexterm zone="tcsh tcsh-config">
-<primary sortas="e-AA.cshrc">~/.cshrc</primary></indexterm>
-<indexterm zone="tcsh tcsh-config">
-<primary sortas="e-AA.history">~/.history</primary></indexterm>
-<indexterm zone="tcsh tcsh-config">
-<primary sortas="e-AA.cshdirs">~/.cshdirs</primary></indexterm>
-<indexterm zone="tcsh tcsh-config">
-<primary sortas="e-AA.login">~/.login</primary></indexterm>
-<indexterm zone="tcsh tcsh-config">
-<primary sortas="e-AA.logout">~/.logout</primary></indexterm>
-</sect3>
+      <para>There are numerous configuration files for the C shell. Examples
+      of these are <filename>/etc/csh.cshrc</filename>,
+      <filename>/etc/csh.login</filename>, <filename>/etc/csh.logout</filename>,
+      <filename>~/.tcshrc</filename>, <filename>~/.cshrc</filename>,
+      <filename>~/.history</filename>, <filename>~/.cshdirs</filename>,
+      <filename>~/.login</filename>, and <filename>~/.logout</filename>. More
+      information on these files can be found in the
+      <filename>tcsh(1)</filename> man page.</para>
 
-</sect2>
+      <indexterm zone="tcsh tcsh-config">
+        <primary sortas="e-etc-csh.cshrc">/etc/csh.cshrc</primary>
+      </indexterm>
 
-<sect2>
-<title>Contents</title>
+      <indexterm zone="tcsh tcsh-config">
+        <primary sortas="e-etc-csh.login">/etc/csh.login</primary>
+      </indexterm>
 
-<segmentedlist>
-<segtitle>Installed Program</segtitle>
-<segtitle>Installed Libraries</segtitle>
-<segtitle>Installed Directories</segtitle>
-<seglistitem>
-<seg>tcsh</seg>
-<seg>None</seg>
-<seg>None</seg>
-</seglistitem>
-</segmentedlist>
+      <indexterm zone="tcsh tcsh-config">
+        <primary sortas="e-etc-csh.logout">/etc/csh.logout</primary>
+      </indexterm>
 
-<variablelist>
-<bridgehead renderas="sect3">Short Descriptions</bridgehead>
-<?dbfo list-presentation="list"?>
+      <indexterm zone="tcsh tcsh-config">
+        <primary sortas="e-AA.tcshrc">~/.tcshrc</primary>
+      </indexterm>
 
-<varlistentry id="tcsh-prog">
-<term><command>tcsh</command></term>
-<listitem><para>is an enhanced but completely compatible version of the 
-Berkeley Unix C shell, <command>csh</command>. It is usable as both an 
-interactive shell and a script processor.</para>
-<indexterm zone="tcsh tcsh-prog">
-<primary sortas="b-tcsh">tcsh</primary></indexterm>
-</listitem>
-</varlistentry>
-</variablelist>
+      <indexterm zone="tcsh tcsh-config">
+        <primary sortas="e-AA.cshrc">~/.cshrc</primary>
+      </indexterm>
 
-</sect2>
+      <indexterm zone="tcsh tcsh-config">
+        <primary sortas="e-AA.history">~/.history</primary>
+      </indexterm>
+
+      <indexterm zone="tcsh tcsh-config">
+        <primary sortas="e-AA.cshdirs">~/.cshdirs</primary>
+      </indexterm>
+
+      <indexterm zone="tcsh tcsh-config">
+        <primary sortas="e-AA.login">~/.login</primary>
+      </indexterm>
+
+      <indexterm zone="tcsh tcsh-config">
+        <primary sortas="e-AA.logout">~/.logout</primary>
+      </indexterm>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Program</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>tcsh</seg>
+        <seg>None</seg>
+        <seg>None</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="tcsh-prog">
+        <term><command>tcsh</command></term>
+        <listitem>
+          <para>is an enhanced but completely compatible version of the
+          Berkeley Unix C shell, <command>csh</command>. It is usable as both an
+          interactive shell and a script processor.</para>
+          <indexterm zone="tcsh tcsh-prog">
+            <primary sortas="b-tcsh">tcsh</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
 
 </sect1>
-
