<?xml version="1.0" ?>
<!--IMPORTANT: please note that'do not change this!' notice does not apply to translators -->
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kiriki;">
  <!ENTITY kappversion "0.2"
><!--Applicaion version. Use this variable everywhere it's needed.-->  
  <!ENTITY package "kdegames"
>  <!-- do not change this! -->
  <!ENTITY % Dutch "INCLUDE"
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE"
> <!-- do not change this! -->
]>
 
<book lang="&language;"
> <!-- do not change this! -->
<bookinfo>
	<title
>De handboek van &kiriki;</title>
<authorgroup>
			<author
><firstname
>Albert</firstname
> <surname
>Astals Cid</surname
> </author>
<author
><firstname
>Eugene</firstname
><surname
>Trounev</surname
> <affiliation
><address
><email
>eugene.trounev@gmail.com</email
></address
></affiliation>
</author>
			&ged.vertaald;&Freek.de.Kruijf; 
		</authorgroup>

		<copyright>
			<year
>2007</year>
			<holder
>&Albert.Astals.Cid;</holder>
		</copyright>
<legalnotice
>&FDLNotice;</legalnotice
> 
<date
>2010-02-01</date
><!-- Date of (re)writing, or update.-->
<releaseinfo
>&kappversion;</releaseinfo
><!-- Application version number. Use the variable definitions within header to change this value.-->
 
<!--Short description of this document. Do not change unless necessary!-->
<abstract>
	<para
>Deze documentatie beschrijft het spel of &kiriki; versie &kappversion;</para>
</abstract>
 
<!--List of relevan keywords-->
<keywordset>
	<keyword
>KDE</keyword
> <!-- do not change this! -->
	<keyword
>kdegames</keyword
> <!-- do not change this! -->
	<keyword
>spel</keyword
> <!-- do not change this! -->
	<keyword
>kiriki</keyword
><!--Application name goes here-->
<!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<keyword
>dobbelsteen</keyword>
	<keyword
>arcade</keyword>
	<keyword
>dobbelspel</keyword>
	<keyword
>dobbelsteen werpen</keyword>
<!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<keyword
>zes spelers</keyword>
</keywordset>
</bookinfo>
<!--Content begins here: -->
<chapter id="introduction"
><title
>Inleiding</title
> <!-- do not change this! -->
	<note
><title
>Speltype:</title
><para
>Dobbelsteen, Arcade</para
></note
><!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<note
><title
>Aantal mogelijke spelers:</title
><para
>Zes</para
></note
><!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<para
>&kiriki; is an addictive and fun dice game for &kde;, designed to be played by as many as six players. Participants have to collect points by rolling five dice for up to three times per single turn. Each roll generates a specific combination of numbers which the player is free to either accept or decline. However, each specific combination of numbers can be accepted only once. After thirteen turns the game ends and the scores are compared. The player with the largest amount of points wins the game. </para>
</chapter>
 
<chapter id="howto"
><title
>Hoe te spelen</title
> <!-- do not change this! -->
<!--IMPORTANT: If the game has no defined objective, please remove the below line.-->
	<note
><title
>Doel:</title
><para
>Meer punten verdienen dan elk van de andere tegenstanders.</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
>Once &kiriki; starts, it right away gives out the first combination for the player one. If you are the player one, then it is now your turn, otherwise you will have to wait until all other players make their moves.</para>
	<note
><title
>Notitie:</title
><para
>By default, unless the game settings have been changed, and in single player mode, the first player is controlled by human (you), while all other five players are controlled by Artificial Intelligence.</para
></note>
	<para
>Once it is your turn, the first thing you should do is examine the current roll. Each of the five dice on the left hand side of the game screen has a specific value. Check the sequence to see if these values form any of the score patterns.</para>
	<note
><title
>Notitie:</title
><para
>The detailed description of the score patterns can be found in the <link linkend="rules_and_tips"
>‘Game Rules, Strategies and Tips’</link
> section of this handbook.</para
></note>
	<para
>Keep in mind that the combination can match more than one score pattern. In this case you will have to determine which score pattern will result in greater points for you.</para>
	<para
