<?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 "&ksquares;">
  <!ENTITY kappversion "0.3"
><!--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 &kappname;</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
><personname
> <firstname
>Matt</firstname
> <surname
>Williams</surname
> </personname
> <email
>matt@milliams.com</email
> </author>
<othercredit role="reviewer"
><firstname
>Eugene</firstname
><surname
>Trounev</surname
> <contrib
>Nalezer</contrib>
<affiliation
><address
>eugene.trounev@gmail.com</address
></affiliation>
</othercredit>
    &Freek.de.Kruijf; 
  </authorgroup>

  <copyright>
    <year
>2006</year>
    <holder
>Matt Williams</holder>
  </copyright>
<legalnotice
>&FDLNotice;</legalnotice
> 
<date
>2007-11-14</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 van &kappname; 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
>Ksquares</keyword
><!--Application name goes here-->
<!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<keyword
>bord</keyword>
	<keyword
>Stippen en vakjes</keyword>
	<keyword
>Vakjes</keyword>
	<keyword
>Vierkantjes</keyword>
<!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<keyword
>vier spelers</keyword>
<!--All other relevant keywords-->
	<keyword
>Paddocks</keyword>
	<keyword
>Square-it</keyword>
	<keyword
>Punten en streepjes</keyword>
	<keyword
>Stippenspel</keyword>
</keywordset>
</bookinfo>
<!--Content begins here: -->
<chapter id="introduction"
><title
>Inleiding</title
> <!-- do not change this! -->
	<note
><title
>Speltype:</title
><para
>Bord</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
>Four</para
></note>
	<para
>&kappname; is a fun and exciting game for &kde; desktop environment. &kappname; is modeled after the well known pen and paper based game of Dots and Boxes.</para>
<para
>The idea behind &kappname; is to construct squares by interconnecting the dots on the grid. Up to four players can play this game together, taking turns. The trick is – regardless of who has constructed most of the square, it is the player who completes the square that gets the point for it.</para>
<para
>To win the game round player has to collect the most points by covering the most area with the squares of player's own color.</para>
</chapter>
 
<chapter id="howto"
><title
>How to Play</title
> <!-- do not change this! -->
<!--IMPORTANT: If the game has no defined objective, please remove the below line.-->
	<note
><title
>Objective:</title
><para
>Complete more squares than any of your opponents.</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
>At the start of the game, the game board is empty. There is simply a grid of dots showing where lines can be drawn. </para>
<note
><title
>Notitie:</title
><para
>Depending on the game difficulty chosen, the game field may already contain lines at the beginning of the game round.</para
></note>
  <para
>Each player takes it in turns to draw a line between two adjacent dots on the board. By hovering the mouse over the game board, a yellow indicator line will show you where your line will be placed when you click. Once you have decided where you want to draw your line, click - and the line will be drawn. If by drawing a line, you completed a square then this square now belongs to you and earns you a point. Each time you complete a square, you must draw another line. If your line did not complete a square then the next player(s) take their turn. The game will continue until every square on the board is owned by one of the players. </para>
  <para
>To start a new game with custom settings (number of players, player names, board size) click on the <guibutton
>New</guibutton
> toolbar button or go to <menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></shortcut
><guimenu
>Game</guimenu
><guimenuitem
>New</guimenuitem
></menuchoice
>. To start a new game with the same settings as the current game, click on <guibutton
>Restart Game</guibutton
> on the toolbar. </para>
</chapter>
 
<chapter id="rules_and_tips"
><title
>Game Rules, Strategies and 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 id="rules">
  <title
>Game Rules</title>
    <para
>There is very little to be said when it come to the rules, as the game concept in itself is rather a simple one. Nevertheless, here are the game regulations you, as a player will defiantly face while playing &kappname;:</para>
    <itemizedlist>
	<listitem
><para
>You may only connect the dots on the grid if they are not previously connected by you, your opponent, or the computer.</para
></listitem>
	<listitem
><para
>To gain the points you have to connect the dots to form a square.</para
></listitem>
	<listitem
><para
>The square can be no larger than the four adjacent dots on the grid allow for.</para
></listitem>
	<listitem
><para
>Once a square is complete the player who draws the last line of that square is granted the right of possession over it. The square then is colored and the player is given a point.</para
></listitem>
	<listitem
><para
>The player who completes the square is given an extra turn which the player cannot forfeit.</para
></listitem>
    </itemizedlist>
</sect1>
<sect1 id="strategies">
  <title
>Strategies and Tips</title>
  <itemizedlist>
	<listitem
><para
>Try not to play at random. Such game practice will most certainly result in loss.</para
></listitem>
	<listitem
><para
>Construct long chains of lines over the gameboard. Once one such chain is complete start to build another one going parallel to the first.</para
></listitem>
	<listitem
><para
>Try not to build contraptions where only one line remains undone. Your opponent will almost certainly take an advantage of it.</para
></listitem>
	<listitem
><para
>If you are to let the opponent get a square or more, try to select the combination resulting in the least damage.</para
></listitem>
	<listitem
><para
>Try to push your opponent into the situation where he/she(it) will have no choice but to let you get the square.</para
></listitem>
	<listitem
