index.docbook 26.1 KB
Newer Older
Burkhard Lück's avatar
Burkhard Lück committed
1
<?xml version="1.0" ?>
Laurent Montel's avatar
Laurent Montel committed
2
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
3
4
  <!ENTITY % English "INCLUDE" >    <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">     <!-- do not change this! -->
5
]>
6

Luigi Toscano's avatar
Luigi Toscano committed
7
<book id="kshisen" lang="&language;"> <!-- do not change this! -->
8
  <bookinfo>
9
    <title>The &kshisen; Handbook</title> <!-- This is the title of the docbook. Leave as is unless change is necessary.-->
10
11
12
13
14
15
16
17
18
19
20
21
    <!-- 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>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
22
      <author>
23
24
        <firstname>Frederik</firstname>
        <surname>Schwarzer</surname>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
25
        <affiliation><address><email>schwarzer@kde.org</email></address></affiliation>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
26
      </author>
27
28
29
30
31
32
33
      <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>
34
    <legalnotice>&FDLNotice;</legalnotice>
35
36
    <date>2021-06-05</date>
    <releaseinfo>KDE Gear 21.08</releaseinfo>
37
38
39

    <!--Short description of this document. Do not change unless necessary!-->
    <abstract>
40
      <para>This documentation describes the game of &kshisen; version 1.10</para>
41
42
43
44
45
46
47
48
    </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-->
Frederik Schwarzer's avatar
Frederik Schwarzer committed
49
      <!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
50
51
      <keyword>arcade</keyword>
      <keyword>board</keyword>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
52
      <keyword>mahjong</keyword>
53
54
55
56
57
58
59
      <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! -->
Frederik Schwarzer's avatar
Frederik Schwarzer committed
60
    <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.-->
61
62
63
64
    <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>
65
66
      &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.
67
      You can remove matching pieces if they can be connected with a line
Frederik Schwarzer's avatar
Frederik Schwarzer committed
68
      with at most two bends in it. At the same time, the line must not
69
      cross any other tiles.
70
      To win a game of &kshisen; the player has to remove all the tiles from the game board.
71
72
73
74
    </para>
  </chapter>

  <chapter id="howto"><title>How to Play</title> <!-- do not change this! -->
75
76
77
78
79
80
81
82
83
84
    <screenshot>
    <mediaobject>
    <imageobject>
    <imagedata fileref="gameboard.png" format="PNG"/>
    </imageobject>
    <textobject>
    <phrase>&kshisen; gameboard</phrase>
    </textobject>
    </mediaobject>
    </screenshot>
85
    <!--IMPORTANT: If the game has no defined objective, please remove the below line.-->
Frederik Schwarzer's avatar
Frederik Schwarzer committed
86
    <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.-->
87
88
    <!--How to play description. Don't be to specific on rules as they have a separate section in this document-->
    <para>
89
      &kshisen; will load a default layout automatically once you start the game and you can start playing right away.
90
91
    </para>
    <para>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
92
      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.
93
94
    </para>
    <para>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
95
96
      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.
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
    </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
Frederik Schwarzer's avatar
Frederik Schwarzer committed
169
          rule. In the traditional game of Mahjong each tile has
170
          a matching one except for the <quote>Flowers</quote>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
171
172
          and <quote>Seasons</quote> tiles.</para>
      </note>
173
      <itemizedlist>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
174
175
176
        <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>
177
      </itemizedlist>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
178
179
180
      <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>
181
      <itemizedlist>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
182
        <listitem><para>Lines may only cross empty areas of the board.</para></listitem>
Burkhard Lück's avatar
Burkhard Lück committed
183
        <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>
184
185
186
187
        <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>
188
      <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>
189
    </sect1>
190
191
192
193
194
195
196
197
    <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>
198
199
200
201
  </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. -->
202
203
204
    <sect1 id="menu">
    <title>Menu Items</title>
    <sect2 id="game-menu">
Burkhard Lück's avatar
Burkhard Lück committed
205
      <title>The Game Menu</title>
206
207
208
209
210
211
212
213
214

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

      <variablelist>
        <varlistentry id="game-menu-new">
          <term>
            <menuchoice>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
215
              <shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
