<?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 appversion "3.4">
<!ENTITY manrevision "3.4">
<!ENTITY date "March 2012">
<!ENTITY appname "Swell Foop">
<!ENTITY app "<application>Swell Foop</application>">
]>
<!--
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://live.gnome.org/DocumentationProject
  Template version: 3.0 beta
  Template last modified 2006-11-21

-->
<!-- =============Document Header ============================= -->
<article id="index" lang="ca">
  <articleinfo> 
    <title lang="en"><application>Swell Foop</application> Manual</title>       
    
    <abstract role="description">
      <para lang="en">
	Swell Foop is a puzzle game, of which the objective is to clear 
	the window of as many pieces as possible by clicking on groups 
	of the same colored pieces. That group will vanish and the 
	pieces on top will fall until there are none left or no more 
	color groups.
      </para>
    </abstract>

    <copyright lang="en"> 
      <year>2005</year> 
      <holder>Callum McKenzie</holder> 
    </copyright> 
    <copyright lang="en"> 
      <year>2012</year> 
      <holder>Andre Klapper</holder> 
    </copyright> 

    <publisher role="maintainer"> 
      <publishername>Projecte de documentació del GNOME</publishername> 
    </publisher> 

	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="legal.xml"/>   
   <!-- This file legal.xml 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 lang="en"> 
		<firstname>Callum</firstname> 
		<surname>McKenzie</surname> 
		<affiliation> 
	  		<orgname>GNOME Documentation Project</orgname> 
	  		<address> <email>callum@physics.otago.ac.nz</email> </address> 
		</affiliation> 
      </author> 
      <author lang="en"> 
		<firstname>Andre</firstname> 
		<surname>Klapper</surname> 
		<affiliation> 
	  		<orgname>GNOME Documentation Project</orgname> 
	  		<address> <email>ak-47@gmx.net</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="3.4" role="review"/>


