Index: pst/sgml/opensp.xml
===================================================================
--- pst/sgml/opensp.xml	(revision 2aae5cbe049759e319700c03c99c364bc1707951)
+++ pst/sgml/opensp.xml	(revision dbfc8e653382699733cdbf647fb7ec17620b079a)
@@ -9,5 +9,5 @@
   <!ENTITY opensp-size          "1.4 MB">
   <!ENTITY opensp-buildsize     "43 MB">
-  <!ENTITY opensp-time          "1.03 SBU">
+  <!ENTITY opensp-time          "0.97 SBU">
 ]>
 
@@ -19,4 +19,6 @@
 <?dbhtml filename="opensp.html"?>
 <title>OpenSP-&opensp-version;</title>
+<indexterm zone="opensp">
+<primary sortas="a-OpenSP">OpenSP</primary></indexterm>
 
 <sect2>
@@ -72,6 +74,9 @@
     --enable-default-catalog=/etc/sgml/catalog \
     --enable-default-search-path=/usr/share/sgml &amp;&amp;
-make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version; &amp;&amp;
-make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version; install &amp;&amp;
+make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version;</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version; install &amp;&amp;
 ln -sf onsgmls /usr/bin/nsgmls &amp;&amp;
 ln -sf osgmlnorm /usr/bin/sgmlnorm &amp;&amp;
@@ -83,5 +88,6 @@
 ln -sf libosp.so /usr/lib/libsp.so</command></userinput></screen>
 
-<!-- install-catalog -add /etc/sgml/OpenSP-&opensp-version;.cat \
+<!-- 
+install-catalog -add /etc/sgml/OpenSP-&opensp-version;.cat \
     /usr/share/sgml/OpenSP-&opensp-version;/catalog &amp;&amp;
 install-catalog -add /etc/sgml/sgml-docbook.cat \
@@ -93,5 +99,6 @@
     /usr/share/sgml/OpenSP-<replaceable>[version]</replaceable>/catalog &amp;&amp;
 install-catalog -remove /etc/sgml/sgml-docbook.cat \
-    /etc/sgml/OpenSP-<replaceable>[version]</replaceable>.cat</command></screen></para></tip> -->
+    /etc/sgml/OpenSP-<replaceable>[version]</replaceable>.cat</command></screen></para></tip>
+ -->
 
 </sect2>
@@ -131,33 +138,152 @@
 <title>Contents</title>
 
