File: index.docbook

package info (click to toggle)
kapman 4:20.12.1-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 3,588 kB
  • sloc: cpp: 2,793; xml: 208; makefile: 8; sh: 2
file content (322 lines) | stat: -rw-r--r-- 13,064 bytes parent folder | download | duplicates (2)
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
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>

<book id="kapman" lang="&language;">
<bookinfo>
<title>The &kapman; Handbook</title>

<authorgroup>
<author>
<personname>
<firstname>Thomas</firstname>
<surname>Gallinari</surname>
</personname>
<email>tg8187@yahoo.fr</email>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<copyright>
<year>2008</year>
<holder>Thomas Gallinari</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>

<date>2016-05-09</date>
<releaseinfo>1.1.0 (Applications 16.04)</releaseinfo>

<abstract>
<para>&kapman; is a clone of the well known game <application>Pac-Man</application>.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>kdegames</keyword>
<keyword>Kapman</keyword>
<keyword>arcade</keyword>
<keyword>one player</keyword>
<keyword>pac-man</keyword>
<keyword>pacman</keyword>
<keyword>ghost</keyword>
<keyword>pill</keyword>
<keyword>energizer</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>
<note><title>Gametype:</title><para>Arcade</para></note>
<note><title>Number of possible players:</title><para>One</para></note>
<para>
&kapman; is a clone of the well known game <application>Pac-Man</application>. You must go through the levels escaping ghosts in a maze. You lose a life when a ghost eats you, but you can eat the ghosts for a few seconds when eating an energizer. You win points when eating pills, energizers, and bonus, and you win one life for each 10,000 points. When you have eaten all the pills and energizers of a level, you go to the next level, and the player and ghost speeds increase. The game ends when you have lost all your lives.
</para>
<screenshot>
<screeninfo>A &kapman; screenshot</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kapman.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>A &kapman; screenshot</phrase>
</textobject>
</mediaobject>
</screenshot>
</chapter>

<chapter id="howto">
<title>How to Play</title>
<note><title>Objective:</title><para>Go through the levels by eating all pills and energizers.</para></note>
<para>
&kapman; will load level one once you start the game. To start the game, press an arrow key. You move straight ahead without pressing any key. To turn, press an arrow key. You should not turn at the last moment, but anticipate and you will turn as soon as possible. To eat a pill, an energizer, a bonus, or even a ghost, you must get in touch with it. When all the pills and energizers have been eaten, you move to the next level.
</para>
</chapter>

<chapter id="rules_and_tips"><title>Game Rules, Strategies and Tips</title>
<sect1 id="rules">
<title>Rules</title>
<para>
<itemizedlist>
<listitem><para>To move to the next level, you must eat every pill and energizer in the maze.</para></listitem>
<listitem><para>A bonus appears when you have eaten 1/3 and 2/3 of the pills and energizers. It disappears after a few seconds (10 seconds at the first level, but it decreases as the level increases) if you have not eaten it.</para></listitem>
<listitem><para>As the level increases, both your speed and the ghosts speed increase. However, the ghosts will be more and more faster than you.</para></listitem>
<listitem><para>If you get in touch with a ghost, you lose a life, and the current level restarts (but the eaten pills and energizer do not reappear).</para></listitem>
<listitem><para>If you are in the line of sight of a ghost (that is to say : no wall between the ghost, and both of you go to the same direction), the ghost will hunt you. Otherwise, the ghosts have a random moving.</para></listitem>
<listitem><para>When you eat an energizer, the ghosts slow down and you can eat them. If you eat a ghost, it goes back to its home and its normal behaviour. After a few seconds (10 seconds at the first level, but it decreases as the level increases), the ghosts that have not been eaten go back to their normal behaviour.</para></listitem>
<listitem><para>You win points when eating an item:</para>
<table>
<title>Item values</title>
<tgroup cols="2">
<tbody>
<row>
<entry>Pill</entry>
<entry>10 points</entry>
</row>
<row>
<entry>Energizer</entry>
<entry>20 points</entry>
</row>
<row>
<entry>Bonus</entry>
<entry>Current level * 100 points</entry>
</row>
<row>
<entry>Ghost</entry>
<entry>It depends on the number of ghosts you have eaten since the last energizer was eaten:
<itemizedlist>
<listitem><para>1st ghost: 100 points</para></listitem>
<listitem><para>2nd ghost: 200 points</para></listitem>
<listitem><para>3rd ghost: 400 points</para></listitem>
<listitem><para>4th ghost: 800 points</para></listitem>
</itemizedlist>
</entry>
</row>
</tbody>
</tgroup>
</table>
</listitem>
<listitem><para>You get a life more every 10,000 points you win.</para></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="tips">
<title>Strategies and Tips</title>
<para>
<itemizedlist>
<listitem><para>To eat an item, you must get it touch with its center, not only a few pixels. So be sure you have really eaten what you wanted, before turning back.</para></listitem>
<listitem><para>At first levels, the bonus does not make a lot of points and ghosts are not very fast, so you should concentrate on eating the most ghosts that you can.</para></listitem>
<listitem><para>After about ten levels, the ghosts are faster and the bonus makes more points, so you should try to eat the bonus when possible. Do not hesitate to eat an energizer when you can see the bonus, to not be disturbed by the ghosts.</para></listitem>
<listitem><para>In the same way, you should try to eat an energizer before going to the dangerous places (like near the ghost home).</para></listitem>
<listitem><para>When the ghosts are too fast, you should avoid to eat them if you are near their home. They could go back faster than you think.</para></listitem>
<listitem><para>Do not hesitate to stay in the same place for a few seconds, waiting for the ghosts to go far away from the place you need to go.</para></listitem>
<listitem><para>You can find cheatcodes from the source code. But be careful: if you make a new high score but have cheated, your high score will not be registered.</para></listitem>
<listitem><para>Last but not least: Have fun !</para></listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="interface"><title>Interface Overview</title>
<sect1 id="menu">
<title>Menu Items</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
<guimenu>Game</guimenu><guimenuitem>New</guimenuitem>
</menuchoice></term>
<listitem><para><action>Starts a new game.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></shortcut>
<guimenu>Game</guimenu><guimenuitem>Show High Scores</guimenuitem>
</menuchoice></term>
<listitem><para><action>Brings up the high scores dialog.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Game</guimenu><guimenuitem>Change Level</guimenuitem>
</menuchoice></term>
<listitem><para><action>Brings up the level selection dialog. Be careful: changing the current level will make the game consider you as a cheater, so you will not able to register in the high scores table.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut>
<guimenu>Game</guimenu><guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Quits</action> &kapman;.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Play Sounds</guimenuitem>
</menuchoice></term>
<listitem><para><action>Plays the sounds or mutes.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guisubmenu>Difficulty</guisubmenu>
</menuchoice></term>
<listitem>
<para><action>Adjusts the game difficulty to <guimenuitem>Easy</guimenuitem>,
<guimenuitem>Medium</guimenuitem> or <guimenuitem>Hard</guimenuitem>.</action></para>
</listitem>
</varlistentry>
</variablelist>
<para>
Additionally &kapman; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings"
>Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
of the &kde; Fundamentals.
</para>
</sect1>

