Index: gnome/otherlibs/orbit.xml
===================================================================
--- gnome/otherlibs/orbit.xml	(revision ff769b8c6178dd8b799a5e122a2e6a5d69a22a2c)
+++ gnome/otherlibs/orbit.xml	(revision b409cd88a520821ce16706884d5b7ba04679fdf3)
@@ -10,5 +10,5 @@
 <!ENTITY ORBit-size "1 MB">
 <!ENTITY ORBit-buildsize "29.1 MB">
-<!ENTITY ORBit-time "0.61 SBU">
+<!ENTITY ORBit-time "0.59 SBU">
 ]>
 
@@ -21,4 +21,6 @@
 <title><application>
 <acronym>ORB</acronym>it</application>-&ORBit-version;</title>
+<indexterm zone="ORBit">
+<primary sortas="a-ORBit">ORBit</primary></indexterm>
 
 <sect2>
@@ -65,6 +67,9 @@
 
 <screen><userinput><command>./configure --prefix=/opt/gnome &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>
@@ -73,30 +78,57 @@
 <title>Contents</title>
 
-<para>The <application><acronym>ORB</acronym>it</application> package contains 
-<filename class="libraryfile">libIDL</filename>,
-<filename class="libraryfile">libIIOP</filename>, 
-<filename class="libraryfile">libORBit</filename>,
-<filename class="libraryfile">libORBitCosNaming</filename> and
-<filename class="libraryfile">libORBitutil</filename> libraries.</para>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directories</segtitle>
 
-</sect2>
+<seglistitem>
+<seg>ior-decode, libIDL-config, name-client, old-name-server, orbit-config, 
+orbit-idl, orbit-ird, orbit-event-server and orbit-name-server</seg>
+<seg>libIDL.[so,a], libIIOP.[so,a], libname-server.a, liborbit-c-backend.a, 
+libORBit.[so,a], libORBitCosNaming.[so,a] and libORBitutil.[so,a]</seg>
+<seg>/opt/gnome/share/idl, /opt/gnome/include/libIDL-1.0 and
+/opt/gnome/include/orbit-1.0</seg>
+</seglistitem>
+</segmentedlist>
 
-<sect2><title>Description</title>
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
 
-<sect3><title>libIDL</title>
-<para><filename class="libraryfile">libIDL</filename> library is the Interface 
-Definition Language mappings for CORBA.</para></sect3>
+<varlistentry id="libIDL-ORBit">
+<term><filename class='libraryfile'>libIDL.[so,a]</filename></term>
+<listitem><para>library is the Interface Definition Language mappings for 
+CORBA.</para>
+<indexterm zone="ORBit libIDL-ORBit">
+<primary sortas="c-libIDL">libIDL.[so,a]</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>libIIOP</title>
-<para><filename class="libraryfile">libIIOP</filename> library is for low level 
-CORBA communications.</para></sect3>
+<varlistentry id="libIIOP">
+<term><filename class='libraryfile'>libIIOP.[so,a]</filename></term>
+<listitem><para>is for low level CORBA communications.</para>
+<indexterm zone="ORBit libIIOP">
+<primary sortas="c-libIIOP">libIIOP.[so,a]</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>libORBit</title>
-<para><filename class="libraryfile">libORBit</filename> library is the CORBA 
-API.</para></sect3>
+<varlistentry id="libORBit">
+<term><filename class='libraryfile'>libORBit.[so,a]</filename></term>
+<listitem><para>is the CORBA <acronym>API</acronym>.</para>
+<indexterm zone="ORBit libORBit">
+<primary sortas="c-libORBit">libORBit.[so,a]</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>libORBitutil</title>
-<para><filename class="libraryfile">libORBitutil</filename> library
-contains the convenience routines for ORBit.</para></sect3>
+<varlistentry id="libORBitutil">
+<term><filename class='libraryfile'>libORBitutil.[so,a]</filename></term>
+<listitem><para>contains the convenience routines for 
+<application>ORBit</application>.</para>
+<indexterm zone="ORBit libORBitutil">
+<primary sortas="c-libORBitutil">libORBitutil.[so,a]</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
