Index: gnome/add/gnome-games.xml
===================================================================
--- gnome/add/gnome-games.xml	(revision a28e041389830c746263879211329139e7472037)
+++ gnome/add/gnome-games.xml	(revision 7f23340509edea607baa1cf0ecdd8f5f49163584)
@@ -5,141 +5,154 @@
   %general-entities;
 
-<!ENTITY gnome-games-download-http "http://ftp.gnome.org/pub/GNOME/sources/gnome-games/&gnome-version;/gnome-games-&gnome-games-version;.tar.bz2">
-<!ENTITY gnome-games-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/gnome-games/&gnome-version;/gnome-games-&gnome-games-version;.tar.bz2">
-<!ENTITY gnome-games-md5sum "b7d21e5e12de80c50266e8735e04577c">
-<!ENTITY gnome-games-size "5.3 MB">
-<!ENTITY gnome-games-buildsize "70 MB">
-<!ENTITY gnome-games-time "0.9 SBU">
+  <!ENTITY gnome-games-download-http "http://ftp.gnome.org/pub/GNOME/sources/gnome-games/&gnome-version;/gnome-games-&gnome-games-version;.tar.bz2">
+  <!ENTITY gnome-games-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/gnome-games/&gnome-version;/gnome-games-&gnome-games-version;.tar.bz2">
+  <!ENTITY gnome-games-md5sum "b7d21e5e12de80c50266e8735e04577c">
+  <!ENTITY gnome-games-size "5.3 MB">
+  <!ENTITY gnome-games-buildsize "70 MB">
+  <!ENTITY gnome-games-time "0.9 SBU">
 ]>
 
 <sect1 id="gnome-games" xreflabel="GNOME Games-&gnome-games-version;">
-<sect1info>
-<othername>$LastChangedBy$</othername>
-<date>$Date$</date>
-</sect1info>
-<?dbhtml filename="gnome-games.html"?>
-<title>GNOME Games-&gnome-games-version;</title>
+  <?dbhtml filename="gnome-games.html"?>
 
-<sect2>
-<title>Introduction to <application><acronym>GNOME</acronym> 
-Games</application></title>
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
 
-<para>The <application><acronym>GNOME</acronym> Games</application> package 
-contains games. 
-Starting with <application><acronym>GNOME</acronym></application>-2.8, the
-background graphics, artwork and themes for the games are supplied in a 
-separate package. You can download the 
-<application><acronym>GNOME</acronym></application> Games Extra Data package 
-from <ulink 
-url="http://ftp.gnome.org/pub/GNOME/sources/gnome-games-extra-data/&gnome-version;/"/>.
-</para>
+  <title>GNOME Games-&gnome-games-version;</title>
 
-<sect3><title>Package information</title>
-<itemizedlist spacing='compact'>
-<listitem><para>Download (HTTP): <ulink
-url="&gnome-games-download-http;"/></para></listitem>
-<listitem><para>Download (FTP): <ulink
-url="&gnome-games-download-ftp;"/></para></listitem>
-<listitem><para>Download MD5 sum: &gnome-games-md5sum;</para></listitem>
-<listitem><para>Download size: &gnome-games-size;</para></listitem>
-<listitem><para>Estimated disk space required:
-&gnome-games-buildsize;</para></listitem>
-<listitem><para>Estimated build time:
-&gnome-games-time;</para></listitem></itemizedlist>
-</sect3>
+  <indexterm zone="gnome-games">
+    <primary sortas="a-GNOME Games">GNOME Games</primary>
+  </indexterm>
 
-<sect3><title><application><acronym>GNOME</acronym> Games</application> 
-dependencies</title>
-<sect4><title>Required</title>
-<para><xref linkend="libgnomeui"/>, 
-<xref linkend="scrollkeeper"/> and 
-<xref linkend="librsvg"/></para>
-</sect4>
+  <sect2 role="package">
+    <title>Introduction to GNOME Games</title>
 
-<sect4><title>Optional</title>
-<para><xref linkend="guile"/> 
-(required to build the AisleRiot solitaire games), 
-<ulink url="http://www.porchdogsoft.com/products/howl/">Howl</ulink> and 
-<ulink url="http://www.5z.com/jirka/gob.html">GOB2</ulink></para>
-</sect4>
-</sect3>
+    <para>The <application>GNOME Games</application> package contains games.
+    Starting with <application>GNOME</application>-2.8, the background graphics,
+    artwork and themes for the games are supplied in a separate package. You
+    can download the <application>GNOME</application> Games Extra Data package
+    from <ulink
+    url="http://ftp.gnome.org/pub/GNOME/sources/gnome-games-extra-data/&gnome-version;/"/>.
+    </para>
 
-</sect2>
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&gnome-games-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&gnome-games-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &gnome-games-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &gnome-games-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &gnome-games-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &gnome-games-time;</para>
+      </listitem>
+    </itemizedlist>
 
-<sect2>
-<title>Installation of <application><acronym>GNOME</acronym> 
-Games</application></title>
+    <bridgehead renderas="sect3">GNOME Games Dependencies</bridgehead>
 
-<para>Some of the <application><acronym>GNOME</acronym> Games</application> 
-game binaries need to be setgid to track high scores. Create a separate 
-user and group for games. See the <filename>README</filename> file in the 
-source directory for more information:</para>
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para><xref linkend="libgnomeui"/>,
+    <xref linkend="scrollkeeper"/> and
+    <xref linkend="librsvg"/></para>
 