<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
<!-- Remember to remove the &manrevision; entity from the revision entries other
-->
<!-- than the current revision. -->
<!-- The revision numbering system for GNOME manuals is as follows: -->
<!-- * the revision number consists of two components -->
<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
<!-- to V3.0, and so on. --> 
    <revhistory>
      <revision lang="en"> 
		    <revnumber>Swell Foop Manual V3.4</revnumber>
		    <date>March 2012</date> 
		    <revdescription> 
    			<para lang="en">Updates to the Swell Foop manual.</para>		    
	  		  <para role="author" lang="en">Andre Klapper <email>ak-47@gmx.net</email></para>
	  		  <para role="publisher" lang="en">GNOME Documentation Project</para>
    		</revdescription> 
      </revision> 

      <revision lang="en"> 
		    <revnumber>Swell Foop Manual V2.11</revnumber>
		    <date>January 2008</date> 
		    <revdescription> 
    			<para lang="en">Adaptation of the Swell Foop manual to new template.</para>		    
	  		  <para role="author" lang="en">Claude Paroz <email>claude@2xlibre.net</email></para>
	  		  <para role="publisher" lang="en">GNOME Documentation Project</para>
    		</revdescription> 
      </revision> 
      <revision lang="en"> 
		    <revnumber>Swell Foop Manual V2.10</revnumber>
		    <date>February 2005</date> 
		    <revdescription> 
    			<para lang="en">Initial version for the new Swell Foop.</para>		    
	  		  <para role="author" lang="en">Callum McKenzie <email>callum@physics.otago.ac.nz</email></para>
	  		  <para role="publisher" lang="en">GNOME Documentation Project</para>
    		</revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo lang="en">This manual describes version 3.4 of Swell Foop.
    </releaseinfo> 
    <legalnotice> 
      <title>Comentaris</title> 
      <para lang="en">To report a bug or make a suggestion regarding the <application>Swell Foop</application> game or
      this manual, follow the directions in the <ulink url="ghelp:user-guide?feedback-bugs" type="help">Feedback section of the GNOME User Guide</ulink>. 
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm zone="index" lang="en"> 
    <primary>Swell Foop</primary> 
  </indexterm> 

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

  <sect1 id="introduction"> 
    <title lang="en">Playing <application>Swell Foop</application></title> 
    <para lang="en"><application>Swell Foop</application> is a puzzle game. The goal is to remove as many objects as possible in as few moves as possible. Objects that are adjacent to each other get removed as a group. The remaining objects then collapse to fill in the gaps and new groups are formed. You cannot remove single objects.</para>

    <figure id="start-up">
      <title lang="en"><application>Swell Foop</application> at the beginning of a new game.</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/start-up.png" format="PNG"/>
	        </imageobject>
	      </mediaobject>
      </screenshot>
    </figure>

    <para>El tauler s'inicia amb una graella plena d'objectes. Segons la mida del tauler que seleccioneu, hi haurà tres o quatre objectes diferents. Si teniu un grup d'objectes i tots són del mateix tipus, llavors el podeu treure amb un simple clic amb el ratolí sobre ells (o si premeu la barra espaiadora). Quan moveu el ratolí sobre d'un grup que podeu treure, els objectes començaran a moure's. Com més objectes tingui el grup, més punts guanyareu. Quan s'hagi tret el grup, els objectes sobre seu cauran per a omplir l'espai. Si es treu una columna sencera, llavors els objectes lliscaran cap a l'esquerra per a omplir el forat.</para>

    <table id="play" frame="all"><title lang="en">Playing <application>Swell Foop</application></title>
      <tgroup cols="2" colsep="0">
      <tbody>
        <row><entry><para lang="en">1. Eliminate groups of two or more 
         <screenshot>
         <mediaobject>
           <imageobject>
             <imagedata fileref="figures/play1.png" format="PNG"/>
           </imageobject>
         </mediaobject>
         </screenshot></para></entry>
       <entry><para lang="en">2. Objects fall down to fill the gaps
         <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/play2.png" format="PNG"/>
            </imageobject>
          </mediaobject>
          </screenshot></para></entry></row>
        <row><entry><para lang="en">3. Objects move left to fill empty columns
         <screenshot>
         <mediaobject>
           <imageobject>
             <imagedata fileref="figures/play3.png" format="PNG"/>
           </imageobject>
         </mediaobject>
         </screenshot></para></entry>
       <entry><para lang="en">4. New groups are formed and the cycle repeats
         <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/play4.png" format="PNG"/>
            </imageobject>
          </mediaobject>
          </screenshot></para></entry></row>
      </tbody>
      </tgroup>
    </table>

    <para>La puntuació està basada en el número d'objectes que traieu:</para>
    
    <informaltable frame="topbot">
    <tgroup cols="2" align="center">
    <thead><row>
    <entry>Número d'objectes</entry>
    <entry>Punts obtinguts</entry>
    </row></thead>
    <tbody>
    <row><entry>2</entry><entry>0</entry></row>
    <row><entry>3</entry><entry>1</entry></row>
    <row><entry>4</entry><entry>4</entry></row>
    <row><entry>5</entry><entry>9</entry></row>
    <row><entry>6</entry><entry>16</entry></row>
    <row><entry>7</entry><entry>25</entry></row>
    <row><entry>8</entry><entry>36</entry></row>
    <row><entry>9</entry><entry>49</entry></row>
    <!-- Translators: this is a vertical continuation character -->
    <row><entry>⋮</entry><entry>⋮</entry></row>
    <row><entry>n</entry><entry lang="en">(n - 2)<superscript>2</superscript></entry></row>
    </tbody>
    </tgroup>
    </informaltable>
    <para>Si netegeu el tauler obtindreu una bonificació de 1000 punts.</para>
  </sect1>

  <sect1 id="swell-foop-customisation">
    <title>Personalització</title>

    <sect2 id="changing-the-look">
      <title>Canviar l'aparença</title>

      <para lang="en">To change the appearance of the objects use the <guimenuitem>Theme</guimenuitem> item under <menuchoice><guimenu>Swell Foop</guimenu><guimenuitem>Preferences</guimenuitem><guimenuitem>Appearance</guimenuitem></menuchoice>. Selecting an item from the list changes the theme immediately.</para>

        <para lang="en">You can also create your own themes, although the process is not very straight-forward yet. Use a copy of an existing theme from <filename>/usr/share/gnome-games/swell-foop/themes/</filename> as a template and alter it with your favorite paint program. Put the result in <filename>$XDG_DATA_HOME/gnome-games/swell-foop/themes/</filename>. It will be automatically included on the themes list next time you run <application>Swell Foop</application>. <filename>$XDG_DATA_HOME</filename> is usually <filename>~/.local/share/</filename>.</para>
    </sect2>

    <sect2 id="changing-the-size">
      <title>Canviar la mida</title>
      <para lang="en">The <guimenu>Board size</guimenu> list under <menuchoice><guimenu>Swell Foop</guimenu><guimenuitem>Preferences</guimenuitem><guimenuitem>Setup</guimenuitem></menuchoice> contains three settings: <guimenuitem>Small</guimenuitem>, <guimenuitem>Medium</guimenuitem> and <guimenuitem>Large</guimenuitem>.</para>
    </sect2>

    <sect2 id="changing-the-size">
      <title lang="en">Changing the Number of Objects</title>
      <para lang="en">The <guimenu>Number of colors</guimenu> option under <menuchoice><guimenu>Swell Foop</guimenu><guimenuitem>Preferences</guimenuitem><guimenuitem>Setup</guimenuitem></menuchoice> allows you to increase the number of different objects.</para>
    </sect2>

    <sect2 id="changing-the-speed">
    <title>Canviar la velocitat</title>
    <para lang="en">The default animation is designed to be smooth and graceful. If you like playing fast and furious then this may be too slow for you. By selecting the <guimenuitem>Zealous Animation</guimenuitem> option under <menuchoice><guimenu>Swell Foop</guimenu><guimenuitem>Preferences</guimenuitem><guimenuitem>Operation</guimenuitem></menuchoice> you can speed up game-play at the expense of animation quality.</para>
    </sect2>

  </sect1>

  <sect1 id="swell-foop-strategy">
    <title>Estratègia</title>

    <para>La regla més important quan intenteu obtenir una puntuació alta és pensar per avançat: cada grup que treieu crearà i desfarà altres grups.</para>

