1
<?xml version="1.0" encoding="utf-8"?>
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
3
<!ENTITY legal SYSTEM "legal.xml">
4
<!ENTITY appversion "2.20">
5
<!ENTITY manrevision "2.20">
6
<!ENTITY date "May 2007">
7
<!ENTITY app "<application>Nibbles</application>">
8
<!ENTITY appname "Nibbles">
9
<!ENTITY VERSION "2.20">
12
(Do not remove this comment block.)
13
Maintained by the GNOME Documentation Project
14
http://developer.gnome.org/projects/gdp
15
Template version: 2.0 beta
16
Template last modified Feb 12, 2002
18
<!-- =============Document Header ============================= -->
19
<article id="index" lang="en-GB">
20
<!-- please do not change the id; for translations, change lang to -->
21
<!-- appropriate code -->
23
<title><application>Nibbles</application> Manual</title>
25
<abstract role="description">
26
<para><application>Nibbles</application> is a worm game for GNOME. The player controls a 2D worm while trying to get food. Getting food gives points, but hitting anything causes a loss of points. When all points are lost, the player loses.</para>
31
<holder>Kevin Breit</holder>
34
<!-- translators: uncomment this:
38
<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
43
<!-- An address can be added to the publisher information. If a role is
44
not specified, the publisher/author is the same for all versions of the
47
<publishername>GNOME Documentation Project</publishername>
50
<legalnotice id="legalnotice">
51
<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>
52
<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>
54
<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>
57
DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
58
UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
59
WITH THE FURTHER UNDERSTANDING THAT:
63
<para lang="en">DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
64
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
65
IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
66
THAT THE DOCUMENT OR MODIFIED VERSION OF THE
67
DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
68
A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
69
RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
70
OF THE DOCUMENT OR MODIFIED VERSION OF THE
71
DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
72
MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
73
YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
74
CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
75
SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
76
OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
77
LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
78
VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
79
EXCEPT UNDER THIS DISCLAIMER; AND
83
<para lang="en">UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
84
THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
85
CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
86
INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
87
DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
88
OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
89
PARTIES, BE LIABLE TO ANY PERSON FOR ANY
90
DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
91
CONSEQUENTIAL DAMAGES OF ANY CHARACTER
92
INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
93
OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
94
MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
95
LOSSES ARISING OUT OF OR RELATING TO USE OF THE
96
DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
97
EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
98
THE POSSIBILITY OF SUCH DAMAGES.
106
<!-- This file contains link to license for the documentation (GNU FDL), and
107
other legal stuff such as "NO WARRANTY" statement. Please do not change
111
<author role="maintainer" lang="en">
112
<firstname>Kevin</firstname>
113
<surname>Breit</surname>
115
<orgname>GNOME Documentation Project</orgname>
116
<address> <email>battery841@mypad.com</email> </address>
119
<!-- This is appropriate place for other contributors: translators,
120
maintainers, etc. Commented out by default.
121
<othercredit role="translator">
122
<firstname>Latin</firstname>
123
<surname>Translator 1</surname>
125
<orgname>Latin Translation Team</orgname>
126
<address> <email>translator@gnome.org</email> </address>
128
<contrib>Latin translation</contrib>
133
<releaseinfo revision="2.26" role="review"/>
137
<revnumber>Nibbles Manual V2.20</revnumber>
138
<date>May 2007</date>
140
<para role="author" lang="en">Kevin Breit
141
<email>battery841@mypad.com</email>
143
<para role="publisher" lang="en">GNOME Documentation Project</para>
148
<releaseinfo>This manual describes version 2.20 of Nibbles.</releaseinfo>
149
<!-- The following feedback information only applies to appliactions
150
listed in bugzilla.gnome.org and bugzilla.ximian.com. For other
151
applications, please provide your own feedback info or remove thsi
152
section altogether -->
154
<title>Feedback</title>
155
<para>To report a bug or make a suggestion regarding the <application>Nibbles</application> application or this manual, follow the directions in the <ulink url="ghelp:user-guide?feedback-bugs" type="help">GNOME Feedback Page</ulink>.</para>
156
<!-- Translators may also add here feedback address for translations -->
160
<indexterm zone="index" lang="en">
161
<primary>Nibbles</primary>
164
<!-- ============= Document Body ============================= -->
166
<!-- ============= Introduction ============================== -->
168
<title>Introduction</title>
170
<para><application>Nibbles</application> is a game where the user controls a worm. The worm moves around the board, eating diamonds while avoiding the walls placed around it.</para>
173
To run <application>Nibbles</application>, select
175
<guisubmenu>Games</guisubmenu>
176
<guimenuitem>Nibbles</guimenuitem>
178
from the <guimenu>Applications</guimenu> menu, or type
179
<command>gnibbles</command> on the command line.
182
<para><application>Nibbles</application> is included in the <filename>gnome-games</filename> package, which is part of the GNOME desktop environment. This document describes version 2.20 of <application>Nibbles</application>.</para>
185
<sect1 id="objective">
186
<title>Nibbles Objective</title>
187
<para>The objective of <application>Nibbles</application> is quite simple. You control the worm and if the worm runs into a wall or runs into itself, you die. You get ten lives before your game is over. You win by either beating your own high score (or a friend's) or by completing all the levels. It is also possible to play against worms with artificial intelligence.</para>
189
Nibbles also features multiplayer support with up to six competing
190
human players in hotseat mode.
194
<!-- ================ Usage ================================ -->
195
<!-- This section should describe basic usage of the application. -->
198
<title>Using Nibbles</title>
199
<para><application>Nibbles</application> is a simple game to play. The only keys that are needed are the arrow keys.</para>
201
<!-- ========= Basic Usage =========================== -->
203
<title>Basic usage</title>
205
Starting <application>Nibbles</application> opens
206
the <interface>main window</interface> shown below.
207
<figure id="intro-fig">
208
<title lang="en">Nibbles Introduction Window</title>
210
<mediaobject lang="en">
212
<imagedata fileref="figures/intro.png" format="PNG"/>
215
<phrase>Nibbles Introduction Window.</phrase>
222
To start the game, select <menuchoice><guimenu>Game</guimenu>
223
<guimenuitem>New Game</guimenuitem></menuchoice>.
226
When the game starts, the worm will come out of the left side of the
227
screen. You use the up arrow to make the direction of the worm go up.
228
Use the right arrow to turn the worm right, left arrow to turn the worm
229
left, and down arrow to turn the worm down.
230
<figure id="gameplay">
231
<title lang="en">Nibbles During Gameplay</title>
233
<mediaobject lang="en">
235
<imagedata fileref="figures/playing.png" format="PNG"/>
238
<phrase>Nibbles During Gameplay.</phrase>
246
<!-- This section should also describe main elements of graphic user
247
interface, such as menus and buttons, unless this description
248
is too long - in that case, it should be moved to a separate
249
section. For example -->
252
<!-- ========= Menus =========================== -->
255
<para>The menu bar, located at the top of the <interface>Main Window</interface>, contains the following menus:</para>
259
<term lang="en"><guimenu>Game</guimenu></term>
268
<keysym>Ctrl+N</keysym>
270
<guimenuitem>New Game</guimenuitem>
272
This starts a new game of <application>Nibbles</application>.
278
<guimenuitem>Scores</guimenuitem>
280
This shows the high scores.
286
<guimenuitem>Pause game</guimenuitem>
288
This will pause your game. Click on the <quote>Pause Game
289
</quote> menu option to resume game.
295
<guimenuitem>End Game</guimenuitem>
297
End the current game and return to the title screen.
304
<keysym>Ctrl-Q</keysym>
306
<guimenuitem>Exit</guimenuitem>
308
This quits the application.
317
<term lang="en"><guimenu>View</guimenu></term>
325
<guimenuitem>Fullscreen</guimenuitem>
327
This toggles your game window to be fullscreen.
336
<term lang="en"><guimenu>Settings</guimenu></term>
344
<guimenuitem>Preferences</guimenuitem>
346
This opens your window to edit <link linkend="prefs">
356
<term lang="en"><guimenu>Help</guimenu></term>
367
<guimenuitem>Contents</guimenuitem>
372
<guimenuitem>About</guimenuitem> This opens the
373
<interface>About</interface> dialog which shows
374
basic information about
375
<application>Nibbles</application>, such as
376
the author's name, the version number of the game.
385
<sect2 id="diamonds">
386
<title>Diamonds</title>
387
<para><application>Nibbles</application> has numerous different diamonds to eat. They are each a different colour and serve a different function. Only the pale purple diamond is guaranteed to be around long enough for you to eat it (in fact, you have to eat them to finish the level). The other diamonds are all bonuses, but they only stick around for a short time. We'll leave it up to you to discover just what the bonus each colour gives, but they all affect either the score, the length of the worm, or both. Be careful when going for these bonus diamonds, don't cut yourself off from the ordinary diamonds that you need to finish the level.</para>
392
<!-- ============= Customization ============================= -->
394
<title>Customisation</title>
396
To change the application settings, select
398
<guimenu>Settings</guimenu>
399
<guimenuitem>Preferences</guimenuitem>
400
</menuchoice>. This opens the
401
<interface>Preferences</interface> dialog. All preferences are
402
automatically saved and applied as you change them.
405
<figure id="game-prefs">
406
<title>Game Preferences Tab</title>
408
<mediaobject lang="en">
410
<imagedata fileref="figures/game.png" format="PNG" srccredit="Kevin Breit"/>
413
<phrase>Game Preferences Tab.</phrase>
420
The properties in the <guilabel>Game</guilabel> tab are:
423
<term lang="en">Speed</term>
426
This controls the speed of the worm.
431
<term lang="en">Play levels in random order</term>
434
Selecting this causes the level
435
advancement to happen in random order.
440
<term lang="en">Enable fake bonuses</term>
443
When enabled, this allows for two blue diamonds on
444
the screen at a time. One diamond makes you shrink instead of grow when
450
<term lang="en">Enable sounds</term>
453
Controls the use of sound in the game.
458
<term lang="en">Starting level</term>
461
Which level to start with. Use this if you want to jump
462
immediately to a challenging level.
467
<term lang="en">Number of human players</term>
470
There is room for up to six players.
475
<term lang="en">Number of AI players</term>
478
There is room for up to six AI players. Note that the total
479
number of human and AI players must be less than or equal to six.
487
<figure id="worm-prefs">
488
<title lang="en">Worm Preferences Tab</title>
490
<mediaobject lang="en">
492
<imagedata fileref="figures/worm_op.png" format="PNG" srccredit="Kevin Breit"/>
495
<phrase>Worm Preferences Tab.</phrase>
501
The properties in the <guilabel>Worm 1 </guilabel>through <guilabel> Worm
502
6</guilabel> tabs let you set individual preferences for the different worms.
506
<term lang="en">Keyboard controls</term>
509
This list let you change the keyboard controls for the given
510
worm. To change a control, double click on the appropriate entry and
511
then press the key you want to use for that control.
516
<term lang="en">Use relative motion</term>
519
Rather than left sending your worm toward the left of the screen,
520
right toward the right and so on, the left and right keys make
521
the worm perform a left or right turn. For example, if the worm
522
is moving to the left and you press the left control it turns to
523
head toward the bottom of the screen.
528
<term lang="en">Worm color</term>
531
Customize the color of your worm so you can tell it from your
532
opponent's worm in multi-player mode.
542
<!-- ============= Authors ================================ -->
545
<title>Authors</title>
546
<para><application>Nibbles</application> was written by Sean MacIsaac <email>sjm@acm.org</email> and Ian Peters <email>itp@gnu.org</email>. This manual was written by Kevin Breit <email>battery841@mypad.com</email>. Nibbles was updated with network support by Andreas Røsdal <email>andreasr@gnome.org</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>
548
<!-- For translations: uncomment this:
551
Latin translation was done by ME
552
(<email>MYNAME@MYADDRESS</email>). Please send all comments and
553
suggestions regarding this translation to SOMEWHERE.
561
<!-- ============= Application License ============================= -->
564
<title>Licence</title>
566
This program is free software; you can redistribute it and/or
567
modify it under the terms of the <ulink type="help" url="gnome-help:gpl">
568
<citetitle>GNU General Public
569
License</citetitle></ulink> as published by the Free Software Foundation;
570
either version 2 of the License, or (at your option) any later
573
<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>
575
A copy of the <citetitle>GNU General Public License</citetitle> is
576
included as an appendix to the <citetitle>GNOME Users
577
Guide</citetitle>. You may also obtain a copy of the
578
<citetitle>GNU General Public License</citetitle> from the Free
579
Software Foundation by visiting <ulink type="http" url="http://www.fsf.org">their Web site</ulink> or by writing to
581
Free Software Foundation, Inc.
582
59 Temple Place - Suite 330
583
Boston, MA 02111-1307