<sect1 id="keybindings">
<title>Default Keybindings</title>
<para>
<itemizedlist>
<listitem><para><action>Turn up</action> - <keysym>Up Arrow</keysym></para></listitem>
<listitem><para><action>Turn down</action> - <keysym>Down Arrow</keysym></para></listitem>
<listitem><para><action>Turn right</action> - <keysym>Right Arrow</keysym></para></listitem>
<listitem><para><action>Turn left</action> - <keysym>Left Arrow</keysym></para></listitem>
<listitem><para><action>Pause</action> - <keycap>P</keycap> or &Esc;</para></listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="faq">
<title>Questions and Answers</title>

<qandaset id="faqlist">
<qandaentry>
<question>
<para>I want to change the way this game looks. Can I?</para>
</question>
<answer>
<para>You can select the &kapman; theme in the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Kapman...</guimenuitem></menuchoice> dialog. See the <link linkend="configuration">Game Configuration</link> chapter for more details.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>Can I skip a level?</para>
</question>
<answer>
<para>There are two ways to change the current level. In both cases, you will be considered as a cheater and you will not be able to register to the high scores. The first way is using a cheatcode. I let you find it. The other way is selecting the level you want from the <menuchoice><guimenu>Game</guimenu><guimenuitem>Change Level</guimenuitem></menuchoice> dialog. See the <link linkend="menu">Menubar</link> section for more details.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>Can I change default keyboard shortcuts?</para>
</question>
<answer>
<para>It is not possible for now. But will be a new feature in a future version of &kapman;. See the <link linkend="keybindings">Default Keybindings</link> section for more details.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>I have to quit the game now, but I am not finished yet. Can I save my progress?</para>
</question>
<answer>
<para>You can not, and it is deliberate. We think that the game would be too easy if you could save the game and reload it as you lose your lives.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>How can I get more lives?</para>
</question>
<answer>
<para>There are two ways to get lives. The first one is using a cheatcode. I let you find it. The other way is winning points. Every 10,000 points, you get a life more. See the <link linkend="rules">Rules</link> section for more details.</para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="configuration"><title>Game Configuration</title>
<para>
	You can select the theme you want to play &kapman;. To do that, select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Kapman...</guimenuitem></menuchoice>. The &kapman; configuration dialog (see below) appears and you can then select the theme. It is immediately changed on validating your choice, no need to restart the game. You can click on the <guibutton>Defaults</guibutton> button to restore the default theme.
</para>
<screenshot>
<screeninfo>The &kapman; configuration dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="config.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>The &kapman; configuration dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
</chapter>

<chapter id="credits"><title>Credits and License</title>
<para>
&kapman;
</para>
<para>
Program copyright 2008 Thomas Gallinari <email>tg8187@yahoo.fr</email>
</para>
<para>
Program copyright 2008 Pierre-Benoit Besse <email>besse.pb@gmail.com</email>
</para>
<para>
Program copyright 2008 Alexandre Galinier <email>blluetroy@hotmail.com</email>
</para>
<para>
Program copyright 2008 Nathalie Liesse <email>nathalie.liesse@gmail.com</email>
</para>
<para>
Graphics copyright 2008 Thomas Gallinari <email>tg8187@yahoo.fr</email>
</para>
<para>
Documentation copyright 2008 Thomas Gallinari <email>tg8187@yahoo.fr</email>
</para>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL;
&underGPL;

</chapter>

&documentation.index;

</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->