Index: connect/dialup/dialup.xml
===================================================================
--- connect/dialup/dialup.xml	(revision 820d164a992b1186d55eed12a4ab3b02951ae7cc)
+++ connect/dialup/dialup.xml	(revision c99aa38d6e76047d01bc454fe860137907d62bc2)
@@ -7,12 +7,12 @@
 
 <chapter id="connect-dialup">
-<?dbhtml filename="dialup.html"?>
-<title>Dial-up networking</title>
-
-<para>This chapter provides utilites for system interaction with a modem.</para>
-
-
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ppp.xml"/> 
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wvdial.xml"/> 
+  <?dbhtml filename="dialup.html"?>
+  
+  <title>Dial-up networking</title>
+  
+  <para>This chapter provides utilites for system interaction with a modem.</para>
+  
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ppp.xml"/> 
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wvdial.xml"/> 
 
 </chapter>
Index: connect/dialup/ppp.xml
===================================================================
--- connect/dialup/ppp.xml	(revision 820d164a992b1186d55eed12a4ab3b02951ae7cc)
+++ connect/dialup/ppp.xml	(revision c99aa38d6e76047d01bc454fe860137907d62bc2)
@@ -14,154 +14,185 @@
 
 <sect1 id="ppp" xreflabel="PPP-&ppp-version;">
-<sect1info>
-<othername>$LastChangedBy$</othername>
-<date>$Date$</date>
-</sect1info>
-<?dbhtml filename="ppp.html"?>
-<title>PPP-&ppp-version;</title>
-<indexterm zone="ppp">
-<primary sortas="a-PPP">PPP</primary></indexterm>
+  <?dbhtml filename="ppp.html"?>
+  
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+  
+  <title>PPP-&ppp-version;</title>
+  
+  <indexterm zone="ppp">
+    <primary sortas="a-PPP">PPP</primary>
+  </indexterm>
 
-<sect2>
-<title>Introduction to <application><acronym>PPP</acronym></application></title>
+  <sect2 role="package">
+    <title>Introduction to PPP</title>
+    
+    <para>The <application>PPP</application> package contains the 
+    <command>pppd</command> daemon and the <command>chat</command> 
+    program. This is used for connecting to other machines; often for connecting to
+    the Internet via a dial-up or PPPoE connection to an ISP.</para>
+    
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&ppp-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&ppp-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &ppp-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &ppp-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &ppp-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &ppp-time;</para>
+      </listitem>
+    </itemizedlist>
+    
+    <bridgehead renderas="sect3">PPP Dependencies</bridgehead>
+    
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para><xref linkend="libpcap"/></para>
+    
+  </sect2>
+  
+  <sect2 role="installation">
+    <title>Installation of PPP</title>
 
-<para>The <application><acronym>PPP</acronym></application> package contains 
-the <command>pppd</command> daemon and the <command>chat</command> program.
-This is used for connecting to other machines; often for connecting to
-the Internet via a dial-up or <acronym>PPPoE</acronym> connection to an 
-<acronym>ISP</acronym>.</para>
+    <note id="ppp-kernel">
+      <para><application>PPP</application> support must be 
+      compiled into the kernel or available as a kernel module.</para>
+    </note>
+    
+    <indexterm zone="ppp ppp-kernel">
+      <primary sortas="d-PPP-support">PPP support</primary>
+    </indexterm>
+    
+    <para>Install <application>PPP</application> by running the 
+    following commands:</para>
 
-<sect3><title>Package information</title>
-<itemizedlist spacing='compact'>
-<listitem><para>Download (HTTP): <ulink
-url="&ppp-download-http;"/></para></listitem>
-<listitem><para>Download (FTP): <ulink
-url="&ppp-download-ftp;"/></para></listitem>
-<listitem><para>Download MD5 sum: &ppp-md5sum;</para></listitem>
-<listitem><para>Download size: &ppp-size;</para></listitem>
-<listitem><para>Estimated disk space required:
-&ppp-buildsize;</para></listitem>
-<listitem><para>Estimated build time:
-&ppp-time;</para></listitem></itemizedlist>
-</sect3>
+<screen><userinput>./configure --prefix=/usr &amp;&amp;
+make</userinput></screen>
 
-<sect3><title><application><acronym>PPP</acronym></application> dependencies</title>
-<sect4><title>Required</title>
-<para><xref linkend="libpcap"/></para>
-</sect4>
-</sect3>
+    <para>This package does not come with a test suite.</para>
+    
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
-</sect2>
+<screen role='root'><userinput>make install &amp;&amp;
+make install-etcppp</userinput></screen>
+    
+  </sect2>
+  
+  <sect2 role="commands">
+    <title>Command Explanations</title>
 
-<sect2 id="ppp-kernel">
-<title>Installation of <application><acronym>PPP</acronym></application></title>
+    <para><command>make install-etcppp</command>: This command puts example 
+    configuration files in <filename class="directory">/etc/ppp</filename>.</para>
+    
+  </sect2>
+  
+  <sect2 role="configuration">
+    <title>Configuring PPP</title>
 
