<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kshisen;">
  <!ENTITY package "kdegames">
  <!ENTITY % Estonian  "INCLUDE"
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">
<bookinfo>
<title
>&kshisen;i käsiraamat</title>

<authorgroup>
<author
><firstname
>Dirk</firstname
> <surname
>Doerflinger</surname
> <affiliation
> <address
><email
>ddoerflinger@web.de</email
></address>
</affiliation>
</author>
<othercredit role="reviewer"
><firstname
>Frerich</firstname
><surname
>Raabe</surname
> <contrib
>Korrigeerija</contrib>
<affiliation
><address
><email
>raabe@kde.org</email
></address
></affiliation>
</othercredit>
</authorgroup>

<othercredit role="translator"
><firstname
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@online.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 

<date
>2003-09-17</date>
<releaseinfo
>1.4.90</releaseinfo>

<abstract>
<para
>See käsiraamat kirjeldab &kshisen;i versiooni 1.4.90</para>
</abstract>

<keywordset>
      <keyword
>KDE</keyword>
      <keyword
>kdegames</keyword>
      <keyword
>kshisen</keyword>
      <keyword
>mäng</keyword>
      <keyword
>shisen-sho</keyword>
</keywordset>

</bookinfo>


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

<para
>&kshisen; on Mahjonggi sarnane ühe mängijaga mäng, mis kasutab samasuguseid klotse nagu Mahjongg.</para
> 

<para
>Mängu eesmärk on eemaldada mänguväljalt kõik klotsid.</para>

</chapter>

<chapter id="playing-kshisen">
<title
>&kshisen;i mängimine</title>

<sect1 id="rules">
<title
>Reeglid</title>

<para
>Mängu eesmärk on eemaldada mänguväljalt kõik klotsid. Korraga saab eemaldada ainult kaks ühesugust klotsi. Need saab eemaldada juhul, kui neid saab ühendada maksimaalselt kolme liituva joonega. Jooned võivad olla horisontaalsed või vertikaalsed, mitte aga diagonaalsed. </para>

<para
>Neid jooni ei pea ise tõmbama, mäng märgib need sinu eest. Märgi ainult ära kaks ühesugust klotsi ja kui neid saab ühendada maksimaalselt kolme liituva joonega, siis märgitakse need automaatselt ning klotsid eemaldatakse. </para>

<para
>Arvesta, et jooned saavad liikuda vaid seal, kus nad takistusi ei kohta ehk ümber klotsivälja. Kui tundub, et enam võimalusi pole, võid kasutada vihjevõimalust, mis näitab kaht ühesugust eemaldamisvõimalusega klotsi. Klõps &HPN;ga klotsil näitab kõiki samasuguseid klotse sõltumata sellest, kas nad on parajasti eemaldatavad või mitte.</para>

<para
>Mäng on läbi, kui käike enam ei ole ja mõned klotsid on siiski väljale jäänud (seda ei peaks juhtuma, kui menüüs <guimenu
>Seadistused</guimenu
> on sisse lülitatud võimalus <guimenuitem
>Keela lahenduseta mängud</guimenuitem
>, sest sellisel juhul on kõigil mängudel vähemalt üks võiduvõimalus, kuigi võib muidugi juhtuda, et sa valid just vale võimaluse...).</para>

<para
>Tulemus <quote
>S</quote
> arvutatakse järgmist valemit kasutades (kus <quote
>n</quote
> tähendab klotside arvu mängu algul ning <quote
>t</quote
> aega (sekundites), mis kulus välja puhastamiseks):</para>

<mediaobject
><imageobject>
<imagedata fileref="score-formula.png" format="PNG"/>
</imageobject
><textobject>
<phrase
>S=(n/t)*sqrt(n/84)/0.0014</phrase>
</textobject
></mediaobject>

<para
>Kui mängimise ajal oli <guilabel
>Gravitatsioon</guilabel
> sisse lülitatud, korrutatakse tulemus veel kahega.</para>
</sect1>

<sect1 id="game-menu">
<title
>Menüü <guimenu
>Mäng</guimenu
></title>

<para
>Menüü <guimenu
>Mäng</guimenu
> võimaldab valida mänguga seotud valikuid:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>N</keycap
></keycombo
></shortcut
> <guimenu
>Mäng</guimenu
><guimenuitem
>Uus</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Lõpetab käesoleva mängu</action
> ja käivitab uue seansi uue klotsivalikuga. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>F5</keycap
></keycombo
></shortcut
> <guimenu
>Mäng</guimenu
><guimenuitem
>Käivita mäng uuesti</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Taaskäivitab mängu sama klotsivalikuga.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>P</keycap
></keycombo
></shortcut
> <guimenu
>Mäng</guimenu
> <guimenuitem
>Paus</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Peatab kogu mängu</action
>, eriti aga taimeri, mis mõjutab otseselt tulemust. Vahetub ka menüükirje: <guimenuitem
>Jätka mängu</guimenuitem
> võimaldab edasi mängida.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Mäng</guimenu
><guimenuitem
>Näita rekordeid</guimenuitem
></menuchoice
></term>
<listitem
><para
>Näitab &kshisen;i (kohaliku) rekorditabeli esikümmet.</para
> </listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>Q</keycap
></keycombo
></shortcut
> <guimenu
>Mäng</guimenu
><guimenuitem
>Välju</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Lõpetab</action
> &kshisen;i töö. </para
></listitem>
</varlistentry>


