<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
 <!ENTITY kappname "&ksirtet;">
 <!ENTITY package "kdegames">
 <!ENTITY % English "INCLUDE">
 <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">
<bookinfo>
<title>The &ksirtet; Handbook</title>
<authorgroup>
<author>
<firstname>Nicolas</firstname>
<surname>Hadacek</surname>
</author>
</authorgroup>

<!-- TRANS:ROLES_OF_TRANSLATORS -->

<copyright>
<year>1999</year><year>2000</year>
<holder>Nicolas Hadacek</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2000-12-16</date>
<releaseinfo>1.01.10</releaseinfo>

<abstract>
<para>This program is a clone of the well known game Tetris. You must fit the
falling pieces to form full lines.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>game</keyword>
<keyword>tetris</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>
This program is a clone of the well known game <command>Tetris</command>. You
must fit the falling pieces to form full lines. You can rotate and translate the
falling piece. The game ends when no more piece can fall ie when your incomplete
lines reach the top of the board.
</para>

<para>
Every time you have destroyed 10 lines, you gain a level and the pieces fall
quicker (exactly the piece falls from a line each <literal>1/(1+level)</literal>
second).
</para>
</chapter>

<chapter id="how-to-play">
<title>How to play</title>

<sect1 id="handling-the-falling-piece">
<title>Handling the falling piece</title>

<para>
This game use keyboard to rotate, translate or drop down the falling piece. The
keys are configurable with the menu item <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure Key Bindings</guimenuitem></menuchoice>.
</para>

</sect1>
<sect1 id="how-to-gain-points">
<title>How to gain points</title>

<para>There are two sources of points:</para>

<itemizedlist>
<listitem>
<para>
Dropping down a piece gives a small amount of points which is equal to the drop
height. It is not much each time but better than one can think perticularly in
small levels (when the pieces fall slowly).
</para>
</listitem>
<listitem>
<para>
The biggest part of the score comes from destroying full lines. It is very
important to note that destroying multiple lines at the same time gives you much
more points. A four-lines destruction is called a <emphasis>tetris</emphasis> :
it gives a maximum amount of points.
</para>
<para>
The points gained are 40 for a one-liner, 100 for two lines, 300 for three lines
and 1200 for a tetris. These numbers must be multiplied by the current
level. Destroying four lines in level 10 gives 12000 points !!
</para>
</listitem>
</itemizedlist>

</sect1>

<sect1 id="options">
<title>Options</title>

<para>
Menu entry <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
KSirtet</guimenuitem></menuchoice> opens the <guilabel>Settings</guilabel>
Dialog.
</para>

<variablelist>
<varlistentry>
<term><guilabel>Show tile's shadow</guilabel></term>
<listitem>
<para>
Shows/hides the shadow of the falling piece at the bottom of the board. This
shadow can help to avoid position error when dropping the piece.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show next tile</guilabel></term>
<listitem>
<para>
Shows/hides the display of the next piece to come.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Enable animations</guilabel></term>
<listitem>
<para>
<!-- Doesn't appear to do anything -->
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Block Size</guilabel></term>
<listitem>
<para>
Lets you change the size of the blocks (and increases the playing field to
match.  The default size is 15 (pixels.)
</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>

<chapter id="multiplayer">
<title>Multiplayer</title>

<para>
The multiplayer option allows to play with others players on the same computer
or/and on different computers situated on the net. You can also play against an
<acronym>AI</acronym> (artificial intelligence) player which is currently not
very good.
</para>

<para>
Basically when destroying lines, a player sends garbage at the bottom of the
game of his next opponent (nothing for a line desctroyed, one garbage line for
two lines desctroyed and so on).
</para>

</chapter>

<chapter id="credits-and-licenses">
<title>Credits and Licenses</title>

<sect1 id="developers">
<title>Developers</title>

<para><literal>Erik Eng</literal> - Wrote the generic tetris code</para>
<para><literal><ulink url="mailto:hadacek@kde.org">Nicolas Hadacek</ulink></literal></para>
</sect1>

<sect1 id="authors">
<title>Authors</title>
<para><literal><ulink url="mailto:hadacek@kde.org">Nicolas Hadacek</ulink></literal></para>
<para><literal><ulink url="mailto:rwilliams@kde.org">Robert Williams</ulink></literal> - Editor</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;
&underGPL;
</sect1>


</chapter>



</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

