glfs/gnome/add/gnome-games.xml
Randy McMurchy 8b158789c2 Juggled the gnome-version entity around so that updated packages can use it
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@7905 af4574ff-66df-0310-9fd7-8a98e5e911e0
2009-07-29 22:19:47 +00:00

176 lines
6.6 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gnome-games-download-http "&gnome-download-http;/gnome-games/&gnome-old-version;/gnome-games-&gnome-games-version;.tar.bz2">
<!ENTITY gnome-games-download-ftp "&gnome-download-ftp;/gnome-games/&gnome-old-version;/gnome-games-&gnome-games-version;.tar.bz2">
<!ENTITY gnome-games-md5sum "c3434a724cd72a536ba48d9187f10697">
<!ENTITY gnome-games-size "7.5 MB">
<!ENTITY gnome-games-buildsize "118 MB">
<!ENTITY gnome-games-time "1.8 SBU">
]>
<sect1 id="gnome-games" xreflabel="GNOME Games-&gnome-games-version;">
<?dbhtml filename="gnome-games.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>GNOME Games-&gnome-games-version;</title>
<indexterm zone="gnome-games">
<primary sortas="a-GNOME Games">GNOME Games</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to GNOME Games</title>
<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="&gnome-download-http;/gnome-games-extra-data/&gnome-old-version;/"/>.
</para>
<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>
<bridgehead renderas="sect3">GNOME Games Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="libgnomeui"/>,
<xref linkend="gnome-doc-utils"/>,
<xref linkend="gnome-python-desktop"/>, and
<xref linkend="librsvg"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="intltool"/>,
<xref linkend="esound"/>,
<xref linkend="guile"/>
(to build the AisleRiot solitaire games), and
<ulink url="http://www.ggzgamingzone.org/">GGZ</ulink> (to enable
network gaming; see the GNOME Games <filename>README</filename> file
for the specific GGZ packages you will need)</para>
<!-- Appears to be replaced by the GGZ stuff, but not really positive
<ulink url="http://www.avahi.org">Avahi</ulink> or
<ulink url="http://developer.apple.com/networking/bonjour/">Bonjour</ulink> -->
<para>See the <filename>glchess/README</filename> file for additional
optional dependencies for the chess game.</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gnome-games"/></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 -g 60 games &amp;&amp;
useradd -c 'Games High Score Owner' -d /var/lib/games \
-g games -s /bin/false -u 60 games &amp;&amp;
chown -v games:games /var/lib/games</userinput></screen>
<para>Install <application>GNOME Games</application> by
running the following commands:</para>
<screen><userinput>./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) \
--sysconfdir=&gnome-etc-dir; \
--localstatedir=/var/lib &amp;&amp;
make</userinput></screen>
<para>To test the results, issue <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../../xincludes/gnome-prefix.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../../xincludes/gnome-sysconfdir.xml"/>
<para><parameter>--localstatedir=/var/lib</parameter>: This parameter is
used so that all <application>ScrollKeeper</application> files are
installed in, and the <application>ScrollKeeper</application> database is
properly updated in
<filename class="directory">/var/lib/scrollkeeper</filename> instead of
<filename class="directory">$GNOME_PREFIX/var/scrollkeeper</filename> and
also causes the game programs to use
<filename class='directory'>/var/lib/games</filename> as the directory
holding the high score files.</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 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>blackjack, glchess, glines, gnect, gnectd, gnibbles, gnibblesd,
gnobots2, gnome-gnuchess, gnome-sudoku, gnometris, gnomine, gnotravex,
gnotski, gtali, iagno, iagnod, mahjongg, same-gnome, and sol</seg>
<seg>None</seg>
<seg>The following subdirectories of <envar>$GNOME_PREFIX</envar>/:
share/{{many game names},
{,omf/}gnome-games,
{,help,pixmaps,sound}/{game names},
/var/lib/games</seg>
</seglistitem>
</segmentedlist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<para>See the <filename>README</filename> file in the source tree for a
description of each game.</para>
</sect2>
</sect1>