<?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.10">
  <!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 V&manrevision;</title>
  <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> 
      <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>
    
    <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:gnome-feedback"
	  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 balls or more
   of the same color 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>
      <application>Five or More</application> is easy to play. At startup, you find
      yourself with five balls randomly positioned on the board. Each turn,
      you are allowed to move one ball. You can move it up or down, left
      or right, or any combination of the previously mentioned directions,
      any number of squares. After your move, the computer drops three balls,
      again at random positions. You can preview the color of the balls to be
      dropped in the upper right corner of the application's window.
      If you manage to align five balls of the same color, they
      disappear and you are given an extra move before more balls
      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>, which is nine squares on a
    side.  A new game starts as you launch the application. What it 
    looks like is shown in <xref linkend="mainwindow-fig" />.

    <!-- ==== Figure ==== -->
	<figure id="mainwindow-fig">
	  <title>Five or More Main Window</title>
	  <screenshot>
    <mediaobject>
     <imageobject>
      <imagedata fileref="figures/glines-startgame" format="PNG" srccredit="emese" />
     </imageobject>
     <textobject>
      <phrase>Five or More Main Window</phrase>
     </textobject>
     <caption>
      <para>Five or More Main Window</para>
     </caption>
    </mediaobject>
</screenshot>
</figure>
     <!-- ==== End of Figure ==== -->

   </para>

   <para>
     As the game progresses, the board gets more and more crowded 
     (unless you are really good...) and making balls disappear gets harder
     and harder&hellip; The game is over, when the board is full. 
   
   <!-- ==== Figure ==== -->
   <figure id="gameover-fig">
	  <title>Game Over!</title>
	  <screenshot>
    <mediaobject>
     <imageobject>
      <imagedata fileref="figures/glines-gameover" format="PNG" srccredit="emese kovacs" />
     </imageobject>
     <textobject>
      <phrase>Game Over!</phrase>
     </textobject>
     <caption>
      <para>Game Over!</para>
     </caption>
    </mediaobject>
 </screenshot>
</figure>  
   <!-- ==== End of Figure ==== -->
   
   </para>
  <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 ball you want to move, use the spacebar to select it. Then shift the cursor to the ball's destination and hit the space bar again to move the ball.</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>

  </sect2>


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

    <sect2 id="rules"> 
      <title>Basic Rules</title>
      <para>
        A game of <application>Five or More</application> begins with five
        balls of random colors on the board.
      </para>
      <para>
        To make a move, click on one of the balls. A ball is activated when it
	starts rotating (or doing something else depending on the theme, but
	let us not anticipate&hellip;). You can then select its destination by
	clicking an empty square. If the path to the destination is clear,
	the activated ball rolls there. If the destination square is occupied
	by another ball, no ball will be moved and the selection will be
	transferred to the latter ball. If the path is not clear (your ball
	cannot jump over already laid down balls!) the application prints a
	warning in the status bar (bottom of the window) and the original
	ball remains active.
      </para>
      <para>
        As balls disappear, you get points, your score is shown in the upper
	right corner of the application window. The points you score
	depends on the number of balls you managed to align (see
	<xref linkend="glines-table1" />).
      </para>
      
    <!-- ====  Table 1.  ==== -->
    <table id="glines-table1">
     <title>Scoring in Five or More</title>
      <tgroup cols="2" align="center">
       <thead>
        <row>
         <entry>Number of balls</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>


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


    </sect2>


  <!-- ========= Menus =========================== -->
  <sect2 id="menubar">
   <title>Menus</title>
   <para>
    The menu bar, located at the top of the <interface>game 
    board</interface>, contains the following menus:
   </para>

   <variablelist>
    <varlistentry>
     <term><guimenu>Game</guimenu></term>
     <listitem>
      <para>
       This menu contains three items:
      <itemizedlist>	
	<listitem>
	  <para>
            <menuchoice> 
	       <shortcut><keysym>Ctrl-N</keysym></shortcut>
               <guimenuitem>New Game</guimenuitem>clear the board and
	       start a new game. The current game is abandoned.
	    </menuchoice>
           </para>
         </listitem>     
       
	<listitem>
	  <para>
            <menuchoice>
               <guimenuitem>Scores...</guimenuitem>show the high score table.
            </menuchoice>
        </para>
       </listitem>

       	<listitem>
	<para>
          <menuchoice>
            <shortcut><keysym>Ctrl-Q</keysym></shortcut>
            <guimenuitem>Exit</guimenuitem>abandon the current game
            and close the program.
          </menuchoice>
        </para>
       </listitem>
     </itemizedlist>
      </para>
     </listitem>
    </varlistentry>

	<varlistentry>
	  <term><guimenu>Settings</guimenu></term>
	  <listitem>
	    <para>
              The <guimenu>Settings</guimenu> menu contains only one item:
              <itemizedlist>
		<listitem>
		  <para>
                   <guimenuitem>Preferences</guimenuitem>
                    which brings up the preferences dialog box.
                  </para>
		</listitem>
	      </itemizedlist>
            </para>
	  </listitem>
	</varlistentry>

    <varlistentry>
     <term><guimenu>Help</guimenu></term>
     <listitem>
      <para>
       This menu contains:
       <itemizedlist>
        <listitem>
         <para>
          <menuchoice>
            <shortcut><keysym>F1</keysym></shortcut>
          <guimenuitem>Contents</guimenuitem>&mdash;
          shows this manual.
          </menuchoice>
         </para>
        </listitem>
        <listitem>
         <para>
          <guimenuitem>About</guimenuitem>&mdash; shows
          basic information about
          <application>Five or More</application>, such as
          the author's name and the application version number.
         </para>
        </listitem>
       </itemizedlist>

      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </sect2>
  <sect2 id="settings">
  <title>How to set preferences</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>dialogbox</interface> will show up:
  </para>
 <!-- ==== Figure ==== -->
    <mediaobject id="preferences-dialogbox">
     <imageobject>
      <imagedata fileref="figures/preferences" format="PNG" srccredit="emese" />
     </imageobject>
     <textobject>
      <phrase>Preferences</phrase>
     </textobject>
     <caption>
      <para>Preferences</para>
     </caption>
    </mediaobject>
    
    <!-- ==== End of Figure ==== -->

  <para>
   You can select different ball styles and background colors in the
   Themes section. If you find it difficult distinguishing the colours, 
   try the shapes theme.
  </para>
  <para>
   You can speed up the movement of the balls by checking the Use fast
   moves box in the General preferences section.
  </para>
  <para>
   Any changes you make are instantly applied. Furthermore your
   preferences are remembered for the next time you run
   <application>Five or More</application>.
  </para>
</sect2>
 </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
    ball colors, and four columns each of which is a frame in the
    animation of the ball. 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 -->
 <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>). Please send all comments,
   suggestions, and bug reports to the <ulink
   url="http://bugs.gnome.org" type="http">GNOME bug tracking
   database</ulink>. (Instructions for submitting bug reports can be
   found
   <ulink url="http://bugs.gnome.org/Reporting.html" type="http">
   on-line</ulink>.) You can also use the
   <application>Bug Report Tool</application>
   (<command>bug-buddy</command>) for submitting bug reports.
  </para>

  <para> This manual was written by Emese Kovács
   (<email>emese@gnome.hu</email>). Please send all comments and suggestions
   regarding this manual to the <ulink url="http://www.gnome.org/gdp"
   type="http">GNOME Documentation Project</ulink> by sending an email to
   <email>docs@gnome.org</email>. You can also add your comments online by
   using the <ulink url="http://www.gnome.org/gdp/doctable/"
   type="http">GNOME Documentation Status Table</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>
