glfs/gnome/add/gnome-games.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-version;/gnome-games-&gnome-games-version;.tar.bz2">
  <!ENTITY gnome-games-download-ftp             "&gnome-download-ftp;/gnome-games/&gnome-version;/gnome-games-&gnome-games-version;.tar.bz2">
  <!ENTITY gnome-games-md5sum                   "1fc03fe2209aa8a70da8f25d6eae1735">
  <!ENTITY gnome-games-size                     "26.4 MB">
  <!ENTITY gnome-games-buildsize                "197 MB">
  <!ENTITY gnome-games-time                     "5.2 SBU">
  <!ENTITY gnome-games-extra-data-version       "2.30.0">
  <!ENTITY gnome-games-extra-data-download-http "&gnome-download-http;/gnome-games-extra-data/&gnome-version;/gnome-games-extra-data-&gnome-games-extra-data-version;.tar.bz2">
  <!ENTITY gnome-games-extra-data-md5sum        "dab5e24779b77bf9f9b1b422460a9a97">
  <!ENTITY gnome-games-extra-data-size          "3.4 MB">
]>

<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.</para>

    &lfs65_built;

    <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">Additional Download</bridgehead>

    <itemizedlist spacing="compact">
      <title>Optional GNOME Games Extra Data package</title>
      <listitem>
        <para>Download (HTTP): <ulink url="&gnome-games-extra-data-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &gnome-games-extra-data-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &gnome-games-extra-data-size;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">GNOME Games Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="clutter-gtk"/>,
    <xref linkend="GConf"/>,
    <xref linkend="gnome-doc-utils"/>,
    <xref linkend="guile"/>,
    <xref linkend="libcanberra"/>,
    <xref linkend="librsvg"/>,
    <xref linkend="pygtk"/>, and
    <xref linkend="which"/></para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended"><xref linkend="rarian"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><ulink
    url="http://www.ggzgamingzone.org/">ggz-gtk-client</ulink></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 -fg 60 games &amp;&amp;
useradd -c 'Games High Score Owner' -d /var/lib/games \
        -g games -s /bin/false -u 60 games || [ $? == 9 ] &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 \
            --disable-tests &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>

    <para>If you want to install the <application>GNOME Games</application> Extra Data package, run the following commands:</para>

