<?xml version="1.0" encoding="utf-8"?>
<!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_GB">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
 <articleinfo>
  <title><application>Tetravex</application> Manual</title>

    <abstract role="description">
      <para><application>Tetravex</application> 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><copyright><year>2009</year><holder>Jen Ockwell (jenfraggleubuntu@gmail.com)</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> 

     <legalnotice id="legalnotice">
	<para>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation Licence (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this <ulink type="help" url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS distributed with this manual.</para>
         <para>This manual is part of a collection of GNOME manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the licence to the manual, as described in section 6 of the licence.</para>

	<para>Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and the members of the GNOME Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.</para>

	<para>DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENCE WITH THE FURTHER UNDERSTANDING THAT: <orderedlist>
		<listitem>
		  <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENCE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND</para>
		</listitem>
		<listitem>
		  <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.</para>
		</listitem>
	  </orderedlist></para>
  </legalnotice>


   <!-- 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>

    <revhistory>
      <revision> 
	<revnumber>Tetravex Manual V2.10</revnumber> 
	<date>June 2005</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 2.12 of Tetravex.</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 <application>Tetravex</application> 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 gnome-games package, which is part of the GNOME desktop environment. This document describes version 2.10 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><guimenu>File</guimenu><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 and 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><guimenu>Move</guimenu><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>Customisation</title> 
  <para>Under the <guimenu>Settings</guimenu> 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:gnome-feedback" 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>Licence</title> 
  <para>This program is free software; you can redistribute it and/or modify it under the terms of the <citetitle>GNU General Public Licence</citetitle> as published by the Free Software Foundation; either version 2 of the Licence, 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 Licence</citetitle> for more details.</para>
  <para>A copy of the <citetitle>GNU General Public Licence</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 Licence</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>