-<para>The <application>OpenSP</application> package contains 
-<command>onsgmls</command>,
-<command>ospam</command>, 
-<command>osx</command>,
-<command>ospcat</command> and
-<command>ospent</command>.</para>
-
-</sect2>
-
-<sect2><title>Description</title>
-
-<sect3><title>onsgmls</title>
-<para><command>onsgmls</command> processes <acronym>SGML</acronym> 
-files.</para></sect3>
-
-<sect3><title>ospam</title>
-<para><command>ospam</command> is a markup stream editor.</para></sect3>
-
-<sect3><title>osx</title>
-<para><command>osx</command> is a <acronym>SGML</acronym> normalizer or a 
-converter of <acronym>SGML</acronym> to <acronym>XML</acronym>.</para></sect3>
-
-<sect3><title>ospcat</title>
-<para><command>ospcat</command> prints effective system identifiers found in 
-the catalogs.</para></sect3>
-
-<sect3><title>ospent</title>
-<para><command>ospent</command> provides access to
-<application>OpenSP</application>'s entity manager.</para></sect3>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Library</segtitle>
+<segtitle>Installed Directories</segtitle>
+
+<seglistitem>
+<seg>onsgmls, osgmlnorm, ospam, ospcat, ospent, osx and the 
+<application>SP</application> equivalent symlinks: nsgmls, sgml2xml, sgmlnorm, 
+spam, spcat, spent and sx</seg>
+<seg>libosp.so and the <application>SP</application> equivalent symlink: 
+libsp.so</seg>
+<seg>/usr/include/OpenSP, /usr/share/doc/OpenSP and
+/usr/share/sgml/OpenSP-&opensp-version;</seg>
+</seglistitem>
+</segmentedlist>
+
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="onsgmls">
+<term><command>onsgmls</command></term>
+<listitem><para>is used to process <acronym>SGML</acronym> files.</para>
+<indexterm zone="opensp onsgmls">
+<primary sortas="b-onsgmls">onsgmls</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="osgmlnorm">
+<term><command>osgmlnorm</command></term>
+<listitem><para>prints on the standard output a normalized document instance 
+for the SGML document contained in the concatenation of the entities with 
+system identifiers .nf and .fi.</para>
+<indexterm zone="opensp osgmlnorm">
+<primary sortas="b-osgmlnorm">osgmlnorm</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="ospam">
+<term><command>ospam</command></term>
+<listitem><para>is a markup stream editor.</para>
+<indexterm zone="opensp ospam">
+<primary sortas="b-ospam">ospam</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="ospcat">
+<term><command>ospcat</command></term>
+<listitem><para>prints effective system identifiers found in the 
+catalogs.</para>
+<indexterm zone="opensp ospcat">
+<primary sortas="b-ospcat">ospcat</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="ospent">
+<term><command>ospent</command></term>
+<listitem><para>provides access to <application>OpenSP</application>'s 
+entity manager.</para>
+<indexterm zone="opensp ospent">
+<primary sortas="b-ospent">ospent</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="osx">
+<term><command>osx</command></term>
+<listitem><para>is an <acronym>SGML</acronym> normalizer or used to convert 
+<acronym>SGML</acronym> files to <acronym>XML</acronym> files.</para>
+<indexterm zone="opensp osx">
+<primary sortas="b-osx">osx</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="nsgmls">
+<term><command>nsgmls</command></term>
+<listitem><para>is a symlink to <command>onsgmls</command>.</para>
+<indexterm zone="opensp nsgmls">
+<primary sortas="g-nsgmls">nsgmls</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="sgml2xml">
+<term><command>sgml2xml</command></term>
+<listitem><para>is a symlink to <command>osx</command>.</para>
+<indexterm zone="opensp sgml2xml">
+<primary sortas="g-sgml2xml">sgml2xml</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="sgmlnorm">
+<term><command>sgmlnorm</command></term>
+<listitem><para>is a symlink to <command>osgmlnorm</command>.</para>
+<indexterm zone="opensp sgmlnorm">
+<primary sortas="g-sgmlnorm">sgmlnorm</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="spam">
+<term><command>spam</command></term>
+<listitem><para>is a symlink to <command>ospam</command>.</para>
+<indexterm zone="opensp spam">
+<primary sortas="g-spam">spam</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="spcat">
+<term><command>spcat</command></term>
+<listitem><para>is a symlink to <command>ospcat</command>.</para>
+<indexterm zone="opensp spcat">
+<primary sortas="g-spcat">spcat</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="spent">
+<term><command>spent</command></term>
+<listitem><para>is a symlink to <command>ospent</command>.</para>
+<indexterm zone="opensp spent">
+<primary sortas="g-spent">spent</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="sx">
+<term><command>sx</command></term>
+<listitem><para>is a symlink to <command>osx</command>.</para>
+<indexterm zone="opensp sx">
+<primary sortas="g-sx">sx</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="libosp">
+<term><filename class='libraryfile'>libosp.so</filename></term>
+<listitem><para>contains functions required by the 
+<application>OpenSP</application> programs to parse, validate and 
+manipulate SGML and XML files.</para>
+<indexterm zone="opensp libosp">
+<primary sortas="c-libosp">libosp.so</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="libsp">
+<term><filename class='libraryfile'>libsp.so</filename></term>
+<listitem><para>is a symlink to 
+<filename class='libraryfile'>libosp.so</filename>.</para>
+<indexterm zone="opensp libsp">
+<primary sortas="g-libsp">libsp.so</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