>In case the current sequence matches no score pattern, or matches a score pattern you have already used up, you have two more rolls to fix the situation. To use your second (third) roll select the dice you are not satisfied with by clicking on them with your mouse and click the <guibutton
>Roll</guibutton
> button located right under the dice. This will cause the dice in question to reroll, thus changing their values.</para>
	<para
>After you have done the third reroll you must choose the score pattern which fits the dice sequence on hand. If none of the score patterns fit the sequence - you can either use <guilabel
>Chance</guilabel
> score pattern, or just select any score pattern on your scoreboard.</para>
   <note
><title
>Notitie:</title
><para
>If you select a score pattern that does not fit current dice sequence, the score pattern you select will become void and of zero value.</para
></note>
	<para
>As soon as you choose the score pattern its value updates to reflect the dice sequence you currently have.</para>
	<note
><title
>Notitie:</title
><para
>The detailed description of the score pattern values can be found in the <link linkend="rules_and_tips"
>‘Game Rules, Strategies and Tips’</link
> section of this handbook.</para
></note>
	<para
>Right after that your turn ends and the next participant’s turn begins. This sequence repeats some thirteen times and then the game ends, the scores are calculated and the high scores are awarded.</para>
</chapter>
 
<chapter id="rules_and_tips"
><title
>Spelregels, strategieën en tips</title
> <!-- do not change this! -->
	<!--This section has to do with game rules. Please give a detailed description of those using lists or paragraphs.-->
	<sect1
><title
>Spelregels</title>
		<para
>&kiriki; score board is divided into fourteen different lines. Each line holds a single score pattern and the players' score earned for a roll matching the pattern. The score pattern of each line is calculated as follows: <itemizedlist
> <listitem
><para
><guilabel
>1s</guilabel
>: Sum of all dice valued ‘1’.<note
><title
>Example:</title
><para
>Dice on display: '14112'. The sum is: '3'='1'+'1'+'1'. Dice on display: '51111'. The sum is: '4'='1'+'1'+'1'+'1'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>2s</guilabel
>: Sum of all dice valued ‘2’.<note
><title
>Example:</title
><para
>Dice on display: '22422'. The sum is: '8'='2'+'2'+'2'+'2'. Dice on display: '42322'. The sum is: '6'='2'+'2'+'2'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>3s</guilabel
>: Sum of all dice valued ‘3’.<note
><title
>Example:</title
><para
>Dice on display: '34132'. The sum is: '6'='3'+'3'. Dice on display: '33333'. The sum is: '15'='3'+'3'+'3'+'3'+'3'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>4s</guilabel
>: Sum of all dice valued ‘4’.<note
><title
>Example:</title
><para
>Dice on display: '14142'. The sum is: '8'='4'+'4'. Dice on display: '41414'. The sum is: '12'='4'+'4'+'4'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>5s</guilabel
>: Sum of all dice valued ‘5’.<note
><title
>Example:</title
><para
>Dice on display: '15155'. The sum is: '15'='5'+'5'+'5'. Dice on display: '51555'. The sum is: '20'='5'+'5'+'5'+'5'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>6s</guilabel
>: Sum of all dice valued ‘6’.<note
><title
>Example:</title
><para
>Dice on display: '66616'. The sum is: '24'='6'+'6'+'6'+'6'. Dice on display: '61616'. The sum is: '18'='6'+'6'+'6'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>Bonus if 
> 62</guilabel
>: Player is awarded an additional 35 points if the summarized value of all the field above is greater than 62 points.</para
></listitem
> <listitem
><para
><guilabel
>Upper Total</guilabel
>: It is not a playable field, but only a summary of all the fields above.</para
></listitem
> <listitem
><para
><guilabel
>3 of a Kind</guilabel
>: Summarized value of dice when three of the dice are bearing the same value.<note
><title
>Example:</title
><para
>Dice on display: '14121'. The sum is: '9'='1'+'1'+'1'+'4'+'2'. Dice on display: '55151'. The sum is: '17'='5'+'5'+'5'+'1'+'1'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>4 of a Kind</guilabel
>: Summarized value of dice when four of the dice are bearing the same value.<note
><title
>Example:</title
><para
>Dice on display: '41444'. The sum is: '17'='4'+'4'+'4'+'4'+'1'. Dice on display: '22522'. The sum is: '13'='2'+'2'+'2'+'2'+'5'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>Full House</guilabel
>: 25 points are awarded to the player if the round results in three dice of a kind and a pair.<note
><title
>Example:</title
><para
>Dice on display: '11212'. Dice on display: '53353'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>Small Straight</guilabel
>: 30 points are awarded to the player if the round results in four dice of sequential value.<note
><title
>Example:</title
><para
>Dice on display: '14312'. The sequence is: '1','2','3','4'. Dice on display: '51643'. The sequence is: '3','4','5','6'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>Large Straight</guilabel
>: 40 points are awarded to the player if the round results in five dice of sequential value.<note
><title
>Example:</title
><para
>Dice on display: '34152'. The sequence is: '1','2','3','4','5'. Dice on display: '53264'. The sequence is: '2','3','4','5','6'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>&kiriki;</guilabel
>: 50 points are awarded to the player if the round results in five dice of the same value. You can score as many &kiriki; as you get, for each one after the first you get an additional turn at the end of the game.<note
><title
>Example:</title
><para
>Dice on display: '11111'. Dice on display: '33333'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>Chance</guilabel
>: Summarized value of all the dice currently on display.<note
><title
>Example:</title
><para
>Dice on display: '51143'. The sum is: '14'='5'+'1'+'1'+'4'+'3'. Dice on display: '21526'. The sum is: '16'='2'+'1'+'5'+'2'+'6'.</para
></note
></para
></listitem
> <listitem
><para
><guilabel
>Lower Total</guilabel
>: It is not a playable field, but only a summary of all the fields starting from '3 of a Kind' and lower.</para
></listitem
> <listitem
><para
><guilabel
>Grand Total</guilabel
>: It is not a playable field, but only a sum of 'Upper Total' and 'Lower Total' fields.</para
></listitem
> </itemizedlist
> Other rules and constrains: <itemizedlist>
				<listitem
