<?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 NETWORKGAMES SYSTEM "network-games.xml">
<!ENTITY appversion "2.20">
<!ENTITY manrevision "2.9">
<!ENTITY date "February 2008">
<!ENTITY app "<application>Iagno</application>">
<!ENTITY appname "Iagno">
<!ENTITY version "2.9">
]>
<!-- 
      (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>Iagno</application> Manual</title>

    <abstract role="description">
      <para><application>Iagno</application> is the two player strategy game of Othello, which is also known as Reversi and is similar to Go. The pieces are tiles that are black on one side and white on the other and the objective is for the player to flip his or her opponent's tiles to his or her colour, while keeping the opponent from doing the same. Once the board is filled with tiles, the winner is the player with the most of his or her colour tiles on the board.</para>
    </abstract>

 <copyright>
  <year>2000</year>
  <holder>Eric Baudais</holder>
 </copyright><copyright><year>2009</year><holder>Philip Withnall (philip@tecnocode.co.uk)</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 AUTHORISED 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>Eric</firstname> 
	<surname>Baudais</surname> 
	<affiliation> 
	  <address> <email>baudais@okstate.edu</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>Iagno Manual V2.9</revnumber> 
    <date>February 2008</date> 
    <revdescription> 
      <para role="author">Claude Paroz <email>claude@2xlibre.net</email></para>
      <para role="publisher">GNOME Documentation Project</para>
    </revdescription> 
  </revision>
  <revision> 
    <revnumber>Iagno Manual V2.8</revnumber> 
    <date>September 2004</date> 
    <revdescription> 
      <para role="author">Eric Baudais <email>baudais@okstate.edu</email></para>
      <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
  </revision>
  <revision>
   <revnumber>0.1</revnumber>
   <date>4 February 2000</date>
   <authorinitials>EB</authorinitials>
   <revremark>First draft completed.</revremark>
  </revision>

  <revision>
   <revnumber>0.2</revnumber>
   <date>5 February 2000</date>
   <authorinitials>EB</authorinitials>
   <revremark>Added a footnote to why section. Fixed some typos.</revremark>
  </revision>

  <revision>
   <revnumber>0.3</revnumber>
   <date>7 February 2000</date>
   <authorinitials>EB</authorinitials>
   <revremark>Made the doc compliant with the GDP template. Clarified the playing section.</revremark>
  </revision>

  <revision>
   <revnumber>1.0</revnumber>
   <date>7 April 2000</date>
   <authorinitials>EB</authorinitials>
   <revremark>Licensed the Iagno Manual under the FDL. Updated the screenshots to the GDP standard theme, MicroGUI.</revremark>
  </revision>
 </revhistory>

    <releaseinfo>This manual describes version 2.20 of Iagno.</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>Iagno</application> 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>Iagno</primary> 
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<sect1 id="intro">
 <title>Introduction</title>
 <sect2 id="what">
  <title>What is Iagno?</title>
  
  <para><application>Iagno</application> is a computer version of the game Reversi, more popularly called Othello. <application>Iagno</application> is a two player strategy game similar to Go. The board is 8-by-8 with tiles that are black on one side and white on the other side. The object of <application>Iagno</application> is to flip as many of your opponent's tiles to your colour as possible without your opponent flipping your tiles. This is done by trapping your opponent's tiles between two tiles of your own colour.</para>

  <para><application>Iagno</application> also features <link linkend="network-games">multiplayer</link> support with two human players in hotseat or network mode.</para>

  <para>To run <application>Iagno</application>, select <guimenuitem>Iagno</guimenuitem> from the <guisubmenu>Games</guisubmenu> submenu of the <guimenu>Main Menu</guimenu>, or type <command>iagno</command> on the command line.</para>
 </sect2>

 <sect2 id="why">
  <title>Why is Othello called Iagno?</title>
  <para>You're probably wondering why this game is called <application>Iagno</application> instead of Othello or even gnothello. The answer is complicated, and involves things like trademarks and lawyers and whatnot. Instead of leaving it at that, I'll tell you a long and complicated lie about the origin of the name <application>Iagno</application>.</para>
  <para>On a stormy night, like those depicted so much in England, a lonely programmer was sitting in front of his computer screen. Ian had finished his masterpiece in gaming. It was a fully interactive game of Othello and he decided to play a pun with the name and called it gnothello for the game was written using GNOME.</para>
  <para>Later his buddies came over and like all programmers he showed off his masterpiece. They all laughed in his face and told Ian that his game was worthless and a pitiful attempt to be a true hacker. After Ian kicked them out he decided to rename his program Iago <footnote>
   <para>Iago is Othello's nemesis in the play <citetitle>Othello</citetitle> by William Shakespeare.</para>
  </footnote> for the evil which had manifested itself due to his game. Yet it still didn't sound right. All GNOME programs have some part of GNOME in it, Ian thought. After much thought he decided on the name we have come to cherish, <application>Iagno</application>.</para>
 </sect2>
</sect1>

<sect1 id="playing">
 <title>Playing Iagno</title>
 <para>The board starts with four tiles arranged in a box on the middle of the board. The tiles have the same colour at each corner, as shown in <xref linkend="start-shot"/>.</para>
 
 <figure id="start-shot">
  <title>Starting Position</title>
  <screenshot>
    <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/START.png" format="PNG" srccredit="Eric Baudais"/>
   </imageobject>
    <textobject> 
      <phrase>Screenshot of the starting position.</phrase> 
    </textobject> 
  </mediaobject>
  </screenshot>
 </figure>

 <para>Black goes first and places a tile on the board such that it traps white's tiles between two of black's tiles. When black places a tile on the board all of white's tiles between black's newly placed tile and another black tile, in a horizontal, vertical, or diagonal row, are flipped over and become black, as shown in <xref linkend="first-shot"/>.</para>

 <figure id="first-shot">
  <title>First Move</title>
  <screenshot>
    <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/FIRST.png" format="PNG" srccredit="Eric Baudais"/>
   </imageobject>
    <textobject> 
      <phrase>Screenshot of the first move.</phrase> 
    </textobject> 
  </mediaobject>
  </screenshot>
 </figure>

 <para>When there is tile trapped between two tiles, of an identical colour in the same row, the player captures tiles until another tile of the player's colour is encountered, as shown in <xref linkend="block-shot"/>. The player can only take tiles that are a direct result of the placing a tile on the board. Once a tile is placed on the board the player cannot remove it and place the tile somewhere else. If a player cannot move they forfeit their turn. The game ends when it is no longer possible for either player to move. <figure id="block-shot">
  <title>White cannot capture the black tile in the centre of the middle column because there are white tiles blocking the ends of that column. If it were black's turn instead, black could place a tile at the top of the column but would only flip the first of the two white tiles.</title>
  <screenshot>
    <mediaobject> 
    <imageobject>
  <imagedata format="PNG" fileref="figures/BLOCK.png" srccredit="Eric Baudais"/>
   </imageobject>
    <textobject> 
      <phrase>Screenshot of black blocking.</phrase> 
    </textobject> 
  </mediaobject>
  </screenshot>
 </figure></para>

</sect1>

<sect1 id="settings">
 <title>Game Settings</title>

 <sect2 id="player">
  <title>Player Colour and Difficulty</title>
 
  <para>When you start <application>Iagno</application> the human player plays black and the computer player plays white with the first level of difficulty. Using the <guimenuitem>Game</guimenuitem> tab in the <guisubmenu>Preferences</guisubmenu> dialogue you can set the type of player for each colour. Human is of course you, level one is the easiest computer player and level three is the hardest. You can set both to human to play against a friend or set both to computer to watch the computer play itself.</para>
 </sect2>

 <sect2 id="quick-moves">
  <title>Quick Moves Option</title>

  <para>This option is in the <guimenu>Settings</guimenu> menu. Then go to the <guisubmenu>Preferences</guisubmenu> submenu in the <guimenuitem>Game </guimenuitem> tab and it is initially off. When enabled this option makes the computer player place its tiles faster.</para>

  <note>
   <title>Note:</title>
   <para>Enabling this option does not force the computer player to move and does not reduce the level of difficulty.</para>
  </note>
 </sect2>
 
 <sect2 id="enable-sound">
  <title>Enable/Disable Sound</title>

  <para>The last option of the <guimenuitem>Game</guimenuitem> tab in the <guilabel>Preferences</guilabel> dialogue allows you to enable or disable all sounds when playing in <application>Iagno</application>.</para>

  <figure id="player-shot">
   <title>The <guimenu>Preferences</guimenu> menu with the <guilabel>Game</guilabel> tab highlighted.</title>
   <screenshot>
    <mediaobject> 
    <imageobject>
  <imagedata format="PNG" fileref="figures/PLAYER.png" srccredit="Eric Baudais"/>
   </imageobject>
    <textobject> 
      <phrase>Screenshot of the game settings.</phrase> 
    </textobject> 
  </mediaobject>
   </screenshot>
  </figure>

 </sect2>

</sect1>

<sect1 id="animations">
 <title>Appearance</title>

 <para>All the animation options are in the <menuchoice><guimenu>Settings</guimenu><guisubmenu>Preferences </guisubmenu></menuchoice> menus with the <guilabel>Appearance</guilabel> tab highlighted.</para>

 <sect2 id="animation-amount">
  <title>Animation</title>

  <para>This option controls the amount of animation present when each tile is flipped, using radio buttons. Selecting the option <guibutton>none </guibutton> will cause the tiles to change colour instantaneously. Selecting the <guibutton>option</guibutton> partial will cause the animation to flip the tiles slowly. Selecting the <guibutton>complete </guibutton> option will cause the tiles to flip slowly and smoothly.</para>

 </sect2>

 <sect2 id="stagger-flips">
  <title>Stagger Flips</title>
  
  <para>This option causes captured tiles along a row, column, or diagonal to flip one after another, like dominoes; instead of all flipping simultaneously. It has no effect on game play, but looks nice.</para>

 </sect2>

 <sect2 id="grid">
  <title>Show Grid</title>

  <para>This option will display a grid on top of the playing surface. The grid is useful to display because it shows the player exactly where they are placing each tile.</para>

  <tip>
   <title>Tip:</title>
   <para>This option should be enabled for beginning players to see the gameplay more clearly.</para>
  </tip>

 </sect2>

 <sect2 id="flip-final">
  <title>Flip Final Results</title>

  <para>This option moves all the black tiles to the top of the board and all the white tiles to the bottom of the board at the end of the game. This allows you to visually see the outcome of the game.</para>

  <note>
   <title>Note:</title>
   <para>This option does not affect the outcome of the game in any way.</para>
  </note>

 </sect2>

 <sect2 id="tile-set">
  <title>Tile Set</title>
  <para>This option lets you choose the type of board and tiles which are displayed. If you want to make your own tile sets use the classic tile set as a template and change the texture and colors for different effects. When you make a new tile set that works with <application>Iagno</application> send it to Ian Peters <email>itp@gnu.org</email> and he will include it with the next distribution.</para>

  <important>
   <title>Important:</title>
   <para>There are two tile sets which look the same, but have different animations — woodtrim and classic.</para>
  </important>

  <figure id="animation-shot">
   <title>The <guimenu>Preferences</guimenu> menu with the <guilabel>Appearance</guilabel> tab highlighted.</title>
   <screenshot>
    <mediaobject> 
    <imageobject>
  <imagedata format="PNG" fileref="figures/ANIMATION.png" srccredit="Eric Baudais"/>
    </imageobject>
    <textobject> 
      <phrase>Screenshot of the animation settings.</phrase> 
    </textobject> 
  </mediaobject>
   </screenshot>
  </figure>

 </sect2>

</sect1>

<!-- ============= Network games  ===============================================
 This doc is common to gnome-games. The file is pulled in from gnibbles directory
 as a SVN symlink, and included here. Therefore translators only have to translate 
 the network stuff once, instead of one time for each game. 
 ================================ -->

  <!-- ============= Network Games Documentation ============================= 
   This documentation is written so that is can be reused for all the 
   gnome-games which have network multiplayer support. Therefore no direct
   references to a specific game should be made. Further, this file is currently
   included in the various games as a SVN symlink. The figures can also
   be included as SVN symlinks to avoid duplication of the same images.
  -->

 <sect1 id="network-games">
  <title>Network Games</title>
  <para><application>Iagno</application> supports networked multiplayer games, provided by <ulink type="http" url="http://www.ggzgamingzone.org">GGZ Gaming Zone</ulink>. By connecting to an <application>Iagno</application> server on the Internet, you can challenge other players in multiplayer games. For news, updates and a list of servers to connect to, see the <ulink type="http" url="http://www.gnome.org/projects/gnome-games/">gnome-games website</ulink>.</para>
  <para>To start a multiplayer game of <application>Iagno</application>, select <menuchoice><guimenu>Game</guimenu><guimenuitem>Network Game</guimenuitem></menuchoice> on the <application>Iagno</application> menu.</para> 

<sect2 id="connecting">
<title>Connecting to an <application>Iagno</application> network server</title>
<para>The <application>Iagno</application> connection dialogue is shown initially when starting a new network game. This dialogue allows you to select a server to which to connect, and the username that you will have while connected to that server.</para>

<para>It is possible to connect to a server with either a guest account or a normal registered account. Guest accounts allow you to log in anonymously, while a normal login account allows you to reserve your own username which is protected by the password that you choose.</para>

<para>The <guilabel>Guest Login</guilabel> option should be selected if you want an anonymous guest account. If you want to create a new login account, then select the <guilabel>First-time Login</guilabel> option, with the username, password and e-mail address of your choice. If you have already created your account, you can connect by selecting the <guilabel>Normal Login</guilabel> option, and enter the username and password that you have chosen.</para>
<para>To connect to a server, click on the <guibutton>Connect</guibutton> button.</para>
<figure id="connect">
<title>The <application>Iagno</application> network connection dialogue.</title>
<screenshot>
  <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/connect.png" format="PNG" srccredit="Andreas Røsdal"/>
    </imageobject>
    <textobject> 
      <phrase>The <application>Iagno</application> network connection dialogue.</phrase> 
    </textobject> 
  </mediaobject>
</screenshot>
</figure>
</sect2>

<sect2 id="joining">
<title>Joining a game room</title>
<para>Once you have successfully connected to a server, you can choose which game room to join. To play a multiplayer game of <application>Iagno</application>, select the <application>Iagno</application> room. If you want to host your own game, then click on the <guibutton>Launch</guibutton> button. This creates a new table where other players can participate in a game against you. If there are any other games already started, then you can double-click on an existing game table to join it. The list of game tables on the right shows you the number of available seats, which means the number of players that can join the game table.</para>
<figure id="tables">
<title>This <application>Iagno</application> network dialogue allows you to join a game room to find other players.</title>
<screenshot>
  <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/tables.png" format="PNG" srccredit="Andreas Røsdal"/>
    </imageobject>
    <textobject> 
      <phrase>This <application>Iagno</application> network dialogue allows you to join a game room to find other players.</phrase> 
    </textobject> 
  </mediaobject>
</screenshot>
</figure>
<para>When creating a new table for <application>Iagno</application> games, a preferences dialogue is displayed which allows you to customise the game, such as set the minimum number of players for the game. Once the total number of seats have been taken, no more players are allowed to join that game table.</para>
<para>It is possible to chat with other players in network games. Ask for advice or help playing the games, but please be polite with other players.</para>
</sect2>

<sect2 id="pregame">
<title>Waiting for other players to join the game</title>
<para>Once you have successfully joined a game table, then you have to wait until enough players have joined the table. The <guimenuitem>Players List</guimenuitem> menu item allows you to see a list of the players who have joined the game. The game will begin immediately when the total number of players in the the game have been reached.</para>
</sect2>

<sect2 id="playing-multiplayer">
<title>Playing multiplayer <application>Iagno</application> games</title>
<para>Multiplayer <application>Iagno</application> games have pretty much the same rules as normal <application>Iagno</application> games, except that you are now playing against human players. This means that other strategies might possibly be better than when playing against AI players.</para>
<para>Once a player has won, the game ends and you can return to the initial network game screen. Then you can play yet another game of addictive <application>Iagno</application> multiplayer!</para>
</sect2>

</sect1>




<sect1 id="bugs">
 <title>Known Bugs and Limitations</title>

 <itemizedlist mark="opencircle">
    <listitem>
     <para>The computer player for <application>Iagno</application> is easy to beat.</para>
    </listitem>
 </itemizedlist>

</sect1>

<sect1 id="credits">
 <title>Authors</title>
  <para><application>Iagno</application> was written by Ian Peters (<email>itp@gnu.org</email>). This manual was written by Eric Baudais (<email>baudais@okstate.edu</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>


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

 <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 type="http" url="http://www.fsf.org">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>
