1
<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
2
<!-- if not using PNG graphic, replace reference above with
3
.....PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
5
<!ENTITY VERSION "1.2.0">
9
<!-- =============Document Header ============================= -->
11
<article id="index"> <!-- please do not change the id -->
14
<title>Gnibbles Manual</title>
17
<holder>Kevin Breit</holder>
20
<!-- translators: uncomment this:
24
<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
29
<!-- do not put authorname in the header except in copyright - use
30
section "authors" below -->
32
<legalnotice id="legalnotice">
34
Permission is granted to copy, distribute and/or modify this document
35
under the terms of the <ulink type="help" url="gnome-help:fdl">
36
<citetitle>GNU Free Documentation License</citetitle></ulink>, Version
37
1.1 or any later version published by the
38
Free Software Foundation with no Invariant Sections, no Front-Cover
39
Texts, and no Back-Cover Texts. You may obtain a copy of the
40
<citetitle>GNU Free Documentation License</citetitle> from the Free
41
Software Foundation by visiting <ulink type="http"
42
url="http://www.fsf.org">their
43
Web site</ulink> or by writing to: Free Software Foundation, Inc., 59
44
Temple Place - Suite 330, Boston, MA 02111-1307, USA.
47
Many of the names used by companies to distinguish their products and
48
services are claimed as trademarks. Where those names appear in any
49
GNOME documentation, and those trademarks are made aware to the members
50
of the GNOME Documentation Project, the names have been printed in caps
55
<!-- this is the version of manual, not application -->
57
This is version 1.0 of Gnibbles manual.
62
<!-- ============= Document Body ============================= -->
64
<!-- ============= Introduction ============================== -->
66
<title>Introduction</title>
69
<application>Gnibbles</application> is a game where the user controls a snake . The snake moves around the board, eating diamonds while avoiding the walls placed around it.
73
To run <application>Gnibbles</application>, select
75
<guisubmenu>games</guisubmenu>
76
<guimenuitem>Gnibbles</guimenuitem>
78
from the <guimenu>Main Menu</guimenu>, or type
79
<command>Gnibbles</command> on the command line.
83
<application>Gnibbles</application> is included in the
84
<filename>gnome-games</filename> package, which is part of the
85
GNOME desktop environment. This document describes version
86
&VERSION; of <application>Gnibbles</application>.
90
<sect1 id="objective">
91
<title>Gnibbles Objective</title>
93
The objective of Gnibbles is quite simple. You control the snake and
94
if the snake runs into a wall or runs into itself, you die. You get three
95
lives before your game is over. You win by either beating your own high
96
score (or a friends) or by completing all the levels.
100
<!-- ================ Usage ================================ -->
101
<!-- This section should describe basic usage of the application. -->
104
<title>Using Gnibbles</title>
106
<application>Gnibbles</application> is a simple game to play. The only keys
107
that are needed are the arrow keys.
110
<!-- ========= Basic Usage =========================== -->
112
<title>Basic usage</title>
114
Starting <application>Gnibbles</application> opens
115
the <interface>main window</interface> shown below.
116
<figure id="intro-fig">
117
<title>Gnibbles Introduction Window</title>
119
<screeninfo>Gnibbles Introduction Window</screeninfo>
120
<graphic fileref="figures/intro" format="png"
121
srccredit="Kevin Breit">
127
To start the game, click on the intro screen, shown above. The game
128
will automatically start.
131
When the game starts, the snake will come out of the left side of the
132
screen. You use the up arrow to make the direction of the snake go up.
133
Use the right arrow to turn the snake right, left arrow to turn the snake
134
left, and down arrow to turn the snake down.
135
<figure id="gameplay">
136
<title>Gnibbles During Gameplay</title>
138
<screeninfo>Gnibbles During Gameplay</screeninfo>
139
<graphic fileref="figures/playing" format="png"
140
srccredit="Kevin Breit">
147
<!-- This section should also describe main elements of graphic user
148
interface, such as menus and buttons, unless this description
149
is too long - in that case, it should be moved to a separate
150
section. For example -->
153
<!-- ========= Menus =========================== -->
157
The menu bar, located at the top of the <interface>Main
158
Window</interface>, contains the following menus:
163
<term><guimenu>Game</guimenu></term>
172
<keysym>Ctrl+N</keysym>
174
<guimenuitem>New Game</guimenuitem>
176
— This starts a new game of <application>Gnibbles</application>
182
<guimenuitem>Pause game</guimenuitem>
184
— This will pause your game. Click on the <quote>Pause Game
185
</quote> menu option to resume game.
191
<guimenuitem>Scores</guimenuitem>
193
— This shows the high scores.
200
<keysym>Ctrl-Q</keysym>
202
<guimenuitem>Exit</guimenuitem>
204
— This quits the application.
213
<term><guimenu>Settings</guimenu></term>
221
<guimenuitem>Preferences</guimenuitem>
223
— This opens your window to edit <link linkend="prefs">
233
<term><guimenu>About</guimenu></term>
240
<guimenuitem>About</guimenuitem> — This opens the
241
<interface>About</interface> dialog which shows
242
basic information about
243
<application>Gnibbles</application>, such as
244
the author's name, the application version number, and the
245
URL for the application's Web page if one exists.
254
<sect2 id="diamonds">
255
<title>Diamonds</title>
257
<application>Gnibbles</application> has numerous different diamonds
258
which to eat. They each are a different color and serve a different
262
<term>Purple Diamond</term>
265
Gives you one diamond credit and adds length to your snake.
270
<term>Yellow Diamond</term>
273
Gives 12 points, adds length to the snake and gives you one
279
<term>Red Diamond</term>
282
Gives 11 points, makes your snake shorter, and gives you one
293
<!-- ============= Customization ============================= -->
295
<title>Customization</title>
297
To change the application settings, select
299
<guimenu>Settings</guimenu>
300
<guimenuitem>Preferences...</guimenuitem>
301
</menuchoice>. This opens the
302
<interface>Preferences</interface> dialog.
305
<figure id="game-prefs">
306
<title>Game Preferences Tab</title>
308
<screeninfo>Game Preferences Tab</screeninfo>
309
<graphic fileref="figures/game" format="png" srccredit="Kevin Breit">
315
The properties in the <guilabel>Game</guilabel> tab are:
321
This controls the speed of the snake.
326
<term>Levels in random order</term>
329
Selecting this causes the level
330
advancement to happen in random order.
335
<term>Fake bonuses</term>
338
When enabled, this allows for two blue diamonds on
339
the screen at a time. One diamond makes you shrink instead of grow when
355
<figure id="graphics-prefs">
356
<title>Graphics Preferences Tab</title>
358
<screeninfo>Graphics Preferences Tab</screeninfo>
359
<graphic fileref="figures/graphics" format="png" srccredit="Kevin Breit">
364
The properties in the <guilabel>Graphics</guilabel> tab are:
369
(Tiny) — This button makes your board tiny (184x132).
375
(Small) — This button makes your board small (368x264).
381
(Medium) — This button makes your board medium (460x330).
387
(Large) — This button makes your board large(736x528).
393
(Extra Large) — This button makes your board extra large (920x660)
394
…(description).
400
(Huge) — This button makes your huge (1840x1320)
401
…(description).
408
<figure id="worm-prefs">
409
<title>Worm Preferences Tab</title>
411
<screeninfo>Worm Preferences Tab</screeninfo>
412
<graphic fileref="figures/worm_op" format="png" srccredit="Kevin Breit">
417
The properties in the <guilabel>Worm 1 </guilabel>through <guilabel> Worm
418
4</guilabel> tabs let you set controls for your different worms.
421
After you have made all the changes you want, click on
422
<guibutton>OK</guibutton> to apply the changes and close the
423
<interface>Preferences</interface> dialog. To cancel the changes
424
and return to previous values, click the
425
<guibutton>Close</guibutton> button.
431
<title>Known Bugs and Limitations</title>
433
This application has no known bugs.
438
<!-- ============= Authors ================================ -->
441
<title>Authors</title>
443
<application>Gnibbles</application> was written by Sean MacIsaac
444
(<email>sjm@acm.org</email>) and Ian Peters (<email>itp@gnu.org</email>).
445
Please send all comments, suggestions, and bug reports to
446
the authors. (Instructions for submitting bug reports can be found <ulink
447
url="http://bugs.gnome.org/Reporting.html" type="http"> on-line</ulink>.)
451
This manual was written by Kevin Breit
452
(<email>battery841@mypad.com</email>). Please send all comments and
453
suggestions regarding this manual to the <ulink type="http"
454
url="http://developer.gnome.org/projects/gdp">GNOME
455
Documentation Project</ulink>
456
by sending an email to <email>docs@gnome.org</email>. You can also
457
add your comments online by using the <ulink type="http"
458
url="http://www.gnome.org/gdp/doctable/">GNOME Documentation Status
462
<!-- For translations: uncomment this:
465
Latin translation was done by ME
466
(<email>MYNAME@MYADDRESS</email>). Please send all comments and
467
suggestions regarding this translation to SOMEWHERE.
475
<!-- ============= Application License ============================= -->
478
<title>License</title>
480
This program is free software; you can redistribute it and/or
481
modify it under the terms of the <ulink type="help" url="gnome-help:gpl">
482
<citetitle>GNU General Public
483
License</citetitle></ulink> as published by the Free Software Foundation;
484
either version 2 of the License, or (at your option) any later
488
This program is distributed in the hope that it will be useful, but
489
WITHOUT ANY WARRANTY; without even the implied warranty of
490
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
491
<citetitle>GNU General Public License</citetitle> for more details.
494
A copy of the <citetitle>GNU General Public License</citetitle> is
495
included as an appendix to the <citetitle>GNOME Users
496
Guide</citetitle>. You may also obtain a copy of the
497
<citetitle>GNU General Public License</citetitle> from the Free
498
Software Foundation by visiting <ulink type="http"
499
url="http://www.fsf.org">their Web site</ulink> or by writing to
501
Free Software Foundation, Inc.
502
<street>59 Temple Place</street> - Suite 330
503
<city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
504
<country>USA</country>
added
removed
gnibbles/help/C/gnibbles.sgml
