File: index.docbook

package info (click to toggle)
kshisen 4:18.04.1-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 2,264 kB
  • sloc: cpp: 2,444; xml: 114; makefile: 5; sh: 3
file content (554 lines) | stat: -rw-r--r-- 26,350 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
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY % English "INCLUDE" >    <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">     <!-- do not change this! -->
]>

<book id="kshisen" lang="&language;"> <!-- do not change this! -->
  <bookinfo>
    <title>The &kshisen; Handbook</title> <!-- This is the title of the docbook. Leave as is unless change is necessary.-->
    <!-- List of immidiate authors begins here. -->
    <!--INPORTANT! - All other contributors: [to be determined] -->
    <authorgroup>
      <author>
        <firstname>Dirk</firstname>
        <surname>Doerflinger</surname>
        <affiliation><address>&Dirk.Doerflinger.mail;</address></affiliation>
      </author>
      <author>
        <firstname>Eugene</firstname><surname>Trounev</surname>
        <affiliation><address><email>eugene.trounev@gmail.com</email></address></affiliation>
      </author>
      <author>
        <firstname>Frederik</firstname>
        <surname>Schwarzer</surname>
        <affiliation><address><email>schwarzer@kde.org</email></address></affiliation>
      </author>
      <othercredit role="reviewer">
        <firstname>Frerich</firstname><surname>Raabe</surname>
        <contrib>Reviewer</contrib>
        <affiliation><address>&Frerich.Raabe.mail;</address></affiliation>
      </othercredit>
      <!-- TRANS:ROLES_OF_TRANSLATORS -->
    </authorgroup>
    <legalnotice>&FDLNotice;</legalnotice>
    <date>2016-05-09</date>
    <releaseinfo>1.10 (Applications 16.04)</releaseinfo>

    <!--Short description of this document. Do not change unless necessary!-->
    <abstract>
      <para>This documentation describes the game of &kshisen; version 1.10</para>
    </abstract>

    <!--List of relevant keywords-->
    <keywordset>
      <keyword>KDE</keyword> <!-- do not change this! -->
      <keyword>kdegames</keyword> <!-- do not change this! -->
      <keyword>game</keyword> <!-- do not change this! -->
      <keyword>kshisen</keyword><!--Application name goes here-->
      <!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
      <keyword>arcade</keyword>
      <keyword>board</keyword>
      <keyword>mahjong</keyword>
      <keyword>tiles</keyword>
      <!--Number of possible players. It can be: One, Two,..., Multiplayer-->
      <keyword>one player</keyword>
    </keywordset>
  </bookinfo>
  <!--Content begins here: -->
  <chapter id="introduction"><title>Introduction</title> <!-- do not change this! -->
    <note><title>Gametype:</title><para>Arcade, Board</para></note><!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
    <note><title>Number of possible players:</title><para>One</para></note><!--Number of possible players. It can be: One, Two,..., Multiplayer-->

    <!--Short game description starts here. 3-4 sentences (paragraphs)-->
    <para>
      &kshisen; is a solitaire-like game played using the standard set of Mahjong tiles.
      Unlike Mahjong however, &kshisen; has only one layer of scrambled tiles.
      You can remove matching pieces if they can be connected with a line
      with at most two bends in it. At the same time, the line must not
      cross any other tiles.
      To win a game of &kshisen; the player has to remove all the tiles from the game board.
    </para>
  </chapter>

  <chapter id="howto"><title>How to Play</title> <!-- do not change this! -->
    <screenshot>
    <mediaobject>
    <imageobject>
    <imagedata fileref="gameboard.png" format="PNG"/>
    </imageobject>
    <textobject>
    <phrase>&kshisen; gameboard</phrase>
    </textobject>
    </mediaobject>
    </screenshot>
    <!--IMPORTANT: If the game has no defined objective, please remove the below line.-->
    <note><title>Objective:</title><para>Remove all the tiles from the game board within the shortest time possible.</para></note><!--Describe the objective of the game.-->
    <!--How to play description. Don't be to specific on rules as they have a separate section in this document-->
    <para>
      &kshisen; will load a default layout automatically once you start the game and you can start playing right away.
    </para>
    <para>
      You should carefully study the tiles lied out on the game board and find two tiles matching exactly. When you have found such a pair use your mouse to select them.
    </para>
    <para>
      Once you select a matching pair of tiles they will vanish from the game board.
      However, even if the tiles you select appear as open they will only be removed from the board if they can be connected with a line having at most two bends and not crossing any other tiles. Furthermore the line can only be drawn horizontally and vertically.
    </para>
    <para>
      Find as many matches as possible to remove all the tiles from the game board.
    </para>
  </chapter>

  <chapter id="rules_and_tips"><title>Game Rules, Strategies and Tips</title> <!-- do not change this! -->
    <sect1 id="rules">
      <title>Rules</title>
      <para>
        Standard Mahjong set of tiles includes:
        <informaltable>
          <tgroup cols="3">
            <tbody>
              <row><entry>Group name</entry><entry>Tile name</entry><entry>Quantity in a set</entry></row>
              <row><entry>Dots</entry><entry></entry><entry></entry></row>
              <row><entry></entry><entry>1 of Dots</entry><entry>2</entry></row>
              <row><entry></entry><entry>2 of Dots</entry><entry>2</entry></row>
              <row><entry></entry><entry>3 of Dots</entry><entry>2</entry></row>
              <row><entry></entry><entry>4 of Dots</entry><entry>2</entry></row>
              <row><entry></entry><entry>5 of Dots</entry><entry>2</entry></row>
              <row><entry></entry><entry>6 of Dots</entry><entry>2</entry></row>
              <row><entry></entry><entry>7 of Dots</entry><entry>2</entry></row>
              <row><entry></entry><entry>8 of Dots</entry><entry>2</entry></row>
              <row><entry></entry><entry>9 of Dots</entry><entry>2</entry></row>
              <row><entry>Bamboos</entry><entry></entry><entry></entry></row>
              <row><entry></entry><entry>1 of Bamboos</entry><entry>2</entry></row>
              <row><entry></entry><entry>2 of Bamboos</entry><entry>2</entry></row>
              <row><entry></entry><entry>3 of Bamboos</entry><entry>2</entry></row>
              <row><entry></entry><entry>4 of Bamboos</entry><entry>2</entry></row>
              <row><entry></entry><entry>5 of Bamboos</entry><entry>2</entry></row>
              <row><entry></entry><entry>6 of Bamboos</entry><entry>2</entry></row>
              <row><entry></entry><entry>7 of Bamboos</entry><entry>2</entry></row>
              <row><entry></entry><entry>8 of Bamboos</entry><entry>2</entry></row>
              <row><entry></entry><entry>9 of Bamboos</entry><entry>2</entry></row>
              <row><entry>Characters</entry><entry></entry><entry></entry></row>
              <row><entry></entry><entry>1 of Characters</entry><entry>2</entry></row>
              <row><entry></entry><entry>2 of Characters</entry><entry>2</entry></row>
              <row><entry></entry><entry>3 of Characters</entry><entry>2</entry></row>
              <row><entry></entry><entry>4 of Characters</entry><entry>2</entry></row>
              <row><entry></entry><entry>5 of Characters</entry><entry>2</entry></row>
              <row><entry></entry><entry>6 of Characters</entry><entry>2</entry></row>
              <row><entry></entry><entry>7 of Characters</entry><entry>2</entry></row>
              <row><entry></entry><entry>8 of Characters</entry><entry>2</entry></row>
              <row><entry></entry><entry>9 of Characters</entry><entry>2</entry></row>
              <row><entry>Winds</entry><entry></entry><entry></entry></row>
              <row><entry></entry><entry>East Wind</entry><entry>2</entry></row>
              <row><entry></entry><entry>South Wind</entry><entry>2</entry></row>
              <row><entry></entry><entry>West Wind</entry><entry>2</entry></row>
              <row><entry></entry><entry>North Wind</entry><entry>2</entry></row>
              <row><entry>Dragons</entry><entry></entry><entry></entry></row>
              <row><entry></entry><entry>Red Dragon</entry><entry>2</entry></row>
              <row><entry></entry><entry>Green Dragon</entry><entry>2</entry></row>
              <row><entry></entry><entry>White Dragon</entry><entry>2</entry></row>
              <row><entry>Flowers</entry><entry></entry><entry></entry></row>
              <row><entry></entry><entry>Plum (1)</entry><entry>1</entry></row>
              <row><entry></entry><entry>Lily (2)</entry><entry>1</entry></row>
              <row><entry></entry><entry>Chrysanthemum (3)</entry><entry>1</entry></row>
              <row><entry></entry><entry>Bamboo (4)</entry><entry>1</entry></row>
              <row><entry>Seasons</entry><entry></entry><entry></entry></row>
              <row><entry></entry><entry>Spring (1)</entry><entry>1</entry></row>
              <row><entry></entry><entry>Summer (2)</entry><entry>1</entry></row>
              <row><entry></entry><entry>Autumn (3)</entry><entry>1</entry></row>
              <row><entry></entry><entry>Winter (4)</entry><entry>1</entry></row>
            </tbody>
          </tgroup>
        </informaltable>
      </para>
      <itemizedlist>
        <listitem><para>Matching tiles are such tiles where the face pictograms match exactly.</para></listitem>
      </itemizedlist>
      <note><title>Note:</title><para>There are exceptions to this
          rule. In the traditional game of Mahjong each tile has
          a matching one except for the <quote>Flowers</quote>
          and <quote>Seasons</quote> tiles.</para>
      </note>
      <itemizedlist>
        <listitem><para>The <quote>Flowers</quote> tiles have no doubles in the set and can be matched directly to each other.</para></listitem>
        <listitem><para>The <quote>Seasons</quote> tiles have no doubles in the set and can be matched directly to each other.</para></listitem>
        <listitem><para>Tiles can only be removed if they can be connected with a maximum of three connected lines that do not cross any other tile. Lines can be horizontal or vertical, but not diagonal.</para></listitem>
      </itemizedlist>
      <note><title>Note:</title><para>You do not have to draw the lines by yourself, the game does this for
              you. Just mark two matching tiles on the board, if they can be connected by a line with at most two bends, the line is drawn and the tiles are removed.</para>
      </note>
      <itemizedlist>
        <listitem><para>Lines may only cross empty areas of the board.</para></listitem>
        <listitem><para>Some games are unsolvable. If you would like to avoid unsolvable games check the option <guilabel>Create solvable games only</guilabel> in the configuration dialog.</para></listitem>
        <listitem><para>The scores are awarded for the time the player needs to remove all the tiles from the game board. Games with more tiles give more scores.</para></listitem>
        <listitem><para>If you played with the <guilabel>Gravity</guilabel> setting enabled, the score will be doubled.</para></listitem>
        <listitem><para>To be eligible for a place amongst the high scores player has to complete a game instance within the shortest period of time possible.</para></listitem>
      </itemizedlist>
      <note><title>Note:</title><para>If the player uses the <quote>Undo</quote> or <quote>Hint</quote> feature the record will not be considered as a high score.</para></note>
    </sect1>
    <sect1 id="tips">
      <title>Tips</title>
      <para>
        Click on a tile with the &RMB; to highlight all matching tiles on the board.
        Unlike using the <quote>Undo</quote> or <quote>Hint</quote> feature, this
        help is allowed without being considered cheating.
      </para>
    </sect1>
  </chapter>

  <chapter id="interface"><title>Interface Overview</title> <!-- do not change this! -->
    <!-- This section has to do with menubar. Describe every single entry in order. Use <variablelist> and <varlistentry>. Split the chapter into sections using <sect1(2,3)> for better viewing. -->
    <sect1 id="menu">
    <title>Menu Items</title>
    <sect2 id="game-menu">
      <title>The Game Menu</title>

      <para>
        The <guimenu>Game</guimenu> menu lets you control the status of the current game:
      </para>

      <variablelist>
        <varlistentry id="game-menu-new">
          <term>
            <menuchoice>
              <shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
              <guimenu>Game</guimenu><guimenuitem>New</guimenuitem>
            </menuchoice>
          </term>
          <listitem><para><action>Finishes the current game</action> and starts a new session with new tiles.</para></listitem>
        </varlistentry>

        <varlistentry id="game-menu-restart">
          <term>
            <menuchoice>
              <shortcut><keycombo><keycap>F5</keycap></keycombo></shortcut>
              <guimenu>Game</guimenu><guimenuitem>Restart Game</guimenuitem>
            </menuchoice>
          </term>
          <listitem><para><action>Restarts the current game with the same tiles.</action></para></listitem>
        </varlistentry>

        <varlistentry id="game-menu-pause">
          <term>
            <menuchoice>
              <shortcut><keycombo><keycap>P</keycap></keycombo></shortcut>
              <guimenu>Game</guimenu><guimenuitem>Pause</guimenuitem>
            </menuchoice>
          </term>
          <listitem><para><action>Pauses the game</action>, especially the timer which affects the scoring. The menu entry is also used for resuming the game.</para></listitem>
        </varlistentry>

        <varlistentry id="game-menu-highscores">
          <term>
            <menuchoice>
              <shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></shortcut>
              <guimenu>Game</guimenu><guimenuitem>Show High Scores</guimenuitem>
            </menuchoice>
          </term>
          <listitem><para>Shows your top ten charts of &kshisen;.</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> &kshisen;.</para></listitem>
        </varlistentry>

      </variablelist>

      <para>
        Some of the menu items can also be controlled by keyboard shortcuts.
        See <xref linkend="key-bindings"/> for a list.
      </para>

    </sect2>

    <sect2 id="move-menu">
      <title>The Move Menu</title>

      <variablelist id="move-menu-undo">
        <varlistentry>
          <term>
            <menuchoice>
              <shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
              <guimenu>Move</guimenu><guimenuitem>Undo</guimenuitem>
            </menuchoice>
          </term>
          <listitem><para><action>Undoes the last step</action>. Same as the <guibutton>Undo</guibutton> button in the toolbar.</para></listitem>
        </varlistentry>

        <varlistentry id="move-menu-redo">
          <term>
            <menuchoice>
              <shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut>
              <guimenu>Move</guimenu><guimenuitem>Redo</guimenuitem>
            </menuchoice>
          </term>
          <listitem><para><action>Redoes the last step</action>. Same as the <guibutton>Redo</guibutton> button in the toolbar.</para></listitem>
        </varlistentry>

        <varlistentry id="move-menu-hint">
          <term>
            <menuchoice>
              <shortcut><keycombo><keycap>H</keycap></keycombo></shortcut>
              <guimenu>Move</guimenu><guimenuitem>Hint</guimenuitem>
            </menuchoice>
          </term>
          <listitem><para><action>Shows a hint</action>, which two tiles to remove next.</para></listitem>
        </varlistentry>

      </variablelist>

    </sect2>

    <sect2 id="settings-menu">
      <title>The Settings Menu</title>

      <variablelist>
        <varlistentry>
          <term>
            <menuchoice>
              <guimenu>Settings</guimenu><guimenuitem>Play Sounds</guimenuitem>
            </menuchoice>
          </term>
          <listitem><para>Plays a sound when you touch a tile by clicking with it the &LMB;
               and when a tile is falling down playing with <guilabel>Gravity</guilabel> enabled.</para></listitem>
        </varlistentry>

        <varlistentry id="game-settings-settings">
          <term>
            <menuchoice>
              <guimenu>Settings</guimenu><guimenuitem>Configure &kshisen;...</guimenuitem>
            </menuchoice>
          </term>
          <listitem><para>Opens the <link linkend="configuration">configuration dialog</link> to change &kshisen; settings.</para></listitem>
        </varlistentry>

      </variablelist>
      <para>
	Additionally &kshisen; 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/ui.html#menus-settings">Settings Menu</ulink> and
	<ulink url="help:/fundamentals/ui.html#menus-help">Help Menu</ulink>
	of the &kde; Fundamentals.
      </para>
    </sect2>
    </sect1>

    <sect1 id="key-bindings">
      <title>Default Key Bindings</title>

      <para>Default shortcuts are:</para>

      <informaltable>
        <tgroup cols="2">
          <tbody>
            <row><entry>New</entry><entry><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></entry></row>
            <row><entry>Restart Game</entry><entry><keycap>F5</keycap></entry></row>
            <row><entry>Pause</entry><entry><keycap>P</keycap></entry></row>
            <row><entry>Show High Scores</entry><entry><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></entry></row>
            <row><entry>Quit</entry><entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></entry></row>
            <row><entry>Undo</entry><entry><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></entry></row>
            <row><entry>Redo</entry><entry><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></entry></row>
            <row><entry>Hint</entry><entry><keycap>H</keycap></entry></row>
            <row><entry>&kshisen; Handbook</entry><entry><keycap>F1</keycap></entry></row>
            <row><entry>What's This</entry><entry><keycombo action="simul">&Ctrl;&Shift;<keycap>F1</keycap></keycombo></entry></row>
          </tbody>
        </tgroup>
      </informaltable>

    </sect1>

  </chapter>

  <chapter id="faq"><title>Frequently asked questions</title> <!-- do not change this! -->
    <!--This chapter is for frequently asked questions. Please use <qandaset> <qandaentry> only!-->
    <qandaset>
      <qandaentry>
        <question><para>I want to change the way this game looks. Can I?</para></question>
        <answer><para>Yes. To change the way &kshisen; looks use the <link linkend="game-settings-settings">menubar</link> to open the <link linkend="configuration">configuration utility</link>.</para></answer>
      </qandaentry>
      <qandaentry>
        <question><para>Can I use keyboard?</para></question>
        <answer><para>No. This game does not feature a keyboard play mode.</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>No. This game does not feature a <quote>Save</quote> option.</para></answer>
      </qandaentry>
    </qandaset>
  </chapter>

  <chapter id="configuration"><title>Game Configuration</title> <!-- do not change this! -->
    <!--This section describes configuration GUI. If your game is configured using menubar exclusively, please remove this section.-->
    <para>
      Selecting the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kshisen;...</guimenuitem></menuchoice>
      menu item will open a configuration dialog which lets you alter the behavior of the game.
    </para>

    <screenshot>
      <screeninfo>&kshisen; configuration dialog</screeninfo>
      <mediaobject>
        <imageobject><imagedata fileref="kshisen-configuration.png" format="PNG"/></imageobject>
        <textobject><phrase>&kshisen; configuration dialog</phrase></textobject>
      </mediaobject>
    </screenshot>

    <variablelist>
      <title><guilabel>General</guilabel> page</title>
      <varlistentry>
        <term><guilabel>Gravity</guilabel></term>
        <listitem><para>
            Checking this makes the game even harder: If a tile is removed,
            all tiles lying above it will fall down one step.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guilabel>Create solvable games only</guilabel></term>
        <listitem><para>
            If checked, you will only be presented with games that are possible to solve.
            Note: Even in solvable games you can fail to complete if you remove the tiles 
            in the wrong order.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guilabel>Use Chinese style: any flower match any flower, any season match any season</guilabel></term>
        <listitem><para>
            Use the traditional rules for matching the tiles. Previous
            version of &kshisen; used to allow only exact tiles matches, which is
            inconsistent with Mahjong rules. It is recommended
            to keep this option checked.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guilabel>Tiles can slide, but you can connect only in 2 lines instead of 3</guilabel></term>
        <listitem><para>
            This option changes the rules to the point where it almost
            becomes a completely different game. When it is active, you can remove
            the tiles only if they can be connected by a line consisting of one or two segments
            instead of the customary three. However, you are allowed to slide the tiles
            on the board, if the row or column where they are placed has some empty space.
            To make a sliding move, you have to click first on the tile in the column or
            row that can slide, and then on the matching tile. If there are two possible
            sliding moves, blue lines are shown indicating these moves. You then have to click
            on one of the two lines to choose your preferred move.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guilabel>Board Difficulty</guilabel></term>
        <listitem><para>
            The slider controls the difficulty of the board (i.e. how much the tiles are shuffled) from <guilabel>Easy</guilabel> to <guilabel>Hard</guilabel>.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guilabel>Piece Removal Speed</guilabel></term>
        <listitem><para>
            Adjusting this slider alters the speed at which the pieces are removed from the screen after a match has been made.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guilabel>Board Size</guilabel></term>
        <listitem><para>
            This slider allows you to change the number of tiles
            on the board. The more tiles you have, the harder (and longer)
            the game will be.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guilabel>Tiles</guilabel> and <guilabel>Background</guilabel> page</term>
        <listitem><para>
            Select you favorite design for tiles and background.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guibutton>Help</guibutton></term>
        <listitem><para>
            Opens &kshisen; help pages (this document).
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guibutton>OK</guibutton></term>
        <listitem><para>
            Saves your changes and closes the dialog.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guibutton>Apply</guibutton></term>
        <listitem><para>
            Saves your changes but does not close the dialog.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guibutton>Cancel</guibutton></term>
        <listitem><para>
            Discards all your changes and closes the dialog.
        </para></listitem>
      </varlistentry>

    </variablelist>

  </chapter>

  <chapter id="credits"><title>Credits and License</title> <!-- do not change this! -->
    <!--This chapter is for credits and licenses.-->

    <para>
      &kshisen; Copyright 1997 &Mario.Weilguni; &Mario.Weilguni.mail;
    </para>
    <para>
      &kshisen; Copyright 2002-2004 Dave Corrie <email>kde@davecorrie.com</email>
    </para>
    <para>
      &kshisen; Copyright 2009-2012 &Frederik.Schwarzer; &Frederik.Schwarzer.mail;
    </para>

    <para>
      Documentation Copyright 2000 &Dirk.Doerflinger; <email>ddoerflinger@gmx.net</email>
    </para>
    <para>
      Documentation Copyright 2009-2010 &Frederik.Schwarzer; &Frederik.Schwarzer.mail;
    </para>

    <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
    &underFDL;
    &underGPL;

    <!-- !!!do not change ANYTHING after this line!!!! -->

  </chapter>

  &documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-omittag:t
sgml-shorttag:t
sgml-namecase-general:t
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:nil
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->