<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "2.4">
  <!ENTITY manrevision "2.4">
  <!ENTITY date "March 2002">
  <!ENTITY app "<application>GNOME Stones</application>">
  <!ENTITY appname "GNOME Stones">
  <!ENTITY version "2.4.0">
]>

<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 12, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
 <articleinfo>
  <title>&app; Manual V&manrevision;</title>
  <copyright>
   <year>2000</year>
   <holder>Rob Bradford </holder>
  </copyright>

<!-- translators: uncomment this:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
<!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
    <publisher> 
      <publishername> GNOME Documentation Project </publishername> 
    </publisher> 

   &legal;
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
	any of this. -->

    <authorgroup> 
      <author> 
	<firstname>Rob</firstname> 
	<surname>Bradford</surname> 
	<affiliation> 
	  <address> <email>robster@debian.org</email> </address> 
	</affiliation> 
      </author> 
<!-- This is appropriate place for other contributors: translators,
      maintainers,  etc. Commented out by default.
       <othercredit role="translator">
	<firstname>Latin</firstname> 
	<surname>Translator 1</surname> 
	<affiliation> 
	  <orgname>Latin Translation Team</orgname> 
	  <address> <email>translator@gnome.org</email> </address> 
	</affiliation>
	<contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>
    <revhistory>
      <revision> 
	<revnumber>&appname; Manual V&manrevision;</revnumber> 
	<date>&date;</date> 
	<revdescription> 
	  <para role="author">Rob Bradford
	    <email>rob@funky-penguin.co.uk</email>
	  </para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo>This manual describes version &appversion; of &appname;.
    </releaseinfo>
    <!-- The following feedback information only applies to appliactions
    listed in bugzilla.gnome.org and bugzilla.ximian.com. For other
    applications, please provide your own feedback info or remove thsi
    section altogether -->
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the &app; application or
	this manual, follow the directions in the 
	<ulink url="ghelp:gnome-feedback"
	  type="help">GNOME Feedback Page</ulink>. 
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice>

 </articleinfo>
 
  <indexterm zone="index"> 
    <primary>GNOME Stones</primary> 
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
 <sect1 id="intro">
  <title>Introduction</title>

  <para>
    <application>GNOME Stones</application> is a simple, enjoyable
    arcade style game based on many old classics. It involves collecting
    gemstones, hence the name <application>GNOME Stones</application>. 
    While doing this, you must avoid being squashed by falling rocks.
  </para>
    
  <para> 
    To run <application>GNOME Stones</application>, select
    <menuchoice>
     <guisubmenu>Games</guisubmenu> 
     <guimenuitem>GNOME	Stones</guimenuitem> 
    </menuchoice>
    from the <guimenu>Main Menu</guimenu>, or type 
    <command>gnome-stones</command> on the command line.
  </para>

  <para>
    <application>GNOME Stones</application> is included in the
    <filename>gnome-games</filename> package, which is part of the GNOME
    desktop environment. This document describes version
    &version; of <application>GNOME Stones</application>.
  </para>
 </sect1>

 <sect1 id="usage"> 
  <title>Playing GNOME Stones</title>

  <para>
    <application>GNOME Stones</application> is a simple arcade style
     game, this section covers how to play the game.
  </para>

  <sect2 id="mainwin">
   <title>Basic usage</title>
      
   <!-- For this app, one could put "proving" or "edit" (probably even both
   of them) as sect2's seperate from the main window section. Since they
   were both so closely involved with the main window, I decided to
   have them as sect3's isntead. Judgement call. -->

   <sect3 id="background">
    <title>Background to the game</title> 
    <para>
      You play a little guy who is trapped in a cave, you must move around the
      cave tunelling through the ground looking for the exit. As you tunnel you
      have to collect the gemstones (diamonds to be precise) and avoid being
      squashed by falling rocks. In some levels, your task is to move
      strategically placed boxes into 'holes'.
    </para>
   </sect3>

   <sect3 id="playing">
    <title>Playing the game</title> 
    <para> 
      Starting <application>GNOME Stones</application> opens the 
      <interface>Main window</interface>, shown in 
      <xref linkend="mainwindow-fig"/>. The window is initially full of
      little squares.
     </para>

     <figure id="mainwindow-fig">
      <title>GNOME Stones Main Window</title> 
      <screenshot>
	 <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/main-start.png" format="PNG" srccredit="ME"/>
      </imageobject>
    <textobject> 
      <phrase>GNOME Stones Main Window.</phrase> 
    </textobject> 
  </mediaobject>
      </screenshot> 
     </figure>

     <para> 
       To start playing the game do 
       <menuchoice>
        <guisubmenu>Game</guisubmenu> 
        <guimenuitem>New Game</guimenuitem>
       </menuchoice>, the window will then change to look something
       like <xref linkend="playing-fig"/>

      <figure id="playing-fig">
       <title>A GNOME Stones Game</title> 
       <screenshot> 
        <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/main-game.png" format="PNG" srccredit="ME"/>
      </imageobject>
    <textobject> 
      <phrase>A GNOME Stones Game.</phrase> 
    </textobject> 
  </mediaobject>
       </screenshot>
      </figure>

     </para>
    </sect3>

    <sect3 id="gametypes">
     <title>Game Types</title>
     <para>
       A set of levels to play can be selected from the
       <guimenuitem>Game</guimenuitem> tab in the <link
       linkend="prefs"><interface>Preferences</interface></link>
       dialog.  There are two basic game modes: <link
       linkend="gnomekoban">Sokoban</link>, the block sliding game, or
       the <link linkend="cavegame">Cave Escape</link> game. Each
       level set is played in one of these modes.

     <variablelist>
      <varlistentry>
       <term>Default caves</term> 
       <listitem> 
        <para>
          This is the basic <link linkend="cavegame">escape from the
          cave</link> game type. There are only a few levels here at
          the moment.
        </para>
       </listitem> 
      </varlistentry>
      <varlistentry>
       <term>Tutorial caves</term> 
       <listitem> 
        <para>
          This is another <link linkend="cavegame">cave escape
          </link> level set. These are designed to get you used to
          playing the game and let you discover the various features
          of the caves.
        </para>
       </listitem> 
      </varlistentry>
      <varlistentry>
       <term>Gnomekoban</term> 
       <listitem> 
        <para> 
          This is a set of <link linkend="gnomekoban">sokoban</link>
       block sliding games. The first level is trivial to let you get
       the hang of the puzzle, the remainder become difficult quickly.
        </para> 
       </listitem>
      </varlistentry> 
      <varlistentry>
       <term>Original Atari caves</term> 
       <listitem> 
        <para>
         Yet another set of <link linkend="cavegame">cave escape
          </link> levels. These ones resemble those found in an old
          Atari video game.
        </para>
       </listitem> 
      </varlistentry>
     </variablelist>
	
    </para>
   </sect3>
	
   <sect3 id="controls"> 
    <title>Controls</title> 
    <para> 
      The controls for the game are the up, down, left, and right arrow keys or      you can control your character with a joystick. To setup a
      joystick see the <link linkend="prefs"><interface>Preferences
      dialog</interface></link> documentation.
    </para>

   </sect3>

   <sect3 id="scores">
   <title>High scores</title>
   <para>
   To view your high scores for the game select 
       <menuchoice>
        <guisubmenu>Game</guisubmenu> 
        <guimenuitem>Scores</guimenuitem>
       </menuchoice>
   </para>
   </sect3>

  </sect2>
 </sect1>

 <sect1 id="gamescenarios"> 
  <title>Game scenarios</title> 

  <sect2 id="cavegame"> 
   <title>Cave game</title> 
   <para> 
     You are in a cave full of rocks, diamonds and dirt. Your goal is
   to dig through the dirt and collect enough diamonds to open a
   hidden exit from the cave. In your way are the boulders. You can
   push a single boulder, if there is nothing behind it. You can also
   dig under a boulder, but beware, if there is nothing to support a
   boulder it will fall and could squash you. Being squashed by a
   boulder is invariably fatal..
   </para>
   <para>
   To dig through the dirt, just move through it. Similarly if you
   want to push a rock move up to it and keep moving against it. To
   pick up a diamond move over it. If you want to be killed by one of
   the creatures that also roam the caves, just run into it (or let it
   run into you). You get the idea.
