<?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.12">
  <!ENTITY manrevision "2.10">
  <!ENTITY date "June 2005">
  <!ENTITY app "<application>Tetravex</application>">
  <!ENTITY appname "Tetravex">
  <!ENTITY version "2.10">
]>

<!-- 
      (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</title>

    <abstract role="description">
      <para>
	Tetravex is a simple puzzle game in which pieces have numbers 
	on each side. The pieces must be positioned so that the same 
	numbers touch each other, during which you are being timed. 
	The times are then stored in a system-wide scoreboard.
      </para>
    </abstract>

  <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 role="maintainer"> 
	<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>
	
	<releaseinfo revision="2.26" role="review"/>

    <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:user-guide?feedback-bugs"
	  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>Tetravex</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.
       If you have used either Hint or Solve your score will not be included 
       in the high scores table.  
     </para>
    </sect3>

  </sect2>
 </sect1>
	
 <sect1 id="prefs"> 
  <title>Customization</title> 
  <para> 
    Under the <guimenuitem>Size</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. 
  </para>
  <para>
  If the tiles
  are too small, resizing the window will change the size of the tiles.
  </para>

 </sect1>

<!-- Do not try to be funny, it will only annoy users.  
Use this section to manage user expectations if there are known problems like 
slow animation.  Better to leave this section out than say something not 
actually helpful.  

 <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>).     This manual was written by Rob Bradford
    (<email>rob@funky-penguin.co.uk</email>).
   To report a bug or make a suggestion regarding this application or
   this manual, follow the directions in this 
   <ulink url="ghelp:user-guide?feedback-bugs" type="help">document</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>
