<?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.8">
  <!ENTITY date "September 2004">
  <!ENTITY app "<application>Five or More</application>">
  <!ENTITY appname "Five or More">
  <!ENTITY version "2.8">
]>
<!-- 
      (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
-->

<!-- This doc is based on the GDP template from GNOME 1.2
     Its syntax and DTD has been updated to validate with xmllint.
     The content needs to be updated (it basically needs to be finished)
     edited and indexed.
   -->
<!-- =============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>
	To play Five or More one must align colored pieces as the board
	gets filled with randomly placed pieces. When five or more pieces
	of the same color get lined up, they disappear. The game ends
	when the board gets filled up all the way.
    </para>
  </abstract>

  <copyright>
   <year>2000-2002</year>
   <holder>Emese Kovács</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 role="maintainer"> 
      <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>Emese</firstname> 
	<surname>Kovács</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	  <address> <email>emese@gnome.hu</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">Emese Kovács
	    <email>emese@gnome.hu</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>Five or More</primary> 
  </indexterm> 

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

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

  <para> 
   <application>Five or More</application>, is the Gnome port of the once
   popular Windows game called <application>Color Lines</application>
   The game's objective is to align as often as possible five or more objects
   of the same color and shape causing them to disappear. Play as long as possible, and
   be #1 in the High Scores.
   
  </para>

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

  <para>
   <application>Five or More</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>Five or More</application>.
  </para>

 </sect1>


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

  <sect1 id="usage">
    <title>Playing Five or More</title>
    <para>
      Playing <application>Five or More</application> is easy. At startup, you find
      yourself with five objects randomly positioned on the board. Each turn,
      you are allowed to move one object. You can move it anywhere on the board as long as there is a clear path. Afterward, the computer drops more objects
      at random positions (the exact number depends on the size of the game). You can preview the next objects to be
      dropped in the upper left corner of the game's window.
      If you manage to align five objects of the same shape and color, they
      disappear and you are given an extra move before more objects
      drop.
    </para>


  <!-- ========= Basic Usage =========================== -->
  <sect2 id="mainwin">
   <title>Basic usage</title>
   <para>
    Starting <application>Five or More</application> presents you with the
    <interface>game board</interface> and a new game starts. What it 
    looks like is shown in <xref linkend="mainwindow-fig" />.</para>

    <!-- ==== Figure ==== -->
	<figure id="mainwindow-fig">
	  <title>The main window when you start a game.</title>
	  <screenshot>
	      <mediaobject>
	      <imageobject>
	      <imagedata fileref="figures/glines-startgame.png" format="PNG" srccredit="emese" />
	      </imageobject>
	      </mediaobject>
	  </screenshot>
	</figure>
     <!-- ==== End of Figure ==== -->

   <para>
     As the game progresses, the board gets more and more crowded 
     (unless you are really good...) and making objects disappear gets harder
     and harder. The game is over, when the board is full. 
   </para>
   
   <!-- ==== Figure ==== -->
   <figure id="gameover-fig">
	  <title>Game over!</title>
	  <screenshot>
    <mediaobject>
     <imageobject>
      <imagedata fileref="figures/glines-gameover.png" format="PNG" srccredit="emese kovacs" />
     </imageobject>
    </mediaobject>
 </screenshot>
</figure>  
   <!-- ==== End of Figure ==== -->
   
  </sect2>


  <!-- ========= Rulez =========================== -->

    <sect2 id="rules"> 
      <title>Playing the Game</title>
      <para>
        A game of <application>Five or More</application> begins with some
        random objects on the board.
      </para>
      <para>
        To make a move, click on one of the objects. When an object is activated it
	starts rotating (or doing something else depending on the theme, but
	let us not anticipate…). You can then select its destination by
	clicking an empty square. If the path to the destination is clear
	the activated item travels there. If the destination square is occupied
	by another object nothing will be moved and the selection will be
	transferred to the new object. If the path is not clear (you cannot
	jump objects over obstacles!) the application prints a
	warning in the status bar (bottom of the window) and the original
	object remains active.
      </para>
      <para>
        As objects disappear, you get points. The points you score
	depends on the number of objects you managed to align (see
	<xref linkend="glines-table1" />). Your score is shown in the upper
	right corner of the window.
      </para>
      
    <!-- ====  Table 1.  ==== -->
    <table id="glines-table1">
     <title>Scoring in Five or More</title>
      <tgroup cols="2" align="center">
       <thead>
        <row>
         <entry>Number of objects</entry>
         <entry>Score given</entry>
        </row>
       </thead>
       <tbody>
       <row>
        <entry>5</entry>
        <entry>10</entry>
       </row>
       <row>
        <entry>6</entry>
        <entry>12</entry>
       </row>
       <row>
        <entry>7</entry>
        <entry>18</entry>
       </row>
       <row>
        <entry>8</entry>
        <entry>28</entry>
       </row>
       <row>
        <entry>9</entry>
        <entry>42</entry>
       </row>
       <row>
        <entry>10</entry>
        <entry>82</entry>
       </row>
       <row>
        <entry>11</entry>
        <entry>108</entry>
       </row>
       <row>
        <entry>12</entry>
        <entry>138</entry>
       </row>
      <row>
        <entry>13</entry>
        <entry>172</entry>
      </row>
      <row>
        <entry>14</entry>
        <entry>210</entry>
       </row>
      </tbody>
     </tgroup> 
    </table>

  <sect3>
  <title>Using the Keyboard</title>
  <para>
  Instead of using the mouse you can use the keyboard to play <application>Five or More</application>. To use the keyboard, hit an arrow key and a cursor will appear near the center of the board. The arrow keys will move the cursor. When the cursor is over the object you want to move, use the spacebar to select it. Then shift the cursor to the object's destination and hit the space bar again to move the object.</para><para>If you start using the mouse again, the cursor will disappear. The cursor will reappear if you use the arrow keys again.
  </para>
  </sect3>


   <!-- ==== End of Table ==== -->


    </sect2>


  </sect1>
  <sect1 id="settings">
  <title>Customizing the Game</title>
  <para>
   You can configure <application>Five or More</application> by clicking on 
   <guimenuitem>Preferences</guimenuitem> in the applications 
   <guimenu>Settings</guimenu> menu. The following 
   <interface>dialog</interface> will appear:
  </para>
 <!-- ==== Figure ==== -->
   <figure>
     <title>Preferences</title>   
    <mediaobject id="preferences-dialogbox">
     <imageobject>
      <imagedata fileref="figures/preferences.png" format="PNG" srccredit="emese" />
     </imageobject>
    </mediaobject>
  </figure>    
    <!-- ==== End of Figure ==== -->

  <para>
   You can select different object styles and background colors in the
   <guimenu>Themes</guimenu> section. If you find it difficult distinguishing the colours, 
   try the shapes theme.
  </para>
  <para>
   The <guimenu>Board Size</guimenu> section lets you select the size of the board. Each size has a slightly different balance: larger sizes give you more space to move, but more objects arrive each turn. The parameters for each size are given in <xref linkend="table-sizes" />.
  </para>
    <table id="table-sizes">
     <title>Scoring in Five or More</title>
      <tgroup cols="5" align="center">
       <thead>
        <row>
         <entry align="left">Size</entry>
         <entry>Width</entry>
         <entry>Height</entry>
	 <entry>Number of Types</entry>
         <entry>Objects per Turn</entry>
        </row>
       </thead>
       <tbody>
       <row>
        <entry align="left">Small</entry>
        <entry>7</entry>
        <entry>7</entry>
        <entry>5</entry>
        <entry>3</entry>
       </row>
       <row>
        <entry align="left">Medium</entry>
        <entry>9</entry>
        <entry>9</entry>
        <entry>7</entry>
        <entry>3</entry>
       </row>
       <row>
        <entry align="left">Large</entry>
        <entry>20</entry>
        <entry>15</entry>
        <entry>7</entry>
        <entry>7</entry>
       </row>
      </tbody>
     </tgroup> 
    </table>

  <para>
   You can speed up the movement of the objects by checking the Use fast
   moves box in the <guimenu>General</guimenu> preferences section.
  </para>
  <para>
   Any changes you make are instantly applied and remembered for the next time you run
   <application>Five or More</application>.
  </para>
  </sect1>
  <sect1 id="themes">
    <title>How to create new themes</title> 
    <para>Each theme consists of a single PNG image file. This image
    consists of an array of seven rows, corresponding to the different
    object colors/shapes, and four columns, each of which is a frame in the
    animation of the object. The actual size of the image is irrelevant,
    it will be rescaled, but the sub-images must form a four by seven
    grid to get the correct effect. When using SVG remember that the
    image size is the page size, if your grid does not fill the page
    try shrinking the page size. Use an existing theme as a
    guide.</para>
  </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 omit this section than give false impression of perfection
      Add back in if there is something worth saying

 <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>Five or More</application> was written by Róbert
   Szókovács (<email>szo@appaloosacorp.hu</email>) and Szabolcs Bán
   (<email>shooby@gnome.hu</email>). This manual was written by Emese Kovács
   (<email>emese@gnome.hu</email>). 
   For information on how to make comments, suggestions and to report
   bugs please see the <ulink url="ghelp:user-guide?feedback-bugs" type="help">feedback 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>