<screen><userinput>tar -xvf ../gnome-games-extra-data-&gnome-games-extra-data-version;.tar.bz2 &amp;&amp;
cd gnome-games-extra-data-&gnome-games-extra-data-version; &amp;&amp;
./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) &amp;&amp;
make</userinput></screen>

    <para>Now again , 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/2001/XInclude"
    href="../../xincludes/gnome-prefix.xml"/>

    <xi:include xmlns:xi="http://www.w3.org/2001/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>

    <para><parameter>--disable-tests</parameter>: Remove this parameter if you
    have <application>Check</application> installed and you wish to build the
    test apps.</para>

    <para><option>--disable-scrollkeeper</option>: Use this parameter if you
    wish to disable the updates to the scrollkeeper database.</para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>glchess, glines, gnect, gnibbles, gnobots2, gnome-gnuchess,
        gnome-sudoku, gnomine, gnotravex, gnotski, gtali, iagno, lightsoff,
        mahjongg, quadrapassel, sol, swell-foop, and ar-cards-renderer</seg>
        <seg>libgames-support-gi.{so,a}</seg>
        <seg>/usr/lib/python&python2-majorver;/site-packages/{glchess/{chess/fics,
        ggz,gtkui,scene/{cairo,opengl},ui},gnome_sudoku/gtk_goodies},
        <envar>$GNOME_PREFIX</envar>/{lib/gnome-games,share/{glchess/textures,
        gnome-games-common/cards,gnome-games/{aisleriot/games,glines/pixmaps,
        gnect/pixmaps,gnibbles/{games,pixmaps},gnobots2/{games,pixmaps,themes},
        gnomine/pixmaps,gnotski/pixmaps,gtali/pixmaps,iagno/pixmaps,
        icons/hicolor/{16x16/actions,22x22/actions,24x24/actions,32x32/actions,
        48x48/actions,scalable/actions},lightsoff/themes/{tango,up},
        mahjongg/{games,pixmaps},pixmaps,quadrapassel/pixmaps,sounds,
        swell-foop/themes/{tango,test}},gnome-sudoku/{images,puzzles},
        gnome/help/{aisleriot/*,glchess/*,glines/*,gnect/*,gnibbles/*,
        gnobots2/*,gnome-sudoku/*,gnomine/*,gnotravex/*,gnotski/*,gtali/*,
        iagno/*,lightsoff/*,mahjongg/*,quadrapassel/*,swell-foop/*},
        omf/{aisleriot,glchess,glines,gnect,gnibbles,gnobots2,gnome-sudoku,
        gnomine,gnotski,gtali,iagno,lightsoff,mahjongg,quadrapassel,swell-foop}}},
        /var/lib/games</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="glchess">
        <term><command>glchess</command></term>
        <listitem>
          <para>is a chess game which supports several chess engines.</para>
          <indexterm zone="gnome-games glchess">
            <primary sortas="b-glchess">glchess</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="glines">
        <term><command>glines</command></term>
        <listitem>
          <para>is a game which involves moving balls around the grid and try
          and form lines of the same colour to make them disappear.</para>
          <indexterm zone="gnome-games glines">
            <primary sortas="b-glines">glines</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gnect">
        <term><command>gnect</command></term>
        <listitem>
          <para>is a classic game where each player tries to make a line of four
          disks before their opponent.</para>
          <indexterm zone="gnome-games gnect">
            <primary sortas="b-gnect">gnect</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gnibbles">
        <term><command>gnibbles</command></term>
        <listitem>
          <para>is a "worm" game. You pilot a worm around a maze trying to
          collect diamonds. With each diamond your worm grows and navigation
          becomes ever more difficult.</para>
          <indexterm zone="gnome-games gnibbles">
            <primary sortas="b-gnibbles">gnibbles</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gnobots2">
        <term><command>gnobots2</command></term>
        <listitem>
          <para>is a classic BSD robots game where you have to avoid a hoard of
          robots who are trying to kill you.</para>
          <indexterm zone="gnome-games gnobots2">
            <primary sortas="b-gnobots2">gnobots2</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gnome-gnuchess">
        <term><command>gnome-gnuchess</command></term>
        <listitem>
          <para>is a chess game which supports several chess engines.</para>
          <indexterm zone="gnome-games gnome-gnuchess">
            <primary sortas="b-gnome-gnuchess">gnome-gnuchess</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gnome-sudoku">
        <term><command>gnome-sudoku</command></term>
        <listitem>
          <para>is a logic game with a Japanese name that has recently exploded
          in popularity.</para>
          <indexterm zone="gnome-games gnome-sudoku">
            <primary sortas="b-gnome-sudoku">gnome-sudoku</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gnomine">
        <term><command>gnomine</command></term>
        <listitem>
          <para>is a game where you clear mines from a board using hints from
          squares you have already uncovered.</para>
          <indexterm zone="gnome-games gnomine">
            <primary sortas="b-gnomine">gnomine</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gnotravex">
        <term><command>gnotravex</command></term>
        <listitem>
          <para>is a puzzle game where you have to match a grid of tiles
          together.</para>
          <indexterm zone="gnome-games gnotravex">
            <primary sortas="b-gnotravex">gnotravex</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gnotski">
        <term><command>gnotski</command></term>
        <listitem>
          <para>is a series of sliding block puzzles.</para>
          <indexterm zone="gnome-games gnotski">
            <primary sortas="b-gnotski">gnotski</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gtali">
        <term><command>gtali</command></term>
        <listitem>
          <para>is an ancient Roman game.</para>
          <indexterm zone="gnome-games gtali">
            <primary sortas="b-gtali">gtali</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="iagno">
        <term><command>iagno</command></term>
        <listitem>
          <para>is a game where the goal is to control all the disks on the
          board by trapping your opponents disks between two of yours.</para>
          <indexterm zone="gnome-games iagno">
            <primary sortas="b-iagno">iagno</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lightsoff">
        <term><command>lightsoff</command></term>
        <listitem>
          <para>is a puzzle game, where the objective is to turn off all of the
          tiles on the board. Each click toggles the state of the clicked tile
          and its non-diagonal neighbors.</para>
          <indexterm zone="gnome-games lightsoff">
            <primary sortas="b-lightsoff">lightsoff</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mahjongg">
        <term><command>mahjongg</command></term>
        <listitem>
          <para>is a tile-based solitaire game with an oriental flavor. Remove
          tiles in matching pairs from a pile to try and dismantle it.</para>
          <indexterm zone="gnome-games mahjongg">
            <primary sortas="b-mahjongg">mahjongg</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="quadrapassel">
        <term><command>quadrapassel</command></term>
        <listitem>
          <para>is a Russian game of fitting falling geometric shapes.</para>
          <indexterm zone="gnome-games quadrapassel">
            <primary sortas="b-quadrapassel">quadrapassel</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <!-- conflicts with aisleriot <varlistentry id="sol">
        <term><command>sol</command></term>
        <listitem>
          <para>is a compilation of seventy different solitaire card
          games.</para>
          <indexterm zone="gnome-games sol">
            <primary sortas="b-sol">sol</primary>
          </indexterm>
        </listitem>
      </varlistentry>-->

      <varlistentry id="swell-foop">
        <term><command>swell-foop</command></term>
        <listitem>
          <para>is a puzzle game, of which the objective is to clear the window
          of as many pieces as possible by clicking on groups of the same
          colored pieces. That group will vanish and the pieces on top will fall
          until there are none left or no more color groups.</para>
          <indexterm zone="gnome-games swell-foop">
            <primary sortas="b-swell-foop">swell-foop</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>