><para
>If you are to get a chance to start completing a whole chain of squares, remember that by leaving two squares at the end of such chain incomplete you are pushing your opponent into completing them, thus giving you the opportunity to continue onto yet another chain. Such a situation is called the double-cross.</para
></listitem>
    </itemizedlist>
</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="file-game-menu-reference">
    <title
>The <guimenu
>Game</guimenu
> Menu</title>
    
    <para>
    <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
>Start een nieuw spel</action
></para
></listitem>
    </varlistentry>
    <varlistentry>
    <term
><menuchoice
><shortcut
><keycap
>F5</keycap
></shortcut
> <guimenu
>Game</guimenu
><guimenuitem
>Restart Game</guimenuitem
></menuchoice
></term>
    <listitem
><para
>Starts a new game with the same settings as the current game.</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
>Displays</action
> the high score table</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
> &ksquares;</para
></listitem>
    </varlistentry>
    </variablelist>
    </para>
  </sect1>

  <sect1 id="settings-menu-reference">
    <title
>The <guimenu
>Settings</guimenu
> Menu</title>
 <variablelist>
  <varlistentry>
    <term
><menuchoice
><guimenu
>Instellingen</guimenu
><guimenuitem
>Werkbalk tonen</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Toggle</action
> the toolbar on and off.</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Show Statusbar</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Toggle</action
> the status bar on and off.</para
></listitem>
  </varlistentry>
			<varlistentry id="settings-menu-shortcuts">
				<term
><menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Configure Shortcuts...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Displays a standard &kde; shortcut configuration dialog</action
> to change the keyboard shortcuts for &kappname;.</para
></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-toolbars">
				<term
><menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Configure Toolbars...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Displays a standard &kde; toolbar configuration dialog</action
> where you can configure the toolbar icons.</para
></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-settings">
				<term
><menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Configure &kappname;...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Opens a dialog to configure &kappname;.</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 <guimenu
>Help</guimenu
>-menu</title>
&help.menu.documentation; </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>
<!--Following is a standard list of FAQ questions.-->
<qandaentry>
 <question
><para
>I want to change the way this game looks. Can I? </para
></question>
 <answer
><para
>Currently the only thing you can change about the game look is the color of the lines. To do so use <menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure &kappname;...</guimenuitem
></menuchoice
> on the menubar. See <link linkend="configuration"
>Game Configuration</link
> section for details.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>I have made a mistake. Can I undo? </para
></question>
 <answer
><para
>No. &kappname; doesn't currently have an <quote
>Undo</quote
> feature.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>Can I use the keyboard to play the game? </para
></question>
 <answer
><para
>No. &kappname; cannot be played using keyboard.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>I cannot figure out what to do here! Are there hints? </para
></question>
 <answer
><para
>No. There is no <quote
>Hint</quote
> feature implemented yet.</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
>&kappname; does not have a saving feature.</para
></answer>
</qandaentry>
<!--Please add more Q&As if needed-->
 
</qandaset>
</chapter>
 
<chapter id="configuration"
><title
>Game Configuration</title
> <!-- do not change this! -->
<sect1 id="newgame-dialog">
<title
>New Game Dialog</title>
<para
>The <guilabel
>New Game</guilabel
> dialog consistes of the following groupboxes:</para>
<variablelist>
  <varlistentry>
    <term
><guilabel
>Spelers</guilabel
></term>
    <listitem
><para
>Here you can change the number of participating players, as well as determine who will be played by human and who by the artificial intelligence. Use the <guilabel
>Number of players</guilabel
> selection box to specify the number of participants. Then type a name for each participant and use the check box to specify the player type.</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Spelbord</guilabel
></term>
    <listitem
><para
>Here you can regulate the size of the game board. Use the <guilabel
>Width</guilabel
> and <guilabel
>Height</guilabel
> selection boxes to change the width and height of the game board.</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Spelinstellingen</guilabel
></term>
    <listitem
><para
>This part of the configuration dialog regulates the difficulty of the game. If you leave the <guilabel
>Quick start</guilabel
> check box unchecked - the game will begin with the empty grid. Otherwise the game will start with the game board partially filled.</para
></listitem>
  </varlistentry>
</variablelist>
</sect1>
<sect1 id="configuration-dialog">
<title
>Configuration Dialog</title>
<para
>The <guilabel
>Configure - &kappname;</guilabel
> dialog consists of the following tabs:</para>
<variablelist>
  <varlistentry>
    <term
><guilabel
>Weergave</guilabel
></term>
    <listitem
><para
>Here you can change the &kappname; color settings.</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Computerspeler</guilabel
></term>
    <listitem
><para
>Use this tab to regulate the game difficulty.</para
></listitem>
  </varlistentry>
</variablelist>
</sect1>
</chapter>
 
<chapter id="credits"
><title
>Dankbetuiging en licentie</title
> <!-- do not change this! -->
<!--This chapter is for credits and licenses.-->
 
<para
>&kappname; </para>

<para
>Program copyright 2006 Matt Williams <email
>matt@milliams.com</email
> </para>
 
  <para
>Documentation Copyright &copy; 2006 Matt Williams <email
>matt@milliams.com</email
></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:
-->
