source: gnome/add/gnome-games.xml@ da314d82

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/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 "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>

<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 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"/> 
(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>

</sect2>

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

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

<screen><userinput><command>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>

<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</command></userinput></screen>

<para>This package does not come with a test suite.</para>

<para>Now, as the root user:</para>

<screen><userinput role='root'><command>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> 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><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>