><para
>The entire game round is split into 13 turns.</para
></listitem>
				<listitem
><para
>Each player can do one to three rolls of dice per turn.</para
></listitem>
				<listitem
><para
>After the first roll is done, a player can perform additional rolls for up to two times (three rolls at all per turn).</para
></listitem>
				<listitem
><para
>The Player is not obligated to perform additional rolls if the first roll brings satisfactory results.</para
></listitem>
				<listitem
><para
>Each additional roll may either involve all the dice, or only the selected ones.</para
></listitem>
				<listitem
><para
>A Player can select the dice to be recast by clicking on them with the mouse.</para
></listitem>
				<listitem
><para
>Once the dice have been recast their previous value is lost and only the new value is valid.</para
></listitem>
				<listitem
><para
>The result of the roll is considered satisfactory if the values of the dice on display can be put into one of the score patterns discussed above.</para
></listitem>
				<listitem
><para
>Each individual score pattern can only be used once per game per player. Therefore, once the score pattern has been used by one player it can no longer be used by that same player. However, another player can still use it, unless he has used this same pattern up already.</para
></listitem>
			</itemizedlist>
		</para>
	</sect1>
</chapter
> 
 
<chapter id="interface"
><title
>Overzicht van het interface</title
> <!-- do not change this! -->
<sect1 id="game-menu">
	<title
>Het menu Spel</title>
		<variablelist>
			<varlistentry id="game-menu-new">
				<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Nieuw</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Start een nieuw spel.</action
></para
></listitem>
			</varlistentry>
			<varlistentry id="game-menu-highscores">
				<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Topscores tonen</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Shows the high score list.</action
> When your current game score exceeds one the top ten scores listed, you are prompted to add your name. </para
></listitem>
			</varlistentry>
			<varlistentry id="game-menu-print">
				<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Afdrukken...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Prints current score board.</action
></para
></listitem>
			</varlistentry>
			<varlistentry>
				<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Afsluiten</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Quits</action
> &kiriki;.</para
></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="settings-menu">
	<title
>Het menu Instellingen</title>
		<variablelist>
			<varlistentry id="settings-menu-shortcuts">
				<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Sneltoetsen instellen...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Displays a standard &kde; shortcut configuration dialog</action