-<screen><userinput><command>install -v -m755 -d /var/lib/games &amp;&amp;
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para><xref linkend="guile"/>
+    (required to build the AisleRiot solitaire games),
+    <ulink url="http://www.porchdogsoft.com/products/howl/">Howl</ulink> and
+    <ulink url="http://www.5z.com/jirka/gob.html">GOB2</ulink></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of GNOME Games</title>
+
+    <para>Some of the <application>GNOME Games</application> game binaries
+    need to be setgid to track high scores. Create a separate user and group
+    for games. See the <filename>README</filename> file in the source directory
+    for more information:</para>
+
+<screen role="root"><userinput>install -v -m755 -d /var/lib/games &amp;&amp;
 groupadd games &amp;&amp;
 useradd -c 'Games High Score Owner' -d /var/lib/games \
         -g games -s /bin/false games &amp;&amp;
-chown -v games:games /var/lib/games</command></userinput></screen>
+chown -v games:games /var/lib/games</userinput></screen>
 
-<para>Install <application><acronym>GNOME</acronym> Games</application> by 
-running the following commands:</para>
+    <para>Install <application>GNOME Games</application> by
+    running the following commands:</para>
 
-<screen><userinput><command>./configure --prefix=`pkg-config --variable=prefix ORBit-2.0` \
+<screen><userinput>./configure --prefix=`pkg-config --variable=prefix ORBit-2.0` \
     --localstatedir=/var/lib --sysconfdir=/etc/gnome &amp;&amp;
-make</command></userinput></screen>
+make</userinput></screen>
 
-<para>This package does not come with a test suite.</para>
+    <para>This package does not come with a test suite.</para>
 
-<para>Now, as the root user:</para>
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
-<screen><userinput role='root'><command>make install</command></userinput></screen>
+<screen role="root"><userinput>make install</userinput></screen>
 
-</sect2>
+  </sect2>
 
-<sect2>
-<title>Command explanations</title>
+  <sect2 role="commands">
+    <title>Command Explanations</title>
 
-<para><parameter>--localstatedir=/var/lib</parameter>: This switch
-puts <application>ScrollKeeper</application> files in 
-<filename class="directory">/var/lib/scrollkeeper</filename> instead of 
-<filename class="directory">$GNOME_PREFIX/var/scrollkeeper</filename> and 
-also causes the programs to use 
-<filename class='directory'>/var/lib/games</filename> as the directory 
-holding the high score files.</para>
+    <para><parameter>--localstatedir=/var/lib</parameter>: This switch
+    puts <application>ScrollKeeper</application> files in
+    <filename class="directory">/var/lib/scrollkeeper</filename> instead of
+    <filename class="directory">$GNOME_PREFIX/var/scrollkeeper</filename> and
+    also causes the programs to use
+    <filename class='directory'>/var/lib/games</filename> as the directory
+    holding the high score files.</para>
 
-<para><parameter>--sysconfdir=/etc/gnome</parameter>: This switch puts
-configuration files in <filename class="directory">/etc/gnome</filename> 
-instead of <filename class="directory">$GNOME_PREFIX/etc</filename>.</para>
+    <para><parameter>--sysconfdir=/etc/gnome</parameter>: This switch puts
+    configuration files in <filename class="directory">/etc/gnome</filename>
+    instead of <filename class="directory">$GNOME_PREFIX/etc</filename>.</para>
 
-<para><option>--disable-setgid</option>: This will prevent the setgid bit
-on the executables from being set. It provides system administrators
-with the option to disable setgid binaries, though it also means that the 
-functionality to save high game scores will be disabled.</para>
+    <para><option>--disable-setgid</option>: This will prevent the setgid bit
+    on the executables from being set. It provides system administrators
+    with the option to disable setgid binaries, though it also means that the
+    functionality to save high game scores will be disabled.</para>
 
-</sect2>
+  </sect2>
 
-<sect2>
-<title>Contents</title>
+  <sect2 role="content">
+    <title>Contents</title>
 
-<para>The <application><acronym>GNOME</acronym> Games</application> package 
-contains 
-<command>blackjack</command>, <command>gataxx</command>, 
-<command>glines</command>, <command>gnect</command>, 
-<command>gnibbles</command>, <command>gnobots2</command>, 
-<command>gnome-stones</command>, <command>gnometris</command>, 
-<command>gnomine</command>, <command>gnotravex</command>, 
-<command>gnotski</command>, <command>gtali</command>, 
-<command>iagno</command>, <command>mahjongg</command>, 
-<command>same-gnome</command> and <command>sol</command>.</para>
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
 
-</sect2>
+      <seglistitem>
+        <seg>blackjack, games-server.py, gataxx, glines, gnect, gnibbles,
+        gnobots2, gnome-stones, gnometris, gnomine, gnotravex, gnotski,
+        gtali, iagno, mahjongg, same-gnome, and sol</seg>
+        <seg><command>gnome-stones</command> objects</seg>
+        <seg>/etc/gnome/gconf/gconf.xml.defaults/apps/[game name],
+        /etc/gnome/gconf/gconf.xml.defaults/schemas/apps/[game name],
+        $GOME_PREFIX/lib/gnome-stones,
+        $GOME_PREFIX/share/gnome-games,
+        $GOME_PREFIX/share/[,help,pixmaps,sound]/[game name],
+        $GOME_PREFIX/share/omf/gnome-games, and
+        /var/lib/games</seg>
+      </seglistitem>
+    </segmentedlist>
 
-<sect2>
-<title>Description</title>
+    <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 
-<para>See the <filename>README</filename> file in the source tree for a 
-description of each game.</para>
+    <para>See the <filename>README</filename> file in the source tree for a
+    description of each game.</para>
 
-</sect2>
+  </sect2>
 
 </sect1>
