<?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 version "2.4">
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "2.12">
  <!ENTITY manrevision "2.12">
  <!ENTITY date "July 2006">
  <!ENTITY app "<application>Ataxx</application>">
  <!ENTITY appname "Ataxx">
]>
<!-- 
      (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>
  <copyright>
    <year>2006</year>
    <holder>Ryan Paul</holder>
  </copyright>
  <copyright>
   <year>2000-2002</year>
   <holder>Ximian, Inc.</holder>
  </copyright>

  <!-- translators: uncomment this:

  <copyright>
   <year>2000</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>Aaron</firstname> 
        <surname>Weber</surname> 
        <affiliation> 
          <orgname>Ximian, Inc</orgname> 
          <address> <email>aaron@helixcode.com</email> </address> 
        </affiliation> 
      </author>
      <author> 
        <firstname>Ryan</firstname> 
        <surname>Paul</surname> 
        <affiliation> 
          <orgname>GNOME Documentation Project</orgname> 
        </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">Ryan Paul
            <email>ryankpaul@gmail.com</email>
          </para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription> 
      </revision> 
      <revision> 
        <revnumber>&appname; Manual V2.12</revnumber> 
        <date>September 2004</date> 
        <revdescription> 
          <para role="author">Aaron Weber
            <email>aaron@helixcode.com</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>Ataxx</primary> 
  </indexterm>

 <!-- ============= Document Body ============================= -->

 <!-- ============= Introduction ============================== -->
 <sect1 id="intro">
  <title>Introduction</title>
  <para>
    &app; is a two-player disc-flipping game like Iagno. &app;, however, begins
    at the corners, rather than at the center of the board, and has slightly
    different rules for adding and moving discs.
  </para>
 </sect1>


 <!-- ================ Usage ================================ -->
 <!-- This section should describe basic usage of the application. -->

  <sect1 id="usage">
    <title>Playing &app;</title>
    <para>
      &app; is played on a board with 49 squares
      arranged in a grid composed of seven rows and seven columns. Players
      attempt to fill the board with as many of their own pieces as possible.
      The game ends when one player is unable to move a piece during a turn.
      &app; can be played against another person, or against a
      computer-controlled opponent. &app; can also be played by two
      computer-controlled players without user intervention.
    </para>

  <!-- ========= Basic Usage =========================== -->
  <sect2 id="mainwin">
    <title>Basic usage</title>

    <variablelist>
      <varlistentry>
        <term>To play &app;:</term>
        <listitem>
          <para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Games</guisubmenu><guimenuitem>Ataxx</guimenuitem></menuchoice> or type gataxx on the command line.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>To start a new game:</term>
        <listitem>
          <para>
            Choose <menuchoice><guimenu>Game</guimenu><guimenuitem>New Game</guimenuitem></menuchoice>.
            <!-- <shortcut><keysym>Ctrl-N</keysym></shortcut> -->
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>To undo your last move:</term>
        <listitem>
          <para>
            Choose <menuchoice><guimenu>Game</guimenu><guimenuitem>Undo Move</guimenuitem></menuchoice>.
            <!-- <shortcut><keysym>Ctrl-Z</keysym></shortcut> -->
          </para>
          <para>If you perform this action during your own turn, your opponent's last move will also be reverted.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>To quit &app;:</term>
        <listitem>
          <para>
            Choose <menuchoice><guimenu>Game</guimenu><guimenuitem>Quit</guimenuitem></menuchoice>.
            <!-- <shortcut><keysym>Ctrl-Q</keysym></shortcut> -->
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>To edit game preferences:</term>
        <listitem>
          <para>Choose <menuchoice><guimenu>Settings</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect2>


  
  <!-- ========= Rulez =========================== -->
  <sect2 id="rules"> 
    <title>Rules</title>
    <para>
      Each player controls pieces of a specific color. When an &app; game
      starts, one piece is set in each corner of the board. Each player starts
      with control of two pieces placed on opposite sides of the board. A
      player moves or adds one piece in each turn. The player that controls the
      light pieces goes first.</para>

    <para>
      To add a new piece, click a piece that you control and then click any
      adjacent square that does not already contain a piece. To move an
      existing piece, click a piece and then click on any empty square that
      is two squares away from the original position of the piece.  When you
      click on a piece,  a  transparent marker will appear in each square to
      which you can move or add a piece. <xref linkend="moves-fig" /> shows
      the available moves of a selected piece. You cannot remove a piece from
      the board, or move a piece to an occupied square.
    </para>
    
    <!-- ==== Figure ==== -->
    <figure id="moves-fig">
      <title>Available Moves</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gataxx-legalmoves" format="PNG" />
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <!-- ==== End of Figure ==== -->

    <para>
      To capture your opponent's pieces, move or add your your own pieces to
      squares that are adjacent to squares occupied by your opponent. When
      you capture a piece, its color changes to that of your own pieces, and
      it becomes yours to control.
    </para>
  </sect2>

  <!-- ========= Strategy ======================== -->
  <sect2 id="strategy">
    <title>Strategy</title>
    <para>
      To prevent your opponent from seizing control of your pieces, limit the
      number of pieces that you place around any given empty space. An L-shaped
      formation or an eight piece ring will enable the other player to take
      control of many pieces with a single move.
    </para>
  </sect2>
</sect1>

  <!-- ========= Customization =================== -->
  <sect1 id="prefs">
    <title>Customizing &app;</title>
    <para>
      To change the application settings, Choose
      <menuchoice><guimenu>Settings</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>.
      This opens the Preferences dialog.
    </para>

    <sect2 id="playerprefs">
      <title>Player Preferences</title>
      <para>Player settings can be customized with the options on the <guilabel>Players</guilabel> tab.</para>
      <variablelist>
        <varlistentry>
          <term>To allow a person to control the light pieces:</term>
          <listitem>
            <para>Select the <guilabel>Human</guilabel> option in the Light section.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>To give the computer control of the light pieces or change the difficulty level:</term>
          <listitem>
            <para>Select one of the five difficulty levels in the <guilabel>Light</guilabel> section.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>To allow a person to control the dark pieces:</term>
          <listitem>
            <para>Select the <guilabel>Human</guilabel> option in the Dark section.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>To give the computer control of the dark pieces or change the difficulty level:</term>
          <listitem>
            <para>Select one of the five difficulty levels in the <guilabel>Dark</guilabel> section.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>To make the computer controlled player move faster:</term>
          <listitem>
            <para>Select the <guilabel>Quick Moves</guilabel> checkbox.</para>
          </listitem>
        </varlistentry>
       </variablelist>
    </sect2>

    <sect2 id="appearanceprefs">
      <title>Appearance Preferences</title>
      <para>The appearance of the game can be customized with the options on the <guilabel>Appearance</guilabel> tab.</para>
      <para>
        When the <guilabel>Animation</guilabel> checkbox is selected, the pieces will visually
        change when captured. The animation is different for each tile set.
      </para>
    </sect2>
  </sect1>

 <!-- ============= Bugs ================================== -->
 <!-- This section should describe known bugs and limitations of
      the program if there are any - please be frank and list all
      problems you know of 
      
      Better to leave this out until there is something to say.  
      
 <sect1 id="bugs">
  <title>Known Bugs and Limitations</title>
  <para>
   This application has no known bugs.
  </para>
 </sect1>
-->

<!-- ============= Authors ================================ -->

 <sect1 id="authors">
  <title>Authors</title>
  <para>
   <application>Ataxx</application> was written by Chris Rogers
   (<email>gandalf@darkcorner.net</email>) and was later improved by
   Sjoerd Langkemper (<email>sjoerd-gataxx@linuxonly.nl</email>).
   This manual was written by Aaron Weber
   (<email>aaron@helixcode.com</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>


 <!-- ============= Application License ============================= -->

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