216
217
218
              <guimenu>Game</guimenu><guimenuitem>New</guimenuitem>
            </menuchoice>
          </term>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
219
          <listitem><para><action>Finishes the current game</action> and starts a new session with new tiles.</para></listitem>
220
221
222
223
224
225
226
227
228
        </varlistentry>

        <varlistentry id="game-menu-restart">
          <term>
            <menuchoice>
              <shortcut><keycombo><keycap>F5</keycap></keycombo></shortcut>
              <guimenu>Game</guimenu><guimenuitem>Restart Game</guimenuitem>
            </menuchoice>
          </term>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
229
          <listitem><para><action>Restarts the current game with the same tiles.</action></para></listitem>
230
231
232
233
234
235
236
237
238
        </varlistentry>

        <varlistentry id="game-menu-pause">
          <term>
            <menuchoice>
              <shortcut><keycombo><keycap>P</keycap></keycombo></shortcut>
              <guimenu>Game</guimenu><guimenuitem>Pause</guimenuitem>
            </menuchoice>
          </term>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
239
          <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>
240
241
242
243
244
245
246
247
248
        </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>
249
          <listitem><para>Shows your top ten charts of &kshisen;.</para></listitem>
250
251
252
253
254
255
256
257
258
        </varlistentry>

        <varlistentry>
          <term>
            <menuchoice>
              <shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut>
              <guimenu>Game</guimenu><guimenuitem>Quit</guimenuitem>
            </menuchoice>
          </term>
259
          <listitem><para><action>Quits</action> &kshisen;.</para></listitem>
260
261
262
263
264
265
266
267
268
        </varlistentry>

      </variablelist>

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

269
    </sect2>
270

271
    <sect2 id="move-menu">
Burkhard Lück's avatar
Burkhard Lück committed
272
      <title>The Move Menu</title>
273
274
275
276
277
278
279
280
281

      <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>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
282
          <listitem><para><action>Undoes the last step</action>. Same as the <guibutton>Undo</guibutton> button in the toolbar.</para></listitem>
283
284
285
286
287
288
289
290
291
        </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>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
292
          <listitem><para><action>Redoes the last step</action>. Same as the <guibutton>Redo</guibutton> button in the toolbar.</para></listitem>
293
294
295
296
297
298
299
300
301
        </varlistentry>

        <varlistentry id="move-menu-hint">
          <term>
            <menuchoice>
              <shortcut><keycombo><keycap>H</keycap></keycombo></shortcut>
              <guimenu>Move</guimenu><guimenuitem>Hint</guimenuitem>
            </menuchoice>
          </term>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
302
          <listitem><para><action>Shows a hint</action>, which two tiles to remove next.</para></listitem>
303
304
305
306
        </varlistentry>

      </variablelist>

307
    </sect2>
308

309
    <sect2 id="settings-menu">
Burkhard Lück's avatar
Burkhard Lück committed
310
      <title>The Settings Menu</title>
311
312

      <variablelist>
Burkhard Lück's avatar
Burkhard Lück committed
313
314
315
316
317
318
319
320
321
322
        <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>

323
324
325
        <varlistentry id="game-settings-settings">
          <term>
            <menuchoice>
326
              <guimenu>Settings</guimenu><guimenuitem>Configure &kshisen;...</guimenuitem>
327
328
            </menuchoice>
          </term>
329
          <listitem><para>Opens the <link linkend="configuration">configuration dialog</link> to change &kshisen; settings.</para></listitem>
330
331
332
        </varlistentry>

      </variablelist>
333
334
335
      <para>
	Additionally &kshisen; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
	menu items, for more information read the sections about the
336
337
	<ulink url="help:/fundamentals/menus.html#menus-settings">Settings Menu</ulink> and
	<ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
338
339
	of the &kde; Fundamentals.
      </para>
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
    </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>
364
365
366
367
368
369
370
371
372
373

    </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>
374
        <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>
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
      </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>
390
      Selecting the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kshisen;...</guimenuitem></menuchoice>
391
392
393
394
      menu item will open a configuration dialog which lets you alter the behavior of the game.
    </para>

    <screenshot>
395
      <screeninfo>&kshisen; configuration dialog</screeninfo>
396
397
      <mediaobject>
        <imageobject><imagedata fileref="kshisen-configuration.png" format="PNG"/></imageobject>
