<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kshisen "<application>KShisen-Sho</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>

<book lang="et">
<bookinfo>
<title>KShisen-Sho Käsiraamat</title>

<authorgroup>
<author>
<firstname>Dirk</firstname>
<surname>Doerflinger</surname>
<affiliation>
<address><email>ddoerflinger@web.de</email></address>
</affiliation>
</author>
</authorgroup>

<date>15/05/2000</date>
<releaseinfo>1.03.00</releaseinfo>

<abstract>
<para>Käesolev käsiraamat kirjeldab mängu &kshisen; Versioon 1.3</para>
</abstract>

<keywordset>
      <keyword>KDE</keyword>
      <keyword>mängud</keyword>
      <keyword>KShisen</keyword>
      <keyword>mäng</keyword>
      <keyword>shisen-sho</keyword>
</keywordset>

</bookinfo>


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

<para>
&kshisen; on mäng ühele mängijale ning sarnaneb mängule Mahjongg, kuna kasutab ka sama koltsikomplekte.</para>
<para>
Mängu eesmärk on eemaldada mänguväljalt kõik klotsid.
</para>
</chapter>


<chapter id="installation">
<title>Installeerimine</title>

<sect1 id="getting-kshisen">
<title>Kuidas saada endale Shisen-Sho</title>

<para>
Kshisen on kirjutatud KDE
<ulink url="http://www.kde.org">http://www.kde.org</ulink> Mario Weilguni poolt <email>mweilguni@sime.com</email> KDE projekti raames.
</para>
<para>
&kshisen; on saadav kdemängude paketis, mis asub
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, 
mis on KDE projekti põhiline sait.</para>
</sect1>

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

<para>
Mängu edukaks kompileerimiseks on vajalik KDE versioon 2.0.
Kõik vajalikud teegid, nagu ka mäng ise, on saadaval aadressil
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>.</para>
</sect1>


<sect1 id="compilation">
<title>Kompileerimine ja installeerimine</title>

<para>
Mängu Kshinsen kompileerimiseks ja installeerimiseks pead sa paketi oma 
süsteemi lahti pakkima ning andma distributsiooni baaskataloogis järgnevad 
käsud:
</para>

<para>
<Screen Width="40">
<Prompt>%</Prompt> <Userinput>./configure</Userinput>
<Prompt>%</Prompt> <Userinput>make</Userinput>
<Prompt>%</Prompt> <Userinput>make install</Userinput>
</Screen>
</para>
      
<para>
Kuna <application>Shisen-Sho</application> kasutab konfigureerimisel 
<application>autoconf</application> ja <application>automake</application>
utiliite, ei tohiks teil kompileerimisega probleeme olla.
</para>
</sect1>
</chapter>


<chapter id="playing-kshisen">
<title>Mängu mängimine</title>

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

<para>
Mängu eesmärgiks on eemaldada mänguväljalt kõik klotsid. Ühe korraga on võimalik eemaldada vaid
kaks ühesugust/kokkusobivat klotsi. Kaht klotsi on võimalik eemaldada vaid juhul, kui nad on ühendatavad
maksimaalselt kolme joonega. Jooned võivad olla horisontaalsed ja vertikaalsed, kuid mitte diagonaalsed.
</para>
<para>
Jooni ei pea sa ise joonistama, mäng teeb selle sinu eest.
Sul tuleb vaid märkida kaks kokkusobivat klotsi ning kui nad on maksimaalselt kolme joonega ühendatavad,
joonistatakse jooned ning klotsid eemaldatakse.
</para>
<para>
Pidage meeles, et jooned võivad olla vaid vabal laual. Kui jääte hätta, võite
kasutada käsku Vihje, et leida kokkusobivad klotsid.
Klõpsates klotsil <mousebutton>parema</mousebutton> hiirenupuga, tulevad nähtavale kõik samasugused
klotsid olenemata sellest, kas nad on vabad ning eemaldatavad või mitte.
</para>
<para> 
Mäng saab läbi, kui lauale jäävaid klotse pole rohkem võimalik eemaldada
(seda ei tohiks juhtuda kui valik <guimenuitem>Pole
lahendamatuid mänge</guimenuitem> järgnevas <guimenu>Option</guimenu> menüüs on
sisse lülitatud, kuna nendele mängudele on vähemalt üks viis neid lahendada, 
kuigi alati on olemas võimalus, et te valite selleks vale tee). 
</para>
</sect1>


<sect1 id="game-menu">
<title>Mängu menüü</title>

