<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kappname "&ksirtet;">
 <!ENTITY % English "INCLUDE">
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
 %ents;
]>

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

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

<legalnotice>&FDLNotice;</legalnotice>

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

<abstract>
<para>This documentation was last updated for &ksirtet; version 1.1.10.
Please make any comments and additions to the author.</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 Tetris. 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 remap="tt">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 <literal remap="tt">options-&gt;keys</literal>.</para>
</sect1>
<sect1 id="how-to-gain-points">
<title>How to gain points</title>
<para>There are two sources of points :
<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>
</para>
</sect1>
<sect1 id="options">
<title>Options</title>
<para><itemizedlist>
<listitem>
<para> Menu entry <literal remap="tt">options-&gt;shadow</literal> 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>
<listitem>
<para> Menu entry <literal remap="tt">options-&gt;show next</literal> shows/hides the display of the
next piece to come.</para>
</listitem>
</itemizedlist>
</para>
</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 AI (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="epilogue">
<title>Epilogue</title>
<sect1 id="developers">
<title>Developers</title>
<para><literal remap="tt">Erik Eng</literal> - Wrote the generic tetris code</para>
<para><literal remap="tt"><ulink url="mailto:hadacek@kde.org">Nicolas Hadacek</ulink></literal></para>
</sect1>
<sect1 id="authors">
<title>Authors</title>
<para><literal remap="tt"><ulink url="mailto:hadacek@kde.org">Nicolas Hadacek</ulink></literal></para>
<para><literal remap="tt"><ulink url="mailto:rwilliams@kde.org">Robert Williams</ulink></literal> - Editor</para>

&underFDL;
&underGPL;
</sect1>


</chapter>


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