<?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.6">
  <!ENTITY manrevision "2.6">
  <!ENTITY date "March 2002">
  <!ENTITY app "<application>GNOME Tetravex</application>">
  <!ENTITY appname "GNOME Tetravex">
  <!ENTITY version "2.6">
]>

<!-- 
      (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>2001</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 Tetravex</primary> 
  </indexterm>

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

  <para>
    <application>GNOME Tetravex</application> is a simple puzzle where
    pieces must be positioned so that the same numbers are touching each other.
    Your game is timed, these times are stored in a system-wide scoreboard.
  </para>
    
  <para> 
    To run <application>GNOME Tetravex</application>, select
    <menuchoice>
     <guisubmenu>Games</guisubmenu> 
     <guimenuitem>Gnotravex</guimenuitem> 
    </menuchoice>
    from the <guimenu>Main Menu</guimenu>, or type 
    <command>gnotravex</command> on the command line.
  </para>

  <para>
    <application>GNOME Tetravex</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 Tetravex</application>.
  </para>
 </sect1>

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

  <para>
    <application>GNOME Tetravex</application> is a simple puzzle
    game, this section covers how to play the game.
  </para>

  <sect2 id="mainwin">
   <title>Basic usage</title>
   <sect3 id="playing">
    <title>Playing the game</title> 
    <para> 
      Starting <application>GNOME Tetravex</application> opens the 
      <interface>Main window</interface>, shown in 
      <xref linkend="mainwindow-fig"/>. The window is divided into two boxes.
      The right hand side contains a box containing the pieces you have yet
      to place and the left hand box is where you arrange the pieces.
     </para>

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

     <para> 
       You can start playing the game immediately. You may restart the game by
       selecting
       <menuchoice>
	<guisubmenu>File</guisubmenu>
	<guimenuitem>New game</guimenuitem>
       </menuchoice>
	<xref linkend="playing-fig"/>
	</para>
      <figure id="playing-fig">
       <title>A GNOME Tetravex Game</title> 
       <screenshot> 
         <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/gnotravex_game.png" format="PNG" srccredit="ME"/>
  </imageobject>
    <textobject> 
      <phrase>A GNOME Tetravex Game.</phrase> 
    </textobject> 
  </mediaobject>
       </screenshot>
      </figure>
     <para>
       The tiles are divided into four, you must position them so that only
       two numbers that are the same are next to each other. The game wil not
       let you position the tiles so that different numbers are next to each
       other. You position the pieces by dragging them from their current
       position either in the right hand box or the main box to their new
       position. These moves are not permanent and can be readily reversed.
       You may also move all the pieces in the left hand box at once by using the commands:
	<menuchoice>
	 <guisubmenu>Move</guisubmenu>
         <guimenuitem>Left/Right/Up/Down</guimenuitem>
	</menuchoice>
     </para>
    </sect3>
    <sect3 id="winning">
     <title>Winning the game</title> 
     <para>
       The game is completed when you have positioned all the squares in the
       right positions. When you have completed the game you are shown your
       ranking in the high scores table (if you get a high enough score). 
     </para>
    </sect3>

  </sect2>
 </sect1>
	
 <sect1 id="prefs"> 
  <title>Customization</title> 
  <para> 
    Under the <guimenuitem>Settings</guimenuitem> menu you can change the size of the grid from two
  by two up to six by six. The default is three by three. If the tiles
  are too small, resizing the window will change the size of the tiles.
  </para>

 </sect1>

 <sect1 id="bugs">
  <title>Known Bugs and Limitations</title> 
  <para> 
    Of course not, its perfect!
  </para> 
 </sect1>

 <sect1 id="authors"> 
  <title>Authors</title> 
  <para> 
    <application>GNOME Tetravex</application> was written by Lars Rydlinge
    (<email>lars.rydlinge@hig.se</email>). <application>GNOME
    Tetravex</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>
