<?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.0">
  <!ENTITY manrevision "2.0">
  <!ENTITY date "March 2002">
  <!ENTITY app "<application>GNOME Stones</application>">
  <!ENTITY appname "GNOME Stones">
  <!ENTITY version "1.2.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>rob@funky-penguin.co.uk</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>
       There are two basic game types:

     <variablelist>
      <varlistentry>
       <term>Gnomekoban</term> 
       <listitem> 
        <para> 
          This is the block sliding game. See 
          <link linkend="gnomekoban">Gnomekoban</link>
        </para> 
       </listitem>
      </varlistentry> 

      <varlistentry>
       <term>Default caves</term> 
       <listitem> 
        <para>
          This is the escape from cave game type. See 
          <link linkend="cavegame">Escape from cave game</link> 
        </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 the <link linkend="prefs"><interface>Preferences
      Dialog</interface></link> help.
    </para>

   </sect3>

   <sect3 id="scores">
   <title>High scores</title>
   <para>
   To start playing the game to view your high scores for the game do: 
       <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> 
     This game has simple gravity physics, if you dig underneath a rock (or 
     diamond) then the object will fall down and if a rock squash you. But if 
     you do not linger underneath the rock then you are 
     unlikely to be squashed, but sometimes gravity can cause a chain 
     reaction in which a large number of rocks fall down and squash you. 
     If you get squashed you die and have to begin the level at the 
     beginning again.  You can push rocks out of the way if there is room 
     on the other side of them. To push a rock out of the way just walk 
     up to the rock and continue moving in the desired direction. The rock 
     will move if possible. If two rocks are next to each other horizontally 
     you can't move either of them. You are up against the clock in this 
     game. You can only find the exit (blinking square) after you have collecte     d enough diamonds, the number of diamonds you have not yet collected is sh     own in the statusbar as Diamond: (number of diamonds left)
   </para>
   <para>On some levels there are monsters that can freely move about the leve.         If these make contact with you, you die and you must restart.
   </para> 
   <sect3 id="playingcavegame">
    <title>Playing The Cave Game</title>
    <para>
      This is the default game, to choose this game look at the 
      <link linkend="prefs">Customization Section</link> for
      details.
    </para>
   </sect3> 
  </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 slided all your blocks into the required 
     positions you move onto the next level. You are up against the clock 
     in this game. This game type is based on xsokoban and sokoban
   </para>
   <sect3 id="playinggnomekoban">
    <title>Playing Gnomekoban</title>
    <para>
      This is <emphasis>not</emphasis> the default game, so you must 
      choose this game, look at the <link linkend="prefs">Customization 
      Section</link> for details.
    </para>
   </sect3> 
  </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, shown 
    in <xref linkend="preferences-fig"/>.
  </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. The most common game types are: 
   <variablelist>
    <varlistentry> 
     <term>Gnomekoban</term> 
     <listitem> 
      <para> 
        This is the block sliding game. See 
        <link linkend="gnomekoban">Gnomekoban</link>
      </para> 
     </listitem>
    </varlistentry> 
    <varlistentry>
     <term>Default caves</term> 
     <listitem> 
      <para> 
        This is the escape from cave game type. See 
        <link linkend="cavegame">Escape from cave game</link> 
      </para> 
     </listitem> 
    </varlistentry>
   </variablelist> 
  </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> 
        Here you can 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 switch 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 properties in the <guilabel>Sound</guilabel> tab are:
   <variablelist> 
    <varlistentry> 
     <term>Not implemented yet!</term>
     <listitem> 
      <para> 
        Here you will able to configure the sounds for
        <application>GNOME Stones</application> when implemented. 
      </para> 
     </listitem> 
    </varlistentry> 
   </variablelist> 
  </para>
  <para>
    After you have made all the changes you want, click on
    <guibutton>OK</guibutton> to apply the changes and close the
    <interface>Properties</interface> dialog. To cancel the changes and
    return to previous values, click the <guibutton>Close</guibutton>
    button. You may also click <guibutton>Apply</guibutton> to apply the change    s, <emphasis>applied changes cannot be cancelled.</emphasis>
  </para>
 </sect1>

 <sect1 id="bugs">
  <title>Known Bugs and Limitations</title> 
  <para> 
    The sound section of the preferences dialog is not implemented yet.
  </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>
