source: gnome/add/gnome-games.xml@ 7f76b96

<?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/&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 "d3c675e29c835cfa765fbd6ae4a289cc">
<!ENTITY gnome-games-size "5.9 MB">
<!ENTITY gnome-games-buildsize "72 MB">
<!ENTITY gnome-games-time "0.98 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>

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

<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 now 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>

<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>

<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="guile"/> (to build the AisleRiot solitaire games)</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 High Score Owner' -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 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>
<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>

</sect2>

<sect2>
<title>Description</title>

<para>See the <filename>README</filename> file in the source tree for a 
description of each game.</para>

</sect2>

</sect1>