source: gnome/add/gnome-games.xml@ 9d2dc4e2

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

<!ENTITY gnome-games-download-http "http://ftp.gnome.org/pub/GNOME/sources/gnome-games/2.6/gnome-games-&gnome-games-version;.tar.bz2">
<!ENTITY gnome-games-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/gnome-games/2.6/gnome-games-&gnome-games-version;.tar.bz2">
<!ENTITY gnome-games-size "7.9 MB">
<!ENTITY gnome-games-buildsize "92 MB">
<!ENTITY gnome-games-time "0.99 SBU">

]>

<sect1 id="gnome-games" xreflabel="GNOME Games-&gnome-games-version;">
<?dbhtml filename="gnome-games.html"?>
<title>GNOME Games-&gnome-games-version;</title>

<sect2>
<title>Introduction to <application><acronym>GNOME</acronym> Games</application></title>

<para>The <application><acronym>GNOME</acronym> Games</application> package contains games.</para>

<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 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>
                                                                                
<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>
<sect4><title>Optional</title>
<para>
<xref linkend="esound"/> and
<xref linkend="guile"/>
</para></sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application><acronym>GNOME</acronym> Games</application></title>

<para><application><acronym>GNOME</acronym> Games</application> needs 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><userinput><command>install -d /var/lib/games &amp;&amp;
groupadd games &amp;&amp;
useradd -c 'games' -d /var/lib/games -g games -s /bin/false games &amp;&amp;
chown games:games /var/lib/games</command></userinput></screen>

<para>Install <application><acronym>GNOME</acronym> Games</application> by running the following commands:</para>

<screen><userinput><command>./configure --prefix=`pkg-config --variable=prefix ORBit-2.0` \
    --localstatedir=/var/lib --sysconfdir=/etc/gnome &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

</sect2>

<sect2>
<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>.</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 administrator's
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>
<title>Contents</title>

<para>The <application><acronym>GNOME</acronym> Games</application> package contains
<command>aisleriot</command>, <command>freecell</command>,
<command>gataxx</command>, <command>glines</command>,
<command>gnect</command>, <command>gnibbles</command>,
<command>gnobots2</command>, <command>gnome-stones</command>,
<command>gnome-xbill</command>, <command>gnometris</command>,
<command>gnomine</command>, <command>gnotravex</command>,
<command>gnotski</command>, <command>gtali</command>,
<command>iagno</command>, <command>mahjongg</command> and
<command> same-gnome</command>.</para>

</sect2>

</sect1>