398
        <textobject><phrase>&kshisen; configuration dialog</phrase></textobject>
399
400
401
402
      </mediaobject>
    </screenshot>

    <variablelist>
Burkhard Lück's avatar
Burkhard Lück committed
403
      <title><guilabel>General</guilabel> page</title>
404
405
406
407
408
409
410
411
412
      <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>
Burkhard Lück's avatar
Burkhard Lück committed
413
        <term><guilabel>Create solvable games only</guilabel></term>
414
        <listitem><para>
Burkhard Lück's avatar
Burkhard Lück committed
415
416
417
            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.
418
419
420
        </para></listitem>
      </varlistentry>

421
422
423
424
425
426
427
428
      <varlistentry>
        <term><guilabel>Show message if board can no longer be solved</guilabel></term>
        <listitem><para>
            If checked, &kshisen; will try to analyze solvability of each game position and show a message to abort
            the game in case there are no possible moves left to win the game.
        </para></listitem>
      </varlistentry>

429
      <varlistentry>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
430
        <term><guilabel>Use Chinese style: any flower match any flower, any season match any season</guilabel></term>
431
432
        <listitem><para>
            Use the traditional rules for matching the tiles. Previous
433
            version of &kshisen; used to allow only exact tiles matches, which is
Frederik Schwarzer's avatar
Frederik Schwarzer committed
434
            inconsistent with Mahjong rules. It is recommended
435
436
437
438
439
440
441
442
            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
443
444
            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
445
446
            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.
447
            To make a sliding move, you have to click first on the tile in the column or
448
            row that can slide, and then on the matching tile. If there are two possible
449
450
            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.
451
452
453
454
455
456
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guilabel>Board Difficulty</guilabel></term>
        <listitem><para>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
457
            The slider controls the difficulty of the board (i.e. how much the tiles are shuffled) from <guilabel>Easy</guilabel> to <guilabel>Hard</guilabel>.
458
459
460
461
462
463
464
465
466
467
468
        </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>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
469
        <term><guilabel>Board Size</guilabel></term>
470
        <listitem><para>
Burkhard Lück's avatar
Burkhard Lück committed
471
            This slider allows you to change the number of tiles
472
473
474
475
476
            on the board. The more tiles you have, the harder (and longer)
            the game will be.
        </para></listitem>
      </varlistentry>

Burkhard Lück's avatar
Burkhard Lück committed
477
478
479
480
481
482
483
      <varlistentry>
        <term><guilabel>Tiles</guilabel> and <guilabel>Background</guilabel> page</term>
        <listitem><para>
            Select you favorite design for tiles and background.
        </para></listitem>
      </varlistentry>

484
485
486
      <varlistentry>
        <term><guibutton>Help</guibutton></term>
        <listitem><para>
487
            Opens &kshisen; help pages (this document).
488
489
490
491
492
493
494
495
496
497
498
499
500
        </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>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
501
            Saves your changes but does not close the dialog.
502
503
504
505
506
507
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guibutton>Cancel</guibutton></term>
        <listitem><para>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
508
            Discards all your changes and closes the dialog.
509
510
511
512
513
514
515
516
517
518
519
        </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>
520
      &kshisen; Copyright 1997 &Mario.Weilguni; &Mario.Weilguni.mail;
521
522
    </para>
    <para>
523
      &kshisen; Copyright 2002-2004 Dave Corrie <email>kde@davecorrie.com</email>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
524
525
    </para>
    <para>
526
      &kshisen; Copyright 2009-2012 &Frederik.Schwarzer; &Frederik.Schwarzer.mail;
527
528
529
    </para>

    <para>
Frederik Schwarzer's avatar
Frederik Schwarzer committed
530
531
532
      Documentation Copyright 2000 &Dirk.Doerflinger; <email>ddoerflinger@gmx.net</email>
    </para>
    <para>
533
      Documentation Copyright 2009-2010 &Frederik.Schwarzer; &Frederik.Schwarzer.mail;
534
535
536
537
538
539
540
541
542
543
544
    </para>

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

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

  </chapter>

  &documentation.index;
545
</book>
Eugene Trounev's avatar
Eugene Trounev committed
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
<!--
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:
-->