> to change the keyboard shortcuts for &kiriki;.</para
></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-settings">
				<term
><menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Configure &kiriki;...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Opens a dialog to configure &kiriki;.</action
>See <link linkend="configuration"
>Game Configuration</link
> section for details.</para
></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="help"
><!--This is a standard Help menubar entry. Only change if needed.-->
<title
>Het menu Help</title>
&help.menu.documentation; </sect1>
</chapter>

<chapter id="faq"
><title
>Veel voorkomende vragen</title
> <!-- do not change this! -->
<!--This chapter is for frequently asked questions. Please use <qandaset
> <qandaentry
> only!-->
<qandaset>
<!--Following is a standard list of FAQ questions.-->
<qandaentry>
 <question
><para
>Ik wil het uiterlijk van dit spel wijzigen. Kan dat? </para
></question>
 <answer
><para
>No. &kiriki; does not currently feature any themes.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>Ik heb een fout begaan. Kan ik deze ongedaan maken? </para
></question>
 <answer
><para
>No. &kiriki; has no <quote
>Undo</quote
> option.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>Kan ik het toetsenbord gebruiken om het spel te spelen?</para
></question>
 <answer
><para
>No. The game of &kiriki; cannot be played using keyboard.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>Ik kom er niet achter wat hier te doen! Zijn er tips? </para
></question>
 <answer
><para
>To learn about the game play rules and tactics please read the <link linkend="rules_and_tips"
>Game Rules, Strategies and Tips</link
> section of this handbook.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>Ik moet het spel nu beëindigen, maar ik ben nog niet klaar. Kan ik mijn spel opslaan?</para
></question>
 <answer
><para
>No. There is no <quote
>Save</quote
> feature in &kiriki;.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>The AI is too fast! I cannot see what it is doing!</para
></question>
 <answer
><para
>To change Artificial Intelligence's speed of action please use the game configuration dialog discussed in the <link linkend="configuration"
>Game Configuration</link
> section of this handbook.</para
></answer>
</qandaentry>

</qandaset>
</chapter>

<chapter id="configuration"
><title
>Spelconfiguratie</title
> <!-- do not change this! -->
<para
>The &kiriki; configuration dialog lets you configure the number of participants, manage their identities, and their response times.</para>
<note
><title
>Notitie:</title
><para
>You can change the response times for Artificial Intelligence driven players only.</para
></note>
<para
><guilabel
>Number of players:</guilabel
> this field defines the number of players for &kiriki;. The values allowed here range between two and six.</para>
<note
><title
>Notitie:</title
><para
>The number of players cannot be less than two.</para
></note>
<para
><guilabel
>1.</guilabel
>-<guilabel
>6.</guilabel
> Numbered fields are the identities of the participating players. You can change their names as well as specify whether they will be human controlled, or driven by the Artificial Intelligence. To define who controls the player use a check box located on the right hand side, right next to the name entry box.</para>
<note
><title
>Notitie:</title
><para
>The first player must always be human controlled.</para
></note>
<para
><guilabel
>Delay between computers move (msec):</guilabel
> lets you specify the delay between Artificial Intelligence's turns. The value of this field is zero by default, meaning that the Artificial Intelligence reacts instantaneously.</para>
<note
><title
>Notitie:</title
><para
>The maximum value for this field is 999 milliseconds.</para
></note>
</chapter>
 
<chapter id="credits"
><title
>Dankbetuiging en licentie</title
> <!-- do not change this! -->
<!--This chapter is for credits and licenses.-->
 
<para
>&kiriki;</para>

<!--List all the copyright holders here-->
<para
>Programma copyright 2005-2007 &Albert.Astals.Cid; &Albert.Astals.Cid.mail; </para>
&meld.fouten;&vertaling.freek;  &underFDL; &underGPL; </chapter>
 
<appendix id="installation">
<title
>Installatie</title>
 
&install.intro.documentation;
 
 
<sect1 id="Compilation">
<title
>Compilatie en installatie</title>
&install.compile.documentation; </sect1>
</appendix>
 
&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:
-->