<para>Primer treieu els grups superiors, a no ser que si treieu un altre grup es faci més gran. Els objectes alineats verticalment no es poden desalinear, però els horitzontals sí.</para>

    <para>Com que la puntuació s'incrementa de forma quadràtica, els millors grups d'objectes sempre són els grans. Per exemple, la diferència de punts entre un grup de sis objectes i un de set objectes és de nou punts. En una situació on heu de triar entre ajuntar dos grups de dos en un de quatre o només afegir-ne un altre al grup de sis, llavors hauríeu d'afegir un objecte. Tot i que els grups de dos que heu deixat no puntuen, el grup gran puntua més que tot junt.</para>

    <para>No oblideu la bonificació de mil punts per a netejar totes les boles. Per a obtenir 1000 punts d'un grup necessiteu 34 objectes. És molt poc probable que es doni la situació on heu de sacrificar un grup tant gran per a netejar el tauler.</para>
  </sect1>

<!-- ============= About ================================== -->
  <sect1 id="swell-foop-about"> 
    <title lang="en">About <application>Swell Foop</application></title> 
    <para lang="en"><application>Swell Foop</application> was written by Callum McKenzie
      (<email>callum@physics.otago.ac.nz</email>). To find more information about
      <application>Swell Foop</application>, please visit the 
      <ulink url="http://live.gnome.org/GnomeGames/" type="http">GNOME Games web page</ulink>. </para>
    <para>Per a informar d'un error o fer algun suggeriment sobre aquesta aplicació o aquest manual, seguiu les indicacions en la <ulink url="ghelp:user-guide?feedback-bugs" type="help">Secció de comentaris de la guia d'usuari del GNOME</ulink>.</para>

    <para>Aquest programa es distribueix sota els termes de la Llicència pública general de GNU tal com publica la Free Software Foundation; tant en la versió 2 de la llicència, o (a la vostra opció) una versió posterior. S'inclou una <ulink url="ghelp:gpl" type="help">còpia d'aquesta llicència</ulink> amb aquesta documentació; se'n pot trobar una altra en el fitxer COPYING inclòs amb el codi font d'aquest programa.</para>

  </sect1> 
</article>
