/usr/share/help/oc/swell-foop/index.docbook is in swell-foop 1:3.28.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 | <?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="oc">
<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>Projècte de documentacion de 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 lang="en">Feedback</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 lang="en">The board starts as a full grid of objects. Depending on the size of board you select, there are either three or four types of object. If a group of objects are adjacent and all the same type, then they can be removed simply by clicking them with the mouse (or by pressing the space bar). When you move the mouse over a group you can remove, the objects will start moving. The number of objects in the group, and the points you will score for removing that group, is shown in the lower left corner of the window. The more objects in the group, the more points you will score. Once the group has been removed the objects above them fall down to fill the space. If an entire column is cleared then the objects slide leftward to fill the gap.</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 lang="en">Scoring is based on the number of objects you delete:</para>
<informaltable frame="topbot">
<tgroup cols="2" align="center">
<thead><row>
<entry lang="en">Number of Objects</entry>
<entry lang="en">Points Scored</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 lang="en">⋮</entry><entry lang="en">⋮</entry></row>
<row><entry>n</entry><entry lang="en">(n - 2)<superscript>2</superscript></entry></row>
</tbody>
</tgroup>
</informaltable>
<para lang="en">If you clear the board there is a 1000 point bonus.</para>
</sect1>
<sect1 id="swell-foop-customisation">
<title>Personalisacion</title>
<sect2 id="changing-the-look">
<title lang="en">Changing the Look</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 lang="en">Changing the Size</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-number-of-objects">
<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 lang="en">Changing the Speed</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 lang="en">Strategy</title>
<para lang="en">The most important rule when aiming for a high score is to think ahead: each group you remove will form and destroy other groups.</para>
<para lang="en"> Remove higher groups first, unless removing another group will make it larger. Vertically aligned objects can't be misaligned, but horizontal arrangements can.</para>
<para lang="en">Since the score increases quadratically, big groups of objects are always better. For example, the points difference between a six object group and a seven object group is nine points. In a situation where you have a choice between merging two groups of two into four or just adding one more to the group of six then you should add the single object. Even though the groups of two you are left with score no points, the bigger group scores more overall.</para>
<para lang="en">Don't forget the thousand point bonus for clearing all the balls. To get 1000 points from a single group you need 34 objects. You are very unlikely to be in a position where you have to sacrifice a group that large to clear the board.</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 lang="en">
To report a bug or make a suggestion regarding this application 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>
<para lang="en"> This program is distributed under the terms of the GNU
General Public license as published by the Free Software
Foundation; either version 2 of the License, or (at your option)
any later version. A
<ulink url="help:gpl" type="help">copy of this license</ulink>
is included with this documentation; another can be found in the file
COPYING included with the source code of this program. </para>
</sect1>
</article>
|