</variablelist>

<para
>Mõningaid menüükäske saab kasutada ka kiirklahvidega. Nende loetelu toob ära <xref linkend="key-bindings"/>.</para
> 

</sect1>

<sect1 id="move-menu">
<title
>Menüü <guimenu
>Käik</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Käik</guimenu
><guimenuitem
>Võta tagasi</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Võtab viimase käigu tagasi</action
>. Sama, mis tööriistariba nupp <guibutton
>Võta tagasi</guibutton
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Käik</guimenu
><guimenuitem
>Tee uuesti</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Teeb viimase käigu uuesti</action
>. Sama, mis tööriistariba nupp <guibutton
>Tee uuesti</guibutton
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>H</keycap
></keycombo
></shortcut
> <guimenu
>Käik</guimenu
><guimenuitem
>Vihje</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Näitab vihjena</action
>, millised kaks klotsi saab eemaldada.</para
></listitem>
</varlistentry>

</variablelist>
</sect1>
</chapter>

<chapter id="configuration">
<title
>Seadistamine</title>

<sect1 id="settings-menu">
<title
>Menüü <guimenu
>Seadistused</guimenu
></title>

<para
>&kshisen;i käitumist saab mitmeti muuta. Kõiki neid võimalusi saab kasutada menüü <guimenu
>Seadistused</guimenu
> abil.</para>

<para
>Valitud seadistused salvestatakse automaatselt.</para>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>Seadistused</guimenu
> <guisubmenu
>Suurus</guisubmenu
></menuchoice
></term>
<listitem
><para
>Alammenüüs <guisubmenu
>Suurus</guisubmenu
> saab muuta klotside arvu mängus. Mida rohkem klotse, seda raskem (ja rohkem aega nõudev) on ka mäng. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guisubmenu
>Kiirus</guisubmenu
></menuchoice
></term>
<listitem
><para
>Alammenüü <guisubmenu
>Kiirus</guisubmenu
> määrab aja, mille jooksul korrektselt valitud klotsid eemaldatakse. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guisubmenu
>Tase</guisubmenu
></menuchoice
></term>
<listitem
><para
>Alammenüü <guisubmenu
>Tase</guisubmenu
> võimaldab valida mängu raskusastme.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Gravitatsioon</guimenuitem
></menuchoice
></term>
<listitem
><para
>Selle lubamine muudab mängu veel raskemaks: kui klots eemaldatakse, langevad kõik tema kohal asunud klotsid ühe positsiooni võrra allapoole. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Lahenduseta mängude keelamine</guimenuitem
></menuchoice
></term>
<listitem
><para
>Kui see on lubatud, siis pakutakse uue mängu käivitamisel ainult selliseid mänge, millel on lahendus. Märkus: see ei tähenda siiski, et sul poleks võimalik eksida ning jõuda lahendamatusse seisu, kus ainus võimalus proovida lahenduseni jõuda on mäng taaskäivitada, aga igal juhul on selle võimaluse valimisel mäng <emphasis
>vähemalt</emphasis
> ühe lahendusega.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Skaleerimata klotsid</guimenuitem
></menuchoice
></term>
<listitem
><para
>Akna suuruse muutmisel skaleeritakse klotsid mängulaual, et nad sobiksid muutunud suurusega. Selle võimaluse sisselülitamisel muudetakse akent nii, et see sobiks klotside loomupärase suurusega. Akna suurust on sul mõistagi võimalik sellest hoolimata muuta, see aga tähendab ühtlasi selle võimaluse tühistamist.</para
></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="key-bindings">
<title
>Kiirklahvid</title>

<para
>Vaikimisi kiirklahvid on järgmised: </para>
<simplelist>
<member
>Uus: <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></member>
<member
>Käivita mäng uuesti: <keycombo
><keycap
>F5</keycap
></keycombo
></member>
<member
>Paus: <keycombo
><keycap
>P</keycap
></keycombo
></member>
<member
>Näita rekordeid: <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
></member>
<member
>Välju: <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></member>

<member
>Võta tagasi: <keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></member>
<member
>Tee uuesti: <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></member>
<member
>Vihje: <keycombo
><keycap
>H</keycap
></keycombo
></member>

<member
>Skaleerimata klotsid: <keycombo
><keycap
>S</keycap
></keycombo
></member>

<member
>Mis see on?: <keycombo action="simul"
>&Shift;<keycap
>F1</keycap
></keycombo
></member>
</simplelist>
</sect1>
</chapter>


<chapter id="credits">
<title
>Autorid ja litsents</title>

<para
>&kshisen;i autoriõigus 1999: Mario Weilguni <email
>mweilguni@sime.com</email
> </para>


<para
>Dokumentatsiooni autoriõigus 2000: Dirk Doerflinger <email
>ddoerflinger@gmx.net</email
> </para>

<para
>Tõlge eesti keelde: Marek Laane <email
>bald@online.ee</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Paigaldamine</title>

<sect1 id="getting-kshisen">
<title
>&kshisen;i hankimine</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Nõuded</title>

<para
>&kshisen;i edukaks kompileerimiseks on vajalik  &kde; 3.x. Kõik nõutavad teegid, samuti &kshisen; ise, on leitavad aadressil &kde-ftp;.</para>
</sect1>


<sect1 id="compilation">
<title
>Kompileerimine ja paigaldamine</title>
&install.compile.documentation; </sect1>
</appendix>

</book>