-<note><para><application><acronym>PPP</acronym></application> support must be 
-compiled into the kernel or available as a kernel module.</para></note>
-<indexterm zone="ppp ppp-kernel">
-<primary sortas="d-PPP-support">PPP support</primary></indexterm>
+    <sect3 id="ppp-config">
+      <title>Config Files</title>
+      
+      <para><filename>/etc/ppp/*</filename></para>
+      
+      <indexterm zone="ppp ppp-config">
+        <primary sortas="e-etc-ppp-star">/etc/ppp/*</primary>
+      </indexterm>
+    
+    </sect3>
+    
+    <sect3>
+      <title>Configuration Information</title>
+      
+      <para>The <application>PPP</application> daemon requires very little 
+      configuration. The main trick is scripting the connection. This can be done 
+      either using the <command>chat</command> program which comes with 
+      this package or by using <xref linkend="wvdial"/>.</para>
+      
+    </sect3>
+    
+  </sect2>
+  
+  <sect2 role="content">
+    <title>Contents</title>
 
-<para>Install <application><acronym>PPP</acronym></application> by running the 
-following commands:</para>
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+      
+      <seglistitem>
+        <seg>chat, pppd, pppdump, pppoe-discovery and pppstats</seg>
+        <seg>Several plugin modules installed in 
+        <filename class='directory'>/usr/lib/pppd/2.4.3</filename></seg>
+        <seg>/etc/ppp, /usr/include/pppd and /usr/lib/pppd</seg>
+      </seglistitem>
+    </segmentedlist>
+    
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+      
+      <varlistentry id="chat">
+        <term><command>chat</command></term>
+        <listitem>
+          <para>defines a conversational exchange between the computer and the 
+          modem. Its primary purpose is to establish the connection between the 
+          Point-to-Point Protocol Daemon (PPPD) and the remote's 
+          <command>pppd</command> process.</para>
+          <indexterm zone="ppp chat">
+            <primary sortas="b-chat">chat</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+      
+      <varlistentry id="pppd">
+        <term><command>pppd</command></term>
+        <listitem>
+          <para>is the Point to Point Protocol daemon.</para>
+          <indexterm zone="ppp pppd">
+            <primary sortas="b-pppd">pppd</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+      
+      <varlistentry id="pppdump">
+        <term><command>pppdump</command></term>
+        <listitem>
+          <para>is used to convert 
+          <application>PPP</application> record files to a readable 
+          format.</para>
+          <indexterm zone="ppp pppdump">
+            <primary sortas="b-pppdump">pppdump</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+      
+      <varlistentry id="pppstats">
+        <term><command>pppstats</command></term>
+        <listitem>
+          <para>is used to print 
+          <application>PPP</application> statistics.</para>
+          <indexterm zone="ppp pppstats">
+            <primary sortas="b-pppstats">pppstats</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+    
+    </variablelist>
 
-<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
-make</command></userinput></screen>
-
-<para>This package does not come with a test suite.</para>
-
-<para>Now, as the root user:</para>
-
-<screen><userinput role='root'><command>make install &amp;&amp;
-make install-etcppp</command></userinput></screen>
-
-</sect2>
-
-<sect2>
-<title>Command explanations</title>
-
-<para><command>make install-etcppp</command>: This command puts example 
-configuration files in <filename class="directory">/etc/ppp</filename>.</para>
-
-</sect2>
-
-<sect2>
-<title>Configuring <application><acronym>PPP</acronym></application></title>
-
-<sect3 id="ppp-config"><title>Config files</title>
-<para><filename>/etc/ppp/*</filename></para>
-<indexterm zone="ppp ppp-config">
-<primary sortas="e-etc-ppp-star">/etc/ppp/*</primary></indexterm>
-</sect3>
-
-<sect3><title>Configuration Information</title>
-
-<para>The <application><acronym>PPP</acronym></application> daemon requires 
-very little configuration.  The main trick is scripting the connection.  This 
-can be done either using the <command>chat</command> program which comes with 
-this package or by using <xref linkend="wvdial"/>.</para>
-</sect3>
-
-</sect2>
-
-<sect2>
-<title>Contents</title>
-
-<segmentedlist>
-<segtitle>Installed Programs</segtitle>
-<segtitle>Installed Libraries</segtitle>
-<segtitle>Installed Directories</segtitle>
-
-<seglistitem>
-<seg>chat, pppd, pppdump, pppoe-discovery and pppstats</seg>
-<seg>Several plugin modules installed in 
-<filename class='directory'>/usr/lib/pppd/2.4.3</filename></seg>
-<seg>/etc/ppp, /usr/include/pppd and /usr/lib/pppd</seg>
-</seglistitem>
-</segmentedlist>
-
-<variablelist>
-<bridgehead renderas="sect3">Short Descriptions</bridgehead>
-<?dbfo list-presentation="list"?>
-
-<varlistentry id="chat">
-<term><command>chat</command></term>
-<listitem><para>defines a conversational exchange between the computer and the 
-modem. Its primary purpose is to establish the connection between the 
-Point-to-Point Protocol Daemon (<acronym>PPPD</acronym>) and the remote's 
-<command>pppd</command> process.</para>
-<indexterm zone="ppp chat">
-<primary sortas="b-chat">chat</primary>
-</indexterm></listitem>
-</varlistentry>
-
-<varlistentry id="pppd">
-<term><command>pppd</command></term>
-<listitem><para>is the Point to Point Protocol daemon.</para>
-<indexterm zone="ppp pppd">
-<primary sortas="b-pppd">pppd</primary>
-</indexterm></listitem>
-</varlistentry>
-
-<varlistentry id="pppdump">
-<term><command>pppdump</command></term>
-<listitem><para>is used to convert 
-<application><acronym>PPP</acronym></application> record files to a readable 
-format.</para>
-<indexterm zone="ppp pppdump">
-<primary sortas="b-pppdump">pppdump</primary>
-</indexterm></listitem>
-</varlistentry>
-
-<varlistentry id="pppstats">
-<term><command>pppstats</command></term>
-<listitem><para>is used to print 
-<application><acronym>PPP</acronym></application> statistics.</para>
-<indexterm zone="ppp pppstats">
-<primary sortas="b-pppstats">pppstats</primary>
-</indexterm></listitem>
-</varlistentry>
-</variablelist>
-
-</sect2>
+  </sect2>
 
 </sect1>