<para>
Menüü <guimenu>Mäng</guimenu> võimaldab teil kontrollida käesoleva
mängu staatust järgnevalt:
<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo></shortcut>
<guimenu>Mäng</guimenu><guimenuitem>Tühista käik</guimenuitem></menuchoice></term>
<listitem>
<para>
Tühista käik. Sama funktsiooniga on nupp <guibutton>tagasi</guibutton>
tööriistaribal.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></shortcut>
<guimenu>Mäng</guimenu><guimenuitem>Korda käiku</guimenuitem></menuchoice></term>
<listitem>
<para>
Korda viimast käiku. Sama funktsiooniga on nupp <guibutton>edasi</guibutton>
tööriistaribal.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo></shortcut>
<guimenu>Mäng</guimenu><guimenuitem>Küsi vihjet</guimenuitem></menuchoice></term>
<listitem>
<para>
Vihjab, milliseid klotse saab järgmisena eemaldada.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut>
<guimenu>Mäng</guimenu><guimenuitem>Uus mäng</guimenuitem></menuchoice></term>
<listitem>
<para>
Lõpetab käismasoleva partii ning alustab uut mängu uue klotsikomplektiga.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo></shortcut>
<guimenu>Mäng</guimenu><guimenuitem>Alusta mäng uuesti</guimenuitem></menuchoice></term>
<listitem>
<para>
Alustab käesoleva mängu sama klotsikomplektiga uuesti.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Mäng</guimenu><guimenuitem>Peata mäng</guimenuitem></menuchoice></term>
<listitem>
<para>
Peatab terve mängu, sealhulgas ka ajamõõtja, mis on vajalik
punktide arvutamiseks. Menüükirje, mis lülitab 
<guimenuitem>Resume Game</guimenuitem>, which is used for resuming the game.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Mäng</guimenu><guimenuitem>Kas mäng lahendub?</guimenuitem></menuchoice></term>
<listitem>
<para>
Näitab dialoogi, mis ütleb kas mäng on lahenduv või mitte. Kui
menüükirje <guimenuitem>Keela mittelahenduvad mängud</guimenuitem> menüüs
<guimenu>Valikud</guimenu> on sisse lülitatud, muutub see kast täiesti kasutuks.
</para> 
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Mäng</guimenu><guimenuitem>Edetabel</guimenuitem></menuchoice></term>
<listitem>
<para>
Näitab (local)mängu Shisen-Sho esikümmet.
</para> 
</listitem>
</varlistentry>
</variablelist>
Mõningaid funktsioone on võimalik kontrollida ka niiöelda kuumade klahvide abil.
Neist ülevaate saamiseks vaata
<link linkend="key-bindings"></link>.
</para> 
</sect1>
</chapter>


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

<sect1 id="options-menu">
<title>Valikute menüü</title>

<para>
Mängus Kshinsen on mitmeid võimalusi muuta selle käitumist.
Kõiki valikuid on võimalik muuta menüüst <guimenu>Valikud</guimenu>.
</para>
<para>
Valikud salvestatakse automaatselt.
</para>


<para>
<variablelist>
<varlistentry>
<term>
<menuchoice><guimenu>Valikud</guimenu><guisubmenu>Suurus</guisubmenu></menuchoice></term>
<listitem>
<para>
Alammenüüs <guisubmenu>Suurus</guisubmenu> on võimalik muuta klotside arvu mängulaual. Mida enam on klotse, seda raskem (ning pikem) saab mäng olema.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Valikud</guimenu><guisubmenu>Kiirus</guisubmenu></menuchoice></term>
<listitem>
<para>
Alammenüü <guisubmenu>Kiirus</guisubmenu> saab seadistada aega, mille jooksul klotsid kaovad õieti ühendamise korral.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Valikud</guimenu><guisubmenu>Tase</guisubmenu></menuchoice></term>
<listitem>
<para>
Vali oma oskustase mängu jaoks alammenüüst
<guisubmenu>Tase</guisubmenu>.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Valikud</guimenu><guimenuitem>Gravitatsioon</guimenuitem></menuchoice></term>
<listitem>
<para>
Selle valiku sisse lülitamine muudab mängu raskemaks: Klotsi eemaldamisel kukuvad selle asetsenud klotsid alla.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Valikud</guimenu><guimenuitem>Keela mittelahenduvad mängud</guimenuitem></menuchoice></term>
<listitem>
<para>
Seda valides luuakse uue mängu alustamisel vaid lahenduvad mängud. Mängija vea tõttu võib mäng muidugi mitte lahenduda, kuid selle valiku puhul  <emphasis>peab</emphasis> mäng olema lahenduv.
</para>
</listitem>
</varlistentry>


</variablelist>
</para>
</sect1>

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

<para>Vaikimisi on klahviseosed:
</para>
<simplelist>
<member>Lõpeta: <keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo></member>
<member>Tühista käik: <keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo></member>
<member>Korda käiku: <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></member>
<member>Uus mäng: <keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></member>
<member>Alusta mängu uuesti: <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo></member>
<member>Abi: <keycombo><keycap>F1</keycap></keycombo></member>
<member>Mis see on?: <keycombo><keycap>Shift</keycap><keycap>F1</keycap></keycombo></member>
</simplelist>
</sect1>
</chapter>


<chapter id="credits">
<title>Tänud ja litsentsid</title>

<para>
&kshisen; Copyright 1999 Mario Weilguni
<email>mweilguni@sime.com</email>
</para>


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


<para>
Käesolev programm on litsenseeritud vastavalt
<ulink URL="common/gpl-license.html">GNU GPL</ulink> tingimustele.
</para>
</chapter>

</book>