</para>
      <para>
   Once you have collected enough diamonds there will be a flash and a
   flashing doorway will appear somewhere on the level, find it and
   get out of the cave before time runs out. The quicker you finish
   the level, the higher your score.
   </para>
   <para>
   It is obviously a good idea not to die. You only have a small
   number of lives and once you use them all up the game is
   over. Also, if you die you must restart the level. There are many
   ways to die, the most common one is to be under a falling object
   when it lands. You will undoubtedly discover the others. Be warned
   that the using the <guimenuitem>Restart level</guimenuitem> menu
   item costs you a life.
   </para>
  </sect2> 

  <sect2 id="gnomekoban">
   <title>Gnomekoban</title> 

   <para> 
   In this version of the game your task is to move strategically
   placed crates or blocks into holes (hollow red squares), you move
   the crates in a similar way to rocks except there is no gravity
   acting in this environment. Once you have slid all your blocks into
   the required positions you move onto the next level. Nothing will
   fall on you or try and hunt you down in this game, but you are up
   against the clock in this game.
   </para>

  </sect2>
 </sect1>
	
 <sect1 id="prefs"> 
  <title>Customization</title> 
  <para> 
    To change the application settings, select 
    <menuchoice>
     <guimenu>Settings</guimenu> 
     <guimenuitem>Preferences...</guimenuitem>
    </menuchoice>.  
    This opens the <interface>Preferences</interface> dialog.
  </para>

  <figure id="preferences-fig">
   <title>Preferences Dialog</title>
   <screenshot>
     <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/preferences-main.png" format="PNG" srccredit="ME"/> 
       </imageobject>
    <textobject> 
      <phrase>Preferences Dialog.</phrase> 
    </textobject> 
  </mediaobject>
   </screenshot>
  </figure>

  <para> 
    The <guilabel>Game</guilabel> tab allows you choose which type of
    game you wish to play. These have been described in the <link linkend="gametypes">Game
    Types</link> section.
  </para>

  <para> 
    The properties in the <guilabel>Joystick</guilabel> (shown in <xref linkend="joystick-preferences-fig"/>) preferences tab are:
  </para>
   <variablelist>
    <varlistentry> 
     <term>Joystick device</term>
     <listitem>
      <para> 
        Choose your joystick device, if you have
        one. If you do not have a joystick or do not wish to use one,
        select disable (default).
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term>Digital joystick emulation</term> 
     <listitem> 
      <para> 
        You can configure the switching level of your digital joystick here 
      </para>
     </listitem> 
    </varlistentry>
   </variablelist>
  
  <figure id="joystick-preferences-fig">
   <title>Joystick Preferences</title>
   <screenshot>
    <screeninfo>Joystick Preferences</screeninfo> 
     <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/preferences-joystick.png" format="PNG" srccredit="ME"/> 
       </imageobject>
    <textobject> 
      <phrase>Joystick Preferences.</phrase> 
    </textobject> 
  </mediaobject>
   </screenshot>
  </figure>
  <para>
    The <guilabel>Sound</guilabel> tab contains only one option: to
   enable or disable sound in the game.
  </para>
  <para>
   The <guilabel>Misc.</guilabel> tab also has a single option: the
   style of scrolling you would like to use. 
   <variablelist>
   <varlistentry>
   <listitem><para>
   <guimenuitem>Atari like scrolling</guimenuitem>&mdash; only
   scroll the screen when near the edge.
   </para></listitem>
   <listitem><para>
   <guimenuitem>Smooth scrolling</guimenuitem>&mdash; smoothly
   scroll the screen to keep the player in the center. This may make
   you sea-sick.
   </para></listitem>
   <listitem><para>
   <guimenuitem>Atari in the center</guimenuitem>&mdash; always keep
   the player in the center of the screen.
   </para></listitem>
   </varlistentry>
   </variablelist>

  </para>
  <para>
   All preferences are applied and saved instantly and
   automatically. Be warned that if you change the game type, your
   current game will end.
  </para>
 </sect1>

 <sect1 id="bugs">
  <title>Known Bugs and Limitations</title> 
  <para> 
   Nothing we'd like to talk about. You can report any bugs you find
  using the <command>Bug Reporting Tool</command> or via the <ulink
  url="http://bugs.gnome.org" type="http">GNOME bug tracking
  database</ulink>.
  </para> 
 </sect1>

 <sect1 id="authors"> 
  <title>Authors</title> 
  <para> 
    <application>GNOME Stones</application> was written by Carsten Schaar
    (<email>nhadcasc@fs-maphy.uni-hannover.de</email>). <application>GNOME
    Stones</application> is part of the gnome-games package which is a core
    GNOME package, please visit the 
    <ulink url="http://www.gnome.org" type="http">GNOME Web page</ulink> 
     for details. Please send all comments, suggestions, and bug reports to the   
    <ulink url="http://bugs.gnome.org" type="http">GNOME bug tracking
    database</ulink>. 
    (Instructions for submitting bug reports can be found
    <ulink url="http://bugs.gnome.org/Reporting.html" type="http">
    on-line</ulink>.) You can also use <application>Bug Report
    Tool</application> (<command>bug-buddy</command>), available in the
    <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
    Menu</guimenu>, for submitting bug reports.
  </para>

  <para> 
    This manual was written by Rob Bradford
    (<email>rob@funky-penguin.co.uk</email>). Please send all comments and
    suggestions regarding this manual to the <ulink
    url="http://developer.gnome.org/projects/gdp" type="http">GNOME
    Documentation Project</ulink> by sending an email to
    <email>docs@gnome.org</email>. You can also add your comments online by
    using the <ulink url="http://developer.gnome.org/projects/gdp/doctable/"
    type="http">GNOME Documentation Status Table</ulink>.
  </para>

  <!-- For translations: uncomment this:
  <para>
    Latin translation was done by ME (<email>MYNAME@MYADDRESS</email>). 
    Please send all comments and suggestions regarding this translation to
    SOMEWHERE.
  </para>
   -->

 </sect1>

 <sect1 id="license"> 
  <title>License</title> 
  <para> 
    This program is free software; you can redistribute it and/or modify it 
    under the terms of the <citetitle>GNU General Public License</citetitle> 
    as published by the Free Software Foundation; either version 2 of the 
    License, or (at your option) any later version.
  </para>
  <para>
    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    <citetitle>GNU General Public License</citetitle> for more details.
  </para>
  <para>
    A copy of the <citetitle>GNU General Public License</citetitle> is
    included as an appendix to the <citetitle>GNOME Users
    Guide</citetitle>.  You may also obtain a copy of the <citetitle>GNU
    General Public License</citetitle> from the Free Software Foundation by
    visiting <ulink url="http://www.fsf.org" type="http">their Web
    site</ulink> or by writing to 
    <address>
      Free Software Foundation, Inc.  
     <street>59 Temple Place</street>
     - Suite 330 
     <city>Boston</city>, 
     <state>MA</state>
     <postcode>02111-1307</postcode> 
     <country>USA</country> 
    </address>
  </para> 
 </sect1>
</article>
