Index: general.ent
===================================================================
--- general.ent	(revision 6587e9364a80de5cd2867d18c6025ea2cd1c76cc)
+++ general.ent	(revision 1af6dcf9b3e49a2c2589a716818897736a84c6b4)
@@ -1,3 +1,3 @@
-<!ENTITY day          "27">
+<!ENTITY day          "28">
 <!ENTITY month        "03">
 <!ENTITY year         "2005">
Index: pst/sgml/sgml-common.xml
===================================================================
--- pst/sgml/sgml-common.xml	(revision 6587e9364a80de5cd2867d18c6025ea2cd1c76cc)
+++ pst/sgml/sgml-common.xml	(revision 1af6dcf9b3e49a2c2589a716818897736a84c6b4)
@@ -8,6 +8,6 @@
   <!ENTITY sgml-common-md5sum        "103c9828f24820df86e55e7862e28974">
   <!ENTITY sgml-common-size          "75 KB">
-  <!ENTITY sgml-common-buildsize     "648 KB">
-  <!ENTITY sgml-common-time          "0.00 SBU">
+  <!ENTITY sgml-common-buildsize     "1.5 MB">
+  <!ENTITY sgml-common-time          "0.03 SBU">
 ]>
 
@@ -19,4 +19,6 @@
 <?dbhtml filename="sgml-common.html"?>
 <title>SGML Common-&sgml-common-version;</title>
+<indexterm zone="sgml-common">
+<primary sortas="a-SGML-Common">SGML Common</primary></indexterm>
 
 <sect2>
@@ -72,6 +74,9 @@
 
 <screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
-make &amp;&amp;
-make install &amp;&amp;
+make</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install &amp;&amp;
 install-catalog --add /etc/sgml/sgml-ent.cat \
     /usr/share/sgml/sgml-iso-entities-8879.1986/catalog &amp;&amp;
@@ -80,10 +85,11 @@
 
 <tip><title>Update hint</title>
-<para>Remove the above catalog items prior to upgrading with:
+<para>Remove the above catalog items prior to upgrading (as the root user) 
+with:
 
-<screen><command>install-catalog --remove /etc/sgml/sgml-ent.cat \
+<screen><userinput role='root'><command>install-catalog --remove /etc/sgml/sgml-ent.cat \
     /usr/share/sgml/sgml-iso-entities-8879.1986/catalog &amp;&amp;
 install-catalog --remove /etc/sgml/sgml-docbook.cat \
-    /etc/sgml/sgml-ent.cat</command></screen></para></tip>
+    /etc/sgml/sgml-ent.cat</command></userinput></screen></para></tip>
 
 </sect2>
@@ -93,6 +99,9 @@
 Common</application></title>
 
-<sect3><title>Config files</title>
+<sect3 id="sgml-common-config"><title>Config files</title>
 <para><filename>/etc/sgml/sgml.conf</filename></para>
+<indexterm zone="sgml-common sgml-common-config">
+<primary sortas="e-etc-sgml-sgml.conf">/etc/sgml/sgml.conf</primary>
+</indexterm>
 </sect3>
 
@@ -107,31 +116,60 @@
 <title>Contents</title>
 
-<para>The <application><acronym>SGML</acronym> Common</application> package 
-contains <command>install-catalog</command>,
-<command>sgmlwhich</command>, <acronym>SGML</acronym> entities
-files and <acronym>XML</acronym> entities files.</para>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Misc. Files</segtitle>
+<segtitle>Installed Directories</segtitle>
 
-</sect2>
+<seglistitem>
+<seg>install-catalog and sgmlwhich</seg>
+<seg>None</seg>
+<seg>SGML and XML DocBook entity files</seg>
+<seg>/etc/sgml, /usr/share/doc/sgml-common-&sgml-common-version; and 
+/usr/share/sgml</seg>
+</seglistitem>
+</segmentedlist>
 
-<sect2><title>Description</title>
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
 
-<sect3><title>install-catalog</title>
-<para><command>install-catalog</command> creates a centralized catalog that 
-maintains references to catalogs scattered throughout the
-<filename class="directory">/usr/share/sgml</filename> directory 
-tree.</para></sect3>
+<varlistentry id="install-catalog">
+<term><command>install-catalog</command></term>
+<listitem><para>creates a centralized catalog that maintains references to 
+catalogs scattered throughout the 
+<filename class="directory">/usr/share/sgml</filename> directory tree.</para>
+<indexterm zone="sgml-common install-catalog">
+<primary sortas="b-install-catalog">install-catalog</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>sgmlwhich</title>
-<para><command>sgmlwhich</command> will print to standard output the name of 
-the main configuration file.</para></sect3>
+<varlistentry id="sgmlwhich">
+<term><command>sgmlwhich</command></term>
+<listitem><para>will print to standard output the name of the main 
+configuration file.</para>
+<indexterm zone="sgml-common sgmlwhich">
+<primary sortas="b-sgmlwhich">sgmlwhich</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>SGML entities files</title>
-<para><acronym>SGML</acronym> entities files contain the basic character 
-entities defined with <acronym>SDATA</acronym> entries.</para></sect3>
+<varlistentry id="SGML-entities">
+<term><filename>SGML entities files</filename></term>
+<listitem><para>contain the basic character entities defined with 
+<acronym>SDATA</acronym> entries.</para>
+<indexterm zone="sgml-common SGML-entities">
+<primary sortas="g-sgml-entities-files">SGML entities files</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>XML entities files</title>
-<para><acronym>XML</acronym> entities files contain the basic character 
-entities defined by a hexadecimal representation of the Unicode character
-number.</para></sect3>
+<varlistentry id="XML-entities">
+<term><filename>XML entities files</filename></term>
+<listitem><para> contain the basic character entities defined by a hexadecimal 
+representation of the Unicode character number.</para>
+<indexterm zone="sgml-common XML-entities">
+<primary sortas="g-xml-entities-files">XML entities files</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
