<?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 kajongg  "<application
>Kajongg</application
>">
  <!ENTITY kappname "&kajongg;">
  <!ENTITY kappversion "0.4"
><!--Application version. Use this variable everywhere it is needed.-->
  <!ENTITY package "kdegames"
>  <!-- do not change this! -->
  <!ENTITY % Estonian  "INCLUDE"
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE"
> <!-- do not change this! -->
  <!ENTITY s1 "s1">
  <!ENTITY s9 "s9">
  <!ENTITY b1 "b1">
  <!ENTITY b9 "b9">
  <!ENTITY c1 "c1">
  <!ENTITY c9 "c9">
  <!ENTITY we "we">
  <!ENTITY ws "ws">
  <!ENTITY ww "ww">
  <!ENTITY wn "wn">
  <!ENTITY db "db">
  <!ENTITY dr "dr">
  <!ENTITY dg "dg">
  <!ENTITY chow "chow">
  <!ENTITY pung "pung">
  <!ENTITY kong "kong">
  <!ENTITY mahjongg "mahjongg">
  <!ENTITY originalcall "originalcall">
  <!ENTITY violatesoriginalcall "violatesoriginalcall">
  <!ENTITY dangerousgame "dangerousgame">
  <!ENTITY nochoice "nochoice">
  <!ENTITY payforall "payforall">
  <!ENTITY payers "payers">
  <!ENTITY payees "payees">
  <!ENTITY absolute "absolute">
  <!ENTITY lastsource "lastsource">
]>

<book lang="&language;"
> <!-- do not change this! -->
<bookinfo>
	<title
>&kappname;i käsiraamat</title
> <!-- This is the title of this docbook. -->
<!-- List of immidiate authors begins here. -->
<!--INPORTANT! - All other contributors: [to be determined] -->
<authorgroup>
<author
><personname
> <firstname
>Wolfgang</firstname
> <surname
>Rohdewald</surname
> </personname
> <email
>wolfgang@rohdewald.de</email
> </author>
<othercredit role="translator"
><firstname
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@smail.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 
</authorgroup>


<date
>2010-03-19</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
>See käsiraamat kirjeldab mängu &kappname; versiooni &kappversion;.</para>
</abstract>

<!--List of relevant keywords-->
<keywordset>
	<keyword
>KDE</keyword
> <!-- do not change this! -->
	<keyword
>kdegames</keyword
> <!-- do not change this! -->
	<keyword
>mäng</keyword
> <!-- do not change this! -->
	<keyword
>kajongg</keyword
><!--Application name goes here-->
<!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<keyword
>lauamäng</keyword>
	<keyword
>arkaadmäng</keyword>
	<keyword
>klotsimäng</keyword>
	<keyword
>kivid</keyword>
<!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<keyword
>neli mängijat</keyword>
<!--All other relevant keywords-->
</keywordset>
</bookinfo>
<!--Content begins here: -->
<chapter id="introduction"
><title
>Sissejuhatus</title
> <!-- do not change this! -->
	<note
><title
>Mängu tüüp:</title
><para
>lauamäng, arkaadmäng</para
></note
><!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<note
><title
>Mängijate arv:</title
><para
>Neli</para
></note
><!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<para
>&kajongg; on lauamäng, mille aluseks on kuulus idamaine mäng  Mahjong (hiina keeles <foreignphrase lang="zh"
>麻將</foreignphrase
>). See on mäng neljale mängijale. Maailmas kasutatakse väga mitmesuguseid reegleid. Praegu toetab &kajongg; klassikalisi hiina reegleid, nagu neid kasutatakse Saksamaal. Tulevikus on võimalikud ka muud reeglid. Samuti on võimalik reegleid oma äranägemise järgi kohandada või ka luua üldse enda reeglid. Viimasel juhul palub autor need ka endale saata, et need oleks võimalik muuta kättesaadavaks ka teistele! </para>
	<para
>&kajongg;i võib kasutada kahel viisil: mängu tulemuste määramine käsitsi, millisel juhul mäng käib nagu ikka, ilma arvuti abita, ning &kajongg;i kasutamine tulemuste arvutamiseks ja arvepidamiseks. Teine võimalus &kajongg;i kasutada on mängida mis tahes inim- ja arvutimängijate kombinatsiooni vastu. </para>
</chapter>

<chapter id="screen_layout"
><title
>Mängu välimus</title>
		<para>
			<screenshot>
				<screeninfo
>&kajongg;i pilt</screeninfo>
				<mediaobject>
					<imageobject>
						<imagedata fileref="gamescreen.png" format="PNG"/>
					</imageobject>
					<textobject
><phrase
>Pilt</phrase
></textobject>
				</mediaobject>
			</screenshot>
                </para>
                <para
>Mänguakna osade lühike selgitus. </para>
	<variablelist>
		<varlistentry>
			<term
>Tööriistariba</term>
			<listitem
><para
>Tööriistariba asub menüüriba all ja sisaldab kõige sagedamini vaja minevate toimingute nuppe. Tööriistariba sisu saab muuta. Samuti võib selle peita, mis annab mänguväljale veidi rohkem ruumi. </para
></listitem>
		</varlistentry>
		<varlistentry>
			<term
>Mängulaud</term>
			<listitem
><para
>Mängulaud on akna suurim osa. Seal on näha neli 18 kivi pikkust müüri (pikkus võib ka veidi erineda sõltuvalt reeglitest, näiteks sellest, kas kasutatakse boonuskive või mitte). Müürile on kirjutatud mängijate nimed ning (hetkel teadaolev) jaotuse väärtus, samuti on seal näha mängijate tuulekivi. Valitseval tuulel on värviline taust - ülal toodud pildil on see nii ida (E) puhul. </para
><para
><link linkend="play"
>Mängimise</link
> ajal paiknevad seespool müüri mängijate ära visatud kivid. Need paiknevad suvaliselt. Viimati ära visatud kivi ümber on näha sinine raam. </para
><para
><link linkend="scoreGame"
>Mängu tulemuste käsitsi määramise</link
> korral on seespool müüri näha kõik saadaolevad kivid. Need võib määrata mängijatele hiirt või klaviatuuri kasutades. </para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>Mängija ala</term>
			<listitem
><para
>Iga mängija ees on ala, kus paiknevad tema kivid. Ülemises reas on näha paljastatud, alumises varjatud kivid. <link linkend="scoreGame"
>Mängu tulemuste käsitsi määramise</link
> korral näidatakse varjatud kive kogu kivi katva varjuga. Boonuskivid paiknevad paremas servas. </para
></listitem>
		</varlistentry>
		<varlistentry>
			<term
>Dialoog</term>
			<listitem
><para
>Dialoog näitab valikuid, mida mängija saab kasutada. Enamasti lisandub neile edenemisriba, mis näitab, kui palju on mängijal jäänud aega valik langetada. </para
></listitem>
		</varlistentry>
		<varlistentry>
			<term
>Olekuriba</term>
			<listitem
><para
>Olekuriba asub mänguakna allservas ja näitab mängijate hetketulemust. </para
></listitem>
		</varlistentry>
	</variablelist>
</chapter>

<chapter id="scoreGame"
><title
>Mängu tulemuste käsitsi määramine</title
> <!-- do not change this! -->
	<para
>Selles režiimis on &kajongg; kasutusel ainult tulemuste määramiseks. Mäng ise käib, nagu ikka, tõeliste inimestega tõelise mängulaua taga ning mängu lõpus tuleb anda &kajongg;ile teada, millised kivid mängijatel olid, ja kõik muu, mida &kajongg; vajab tulemuste arvutamiseks. Teine võimalus on muidugi tulemused käsitsi paberil välja arvutada ning nad siis rakendusse sisestada. Seejärel jagab &kajongg; mängijate vahel punktid ja kirjutab tulemused andmebaasi. Mängu on võimalik peatada, käivitada uue mängu teiste mängijatega või jätkata vana mängu mängimist. Kõik reeglid salvestatakse koos mänguga, mistõttu on võimalik eri mänge mängida eri reeglitega. </para>
        <itemizedlist>
            <listitem
><para
>Vali menüükäsk <guimenu
>Mäng</guimenu
> / <guimenuitem
>Määra mängu tulemused käsitsi</guimenuitem
> või vajuta klahve <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>. </para
></listitem>
            <listitem
><para
>Nüüd võid valida kas olemasoleva lõpetamata mängu või alustada uut mängu. Viimasel juhul palutakse sul määrata mängijad ja valida reeglid. &kajongg; pakub välja eelmise mängu väärtused. Kui eelmist mängu pole, pakutakse välja esimesed neli defineeritud mängijat. Pane tähele, et reeglistikku ega ühtegi selle reeglit ei saa pärast valikut enam muuta. Küll saab seda teha eelnevalt <link linkend="ruleset-options"
>reeglite redaktoris</link
>. </para
></listitem>
            <listitem
><para
>Siis ilmub uus aken nimega "Selle jaotuse tulemused". Lähemalt kõneleb sellest osa <link linkend="enterhand-tiles"
>Tulemuse arvutab &kajongg;</link
>. </para
></listitem>
            <listitem
><para
>Jaotuse tulemuste salvestamise järel saad edasi minna järgmise jaotuse juurde. </para
></listitem>
        </itemizedlist>
      <sect1 id="enterhand"
><title
>Jaotuse tulemuste sisestamine</title>
        <sect2 id="enterhand-scores">
	<title
>Tulemused</title>
	<screenshot>
		<screeninfo
>&kajongg;i pilt</screeninfo>
		<mediaobject>
			<imageobject>
				<imagedata fileref="enterhand.png" format="PNG"/>
			</imageobject
>				<textobject
><phrase
>Pilt</phrase
></textobject>
		</mediaobject>
	</screenshot>
	<para
>Selles aknas saab sisestada jaotuse tulemused. See ilmub automaatselt nähtavale, kui &kajongg; arvab, et sul läheb seda vaja. Seda saab lasta näidata või peita kiirklahviga <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> või vastava menüükäsuga. </para>
	<para
>Nagu ikka, on valitseva tuule taust värviline. </para>
	<para
>Siin saab käsitsi sisestada kõigi mängijate tulemused. Teine võimalus on täpselt kindlaks määrata, millised kivid olid igal mängijal käes. Sellisel juhul muutub vastav käsitsi määratud tulemuse väärtuse väli halliks: &kajongg; arvutab tulemuse automaatselt välja. </para>
	<para
>Pärast jaotuse kõigi asjakohaste andmete sisestamist klõpsa nupule <guibutton
>Salvesta jaotus</guibutton
>. Jaotuse väärtused sisestatakse andmebaasi ning need ilmuvad nähtavale ka edetabelis. Võimalik, et sulle tehakse ettepanek vahetada mängijate kohad, kuid sellest võib ka keelduda. Ette pandavad muutused ei ole veel kohandatava, aga kui ilmub reeglistik, mis vajab midagi muud, siis me muudame seda. </para>
	<para
>Kui mängijal oli võimalus võita, on võimalik kasutada ka märkekasti veerus "Võitja" - vali see võitja puhul. </para>
	<para
>Olekuriba uuendatakse, nii et see näitab mängijate tulemusi, ning sa saad edasi minna järgmise jaotuse juurde. </para>
	<sect3 id="enterhand-manually">
	<title
>Tulemuse käsitsi sisestamine</title>
	<para
>Hea mängija võib eelistada tulemuse isiklikku arvutamist. Sel juhul võib selle otse sisestada. See on võimalik ainult siis, kui antud mängija puhul pole valitud ühtegi kivi. </para>
	<para
>Tulemuse käsitsi sisestamisel peab see sisaldama kõike peale karistuste, siin ei ole mingeid valitavaid reegleid. On siiski üks erand, nimelt "ohtlik mäng". See ei mõjuta mingeid tulemusi ega ole karikkumine. See tähendab lihtsalt, et punktide jagamine mängijate vahel toimub teistmoodi: rikkuja peab maksma kõik võitjale. Teised kaks mängijat selles ei osale. Praegu ei saa seda kuidagi kohandada. </para>
	</sect3>
	<sect3 id="enterhand-tiles">
	<title
>Tulemuse arvutab &kajongg;</title>
	<para
>Kui annad &kajongg;ile otse teada, millised kivid mängijatel olid, on aknas tulemuste sisestamine võimatu. Lisades mängijale kive, näed, kuidas tema tulemused muutuvad - aga niipea, kui oled lisanud 14. kivi, muutub tulemus nulliks. See võib algul üllatada, aga kui sa ei märgi seda ühtlasi võitvaks jaotuseks, peetakse seda niinimetatud pikaks käeks, mis annab alati null punkti. Nii on see määratletud klassikalise hiina reeglistikuga, teistes reeglistikes võib muidugi teisiti olla. </para>
	<para
>Kive ja kombinatsioone saab seostada mängijaga kas hiire või klaviatuuri või mõlema abil. Hiirega lihtsalt lohista kivid mängija alasse. Sel juhul küsitakse, kas soovid liigutada üksikut, paari, pungi, kongi, nõueldud kongi või chow'd. Ülemine rida on paljastatud, alumine varjatud kividele. Boonuskivid on näha paremas servas. Kive ja kombinatsioone võib liigutada ka ridade või mängijate vahel ning tagasi kesksesse valikualasse. </para>
	<para
>Kui eelistad kasutada klaviatuuri, saab keskse valikuala ja mängijate alade vahel liikuda klahviga &Tab;. Klahvi <keycap
>eswnESWN</keycap
> liigutavad kivi vastavalt ida, lõuna, lääne ja põhja mängijale. Klahvid <keycap
>xX</keycap
> liigutavad kivi tagasi kesksesse valikualasse. <keycap
>ESWN</keycap
> liigutab kivi varjatud, <keycap
>eswn</keycap
> paljastatud kivide ritta. Kursorit kivide või kombinatsioonide vahel saab liigutada nooleklahvidega, sealjuures parajasti valitud kivi ümbritseb sinine raam. Et nooleklahvid asuvad tähtedest kaugel, saab kursori liigutamiseks kasutada ka klaviatuuri tähti <keycap
>hjkl</keycap
> ja <keycap
>HJKL</keycap
>. <keycap
>hH</keycap
> liigutab vasakule, <keycap
>jJ</keycap
> liigutab alla, <keycap
>kK</keycap
> liigutab üles ja <keycap
>lL</keycap
> liigutab paremale. Nii käitub ka näiteks UNIX-i tekstiredaktor "vi". Samu klahve toetavad samamoodi isegi KDE brauser Konqueror ja käesolev abirakenduski. Klahvid võivad erineda, kui kasutad mõnda muud kui inglise keelt, aga praegu ei ole võimalik neid seadistada. </para>
	<para
>Valikuid "Viimane kivi" ja "Viimane kombinatsioon" on vaja mõningate reeglite puhul (nt. "viimane kivi lõpetab paari"). Neid saab kasutada ainult võitva jaotuse korral. </para>
	<para
>Akna parempoolses osas saab käsitsi rakendada mõningaid reegleid. Millised reeglid seal näha on, sõltub kehtivast reeglistikust ja kividest. Ülal näidatud pildil võib kaotanud mängijatele rakendada valikut "ohtlik mäng", aga ka see sõltub kehtivast reeglistikust ja mängijate kividest. Arendajate eesmärk on hoida käsitsi valitavate reeglite nimekiri nii lühike kui võimalik. Parimal juhul peaks &kajongg; olema alati võimeline automaatselt tuvastama, milliseid reegleid on vaja rakendada, aga mõnikord pole &kajongg;il selleks piisavalt teavet või teadmisi. </para>
	</sect3>
	</sect2>
	<sect2 id="enterhand-penalties">
	<title
>Karistused</title>
			<screenshot>
				<screeninfo
>&kajongg;i pilt</screeninfo>
				<mediaobject>
					<imageobject>
						<imagedata fileref="penalty.png" format="PNG"/>
					</imageobject>
					<textobject
><phrase
>Pilt</phrase
></textobject>
				</mediaobject>
			</screenshot>
	<para
><link linkend="enterhand"
>Tulemuste käsitsi sisestamise akna</link
> nupp <guibutton
>Karistused</guibutton
> avab akna, kus saab sisestada karistusi. Seda võib teha igal hetkel, sõltumata tavalisest tulemuste arvestamise mehhanismist.</para>
	<para
><guilabel
>Rikkumise</guilabel
> valikukast näitab kõiki rikkumisi, mida on võimalik rakendada mängijate jaotustele. Vali nende seast vajalik.</para>
	<para
>Seejärel saab täpsustada <guilabel
>Kogukaristust</guilabel
>. See on kogusumma, mida rikkuja peab teistele tasuma. See jagatakse saajate vahel võrdselt.</para>
	<para
>Sõltuvalt rikkumise tüübist on tasujate ja saajate arv erinev. Igal juhul näidatakse õiget arvu mängijaid. Mängija valimise korral kontrollib &kajongg;, et see mängija esineks ainult ühel korral, kohandades vastavalt teisi mängijaid. </para>
	</sect2>
	</sect1>
</chapter>

<chapter  id="play"
><title
>Mängimine</title>
        <sect1 id="robotplay">
        <title
>Mängimine arvuti vastu</title>
         <para
>Kõigepealt ilmub sisselogimisdialoog. Sisesta mänguserver, millega soovid ühineda, ja oma kasutajanimi. Kui valid erikirje "Kohalik mäng", pead sisestama ainult oma nime (või soostuma pakutud nimega) ja valima reeglistiku. Sel juhul käivitatakse kohe kohalik mäng, milles mängid kolme robotmängija vastu. </para>
        </sect1>
        <sect1 id="humanplay">
        <title
>Mängimine sõpradega</title>
        <para
>Kui soovid mängida tõeliste inimestega, siis läheb vaja mänguserverit, millega kõik mängijad, kaasa arvatud sina ise, peavad olema ühendatud. Selleks vali mõni server või sisesta käsitsi uue serveri nimi ning määra oma parool selles serveris. Vaikimisi pakutakse välja viimati kasutatud parool. </para
><para
>Kui sul ei ole antud serveris sisestatud kasutajanimele vastavat kontot, päritakse sinu käest, kas soovid konto luua. Kui vastad jaatavalt, näed järgmist dialoogi, kus tuleb soovitud parool kaks korda sisestada. Konto luuakse nüüd automaatselt. </para
><para
>Pärast edukat sisselogimist mänguserverisse, näed serveri laudade nimekirja koos vabade kohtadega. Liitu mõne lauaga või loo endale uus laud. Kui lood uue laua, tasub oodata, kuni teised mängijad võtavad selle taga kohad sisse. Siiski võib uue laua taga ka kohe mängima hakata, sel juhul täidavad tühjad kohad robotmängijad. </para
><para
>Laudade nimekirjas on näha iga laua taga kasutatav reeglistik. Reeglistiku ja selle nime saadab mänguserverisse mängija, kes laua lõi. Kui sul juhtub olema samasugune reeglistik, näitab laud reeglistiku juures sinu nime - sellest võib olla abi, kui laua looja peaks kõnelema mõnda muud keelt ja on reeglistiku kuidagi teisiti nimetanud. Kui sinu kohaliku reeglistiku nime näidatakse, on see esitatud mustana. Kui sul aga pole samasugust reeglistikku, näeb nime punasena ning sa võid nupu <guibutton
>Võrdle</guibutton
> abil võrrelda seda enda reeglistikuga. </para
><para
>Kajonggi mänguserveri saab käivitada kahel viisil: <itemizedlist
><listitem
><para
>loo ühendus serveriga "localhost". See on sinu enda arvuti. Kui sa seda teed ja mänguserver ei tööta, käivitatakse see automaatselt. Kui sa aga mängimise lõpetad, peatatakse ka serveri töö. </para
></listitem
><listitem
><para
>käivita käsitsi server mis tahes arvutis. Selleks tuleb lihtsalt minna käsureale ja käivitada programm "kajonggserver". Käsuga "kajonggserver --help" näeb kõiki võimalikke võtmeid, näiteks saab muuta vaikimisi porti 8149. Server töötab seni, kuni selle töö lõpetad. </para
></listitem
></itemizedlist>
        </para
><para
>Mõlemal juhul tuleb teistele mängijatele öelda, kuidas nad sinu mänguserverisse pääsevad. Selleks vajavad nad URL-i või lihtsalt IP-aadressi ja porti, mida sinu server jälgib. See võib olla näiteks "mypc.dyndns.org:8149", kus 8149 on port. Loomulikult tuleb sul ka oma tulemüüri seadistada, et mujal asuvad mängijad ikka saaksid selle pordiga ühenduse luua. Suhtlemine on krüptitud. </para
><para
>Võimalike vigade esinemisel oleks mõttekas kasutada võtit "--showtraffic". See näitab sulle konsoolis, kus mänguserver on käivitatud ning millised sõnumid liiguvad mänguserveri ja klientide vahel. </para>
        <sect2 id="playing-caveats">
        <title
>Hoiatus</title>
            <itemizedlist
><listitem
><para
>Kui tahad olla kindel, et ükski inimmängija ei peta, peaks sul olema ligipääs arvutile, milles mänguserver töötab. Loomulikult ei ole võimalik takistada näiteks kahel mängijal kokku mängimast ja teineteist abistamast, õieti ei saa isegi seda kontrollida, kas kaks mängijat on ikka kaks või üks ja seesama inimene. </para
></listitem
></itemizedlist>
        </sect2>
        </sect1>
        <sect1 id="playing-play">
        <title
>Kuidas mängida</title>
        <para
>Sinu käest päritakse, mida soovid teha. Sõltuvalt akna suurusest on selleks mõeldud väike dialoog kas akna paremas või allservas. Kui akna laius ületab kõrgust, näeb dialoogi paremal. Mõnikord näeb dialoogis aega: kui see saab täis, valitakse automaatselt esimene võimalik vastus. Aegumist saab seadistada reeglite redaktoris (<guilabel
>Valikud</guilabel
>, <guilabel
>Nõudluse aegumine</guilabel
>). Aegumine on ühesuguse pikkusega kõigile mängijatele, seepärast ongi see reeglistiku osa. </para
><para
>Kui pead valima mõne käes oleva kivi, võid nende vahel liikuda paremale ja vasakule liikuvate nooleklahvidega või tähtedega h ja l. Loomulikult võib seda teha ka hiirega. </para
><para
>Sageli pakub dialoog valikuid, mida sa tegelikult ei saa kasutada, näiteks võimalust kuulutada välja pung, ehkki sul pole selleks vajalikke kive. See on sihilik, et kõik oleks täpselt nagu tõelises mängus. </para
><para
>Ära visatud kivid asetatakse juhuslikult sissepoole müüri. Mõnes mänguvariandis on ka kindlaks määratud, kuhu kivid asetada, aga see pole veel seadistatav. Kui see muutub seadistatavaks, hakkab see seadistus kuuluma reeglistikku. </para>
	</sect1>
</chapter>


<chapter id="interface"
><title
>Liidese tutvustus</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="game-menu">
	<title
>Menüü <guimenu
>Mäng</guimenu
></title>
		<variablelist>
			<varlistentry id="game-menu-scoreGame">
				<term
><menuchoice
><guimenu
>Mäng</guimenu
> <guimenuitem
>Määra mängu tulemused käsitsi</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>See on mõeldud ainult mängitud mängu tulemuste käsitsi sisestamiseks.</action
></para
><para
>Vastavalt soovile võib laadida vana mängu või alustada uut. Vaikimisi näidatakse valikunimekirjas ainult ootel, s.t lõpetamata mänge. Lisavõimalusena saab lasta näidata kõiki mänge, ka neid, mis on lõpetatud. Siin saab ka mänge kustutada.</para
></listitem>
			</varlistentry>
                        <varlistentry  id="game-menu-play">
                                <term
><menuchoice
><guimenu
>Mäng</guimenu
><guimenuitem
>Mängi</guimenuitem
> </menuchoice
></term>
                                <listitem
><para
><action
>Võimaldab mängida teiste, nii inimeste kui ka arvutitega.</action
></para
></listitem>
                        </varlistentry>
                        <varlistentry  id="game-menu-abort">
                                <term
><menuchoice
><guimenu
>Mäng</guimenu
> <guimenuitem
>Katkesta</guimenuitem
> </menuchoice
></term>
                                <listitem
><para
><action
>Katkestab aktiivse mängu. Kui tegemist oli ainult mängu tulemuste sisestamisega, saab seda hiljem jätkata. Kui aga mängid &kajongg;i abil, siis selliseid mänge veel taastada ei saa.</action
></para
></listitem>
                        </varlistentry>
			<varlistentry>
				<term
><menuchoice
><guimenu
>Mäng</guimenu
> <guimenuitem
>Välju</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Lõpetab</action
> &kappname;i töö.</para
></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="view-menu">
	<title
>Menüü <guimenu
>Vaade</guimenu
></title>
		<variablelist>
                        <varlistentry id="view-scoring">
                                <term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Tulemused</guimenuitem
> </menuchoice
></term>
                                <listitem
><para
><action
>Tulemuste dialoog</action
>: näitab või peidab tulemuste dialoogi. Seda selgitatakse lähemalt <link linkend="enterhand"
>siin</link
>. </para
></listitem>
                        </varlistentry>
                        <varlistentry id="view-scoretable">
                                <term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Edetabel</guimenuitem
> </menuchoice
></term>
                                <listitem
><para
><action
>Edetabel</action
> <screenshot
> <screeninfo
>Edetabel</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="scoretable.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Pilt</phrase
> </textobject
> </mediaobject
> </screenshot
> Näitab edetabelit. Vasakpoolne veerg väärtustega E, S, W, N näitab mängija tuult. Valitseva tuule taust on kollakas. Võitja taust on tulemuse veerus roheline. Veerg ∆ näitab, kui palju pidi mängija selles jaotuses teistele mängijatele tasuma või kui palju ta ise sai. Veerg ∑ näitab bilanssi. Vihjed pakuvad rohkem üksikasju, nii näeb kõiki reegleid, mida antud jaotuse korral rakendati.</para
><para
>Alumine osa näitab kasutatud reeglistikku. Tulemuste tabeli ja reeglistiku vahel asub eraldaja, mida liigutades on võimalik mõlema osa suurust muuta. </para
></listitem>
                        </varlistentry>
			<varlistentry id="view-explain-scores">
				<term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Tulemuste selgitus</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Tulemuste selgitus</action
> <screenshot
> <screeninfo
>Edetabel</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="explain.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Edetabel</phrase
> </textobject
> </mediaobject
> </screenshot
> Selgitab, kuidas arvutati aktiivse jaotuse tulemused. </para
></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="settings-menu">
	<title
>Menüü <guimenu
>Seadistused</guimenu
></title>
		<variablelist>
			<varlistentry>
				<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Mängijad</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Võimaldab lisada, muuta ja kustutada mängijaid.</action
></para
></listitem>
			</varlistentry>
			<varlistentry>
				<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Muuda vaatenurka</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Võimaldab muuta kivide vaatamise nurka vastupäeva.</action
></para
></listitem>
			</varlistentry>
			<varlistentry>
				<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Täisekraanirežiim</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Võimaldab lülitada täisekraanirežiimi ja tavalise aknarežiimi vahel.</action
></para
></listitem>
			</varlistentry>
			<varlistentry>
				<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Tööriistariba näitamine</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Näitab või peidab tööriistariba.</action
></para
></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-statusbar">
				<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Olekuriba näitamine</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Näitab või peidab olekuriba.</action
></para
></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-shortcuts">
				<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Kiirklahvide seadistamine...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Avab &kde; tavapärase kiirklahvide seadistamise dialoogi</action
>, kus saab muuta &kappname;is kasutatavaid <link linkend="default-keybindings"
>kiirklahve</link
>.</para
></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-toolbar">
				<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Tööriistaribade seadistamine...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Avab &kde; standardse dialoogi, kus saab muuta tööriistaribal näidatavaid ikoone.</action
></para
></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-settings">
				<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>&kappname;i seadistamine...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Avab &kappname;i <link linkend="configuration"
>seadistustedialoogi</link
>.</action
></para
></listitem>
			</varlistentry>
		</variablelist>
</sect1>
 <sect1 id="help"
><!--This is a standard Help menubar entry. Only change if needed.-->
<title
>Menüü <guimenu
>Abi</guimenu
></title>
&help.menu.documentation; </sect1>
</chapter>

<chapter id="configuration"
><title
>Mängu seadistamine</title
> <!-- do not change this! -->
<!--This section describes configuration &GUI;. If your game is configured using menubar exclusively, please remove this section.-->
<screenshot>
<screeninfo
>Seadistustedialoog</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="config_play.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Seadistustedialoog</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Menüükäsk <menuchoice
><guimenu
>Seadistused</guimenu
><guimenuitem
>&kappname;i seadistamine...</guimenuitem
></menuchoice
> avab &kappname;i seadistustedialoogi.</para>
<para
>Kui klõpsata nupule <guibutton
>Loobu</guibutton
>, tühistatakse kõik seadistustesse tehtud muudatused, kaasa arvatud need, mida oled teinud reeglite redaktoriga.</para>
<para
>Eri kaarte saab valida ka klaviatuuri abil: <keycombo action="simul"
>&Ctrl;<keycap
>1</keycap
></keycombo
> valib esimese kaardi <guilabel
>Mäng</guilabel
>, <keycombo action="simul"
>&Ctrl;<keycap
>2</keycap
></keycombo
> teise kaardi ja nii edasi.  </para>

<sect1 id="play-options"
><title
><guilabel
>Mängu</guilabel
> valikud</title>
		<variablelist>
			<varlistentry>
				<term>
					<guilabel
>Kivide varju näitamine</guilabel>
				</term>
				<listitem
><para
>Sisselülitamise korral näidatakse kivide piirdeid ja varje. Samuti jääb kiviridade vahele veidi ruumi ning müüri kive näidatakse nii, et on selgelt näha, et see on kahe või kolme kivi kõrgune. Väljalülitamise korral on vaade lihtsam ja kivid natuke suuremad. See valik võib olla kasulik väiksema arvutiekraani korral. </para
></listitem>
			</varlistentry>
			<varlistentry>
				<term>
					<guilabel
>Paljastamata kivide korraldamine kombinatsioonidesse</guilabel>
				</term>
				<listitem
><para
>Sisselülitamise korral rühmitatakse käes olevad kivid kombinatsioonidesse. Mõnikord ei pruugi rühmitamine olla just selline, nagu sulle meeldib, nii et selle võib ka välja lülitada, mis matkib tõelist mängu. </para
></listitem>
			</varlistentry>
			<varlistentry>
				<term>
					<guilabel
>Võimalusel helide kasutamine</guilabel>
				</term>
				<listitem
><para
>Sisselülitamisel on võimalik kuulata ära visatud kivide nimesid ja nõudlusi. Kui teised mängijad on salvestanud oma häälega helifailid, on neid võimalik kuulda. </para
></listitem>
			</varlistentry>
			<varlistentry>
				<term>
					<guilabel
>Teised võivad minu häält kuulda</guilabel>
				</term>
				<listitem
><para
>Kui oled salvestanud oma häälega helifailid, siis selle valiku sisselülitamisel kuulevad teised mängijad sinu ära visatud kive ja nõudlusi sinu häälega. </para
></listitem>
			</varlistentry>
		</variablelist>

	<sect2
><title
>Heli</title>
	<para
>Võimalik on salvestada helifailid oma väljaütlemistega, mida teised mängijad saavad kuulda. Selleks on vaja siiski veidi vaeva näha: </para>
            <itemizedlist
><listitem
><para
>Kõigepealt tuleb valida, kuhu oma helifailid salvestada. Tavaliselt on selleks kataloog ~/.kde/share/apps/kajongg. Niisiis, kui sinu kasutajanimi on juhan, siis oleks kataloog /home/juhan/.kde/share/apps/kajongg. Sealt leiab ka andmebaasi kajongg.db. </para
></listitem
><listitem
><para
>Loo selles kataloogis uus alamkataloog nimega <filename class="directory"
>voices</filename
>. </para
></listitem
><listitem
><para
>Loo kataloogis <filename class="directory"
>voices</filename
> veel üks alamkataloog, sedakorda oma mängijanimega, see tähendab nimega, mida kasutad mänguserveriga ühendumisel. Samuti võid määrata helid mängijatele <filename
>ROBOT 1</filename
>, <filename
>ROBOT 2</filename
>, <filename
>ROBOT 3</filename
>. </para
></listitem
><listitem
><para
>Sellesse alamkataloogi tulebki paigutada oma helifailid. Need peavad olema kodeeritud <ulink url="http://xiph.org/vorbis/"
>Ogg Vorbise</ulink
> audiokompressoriga ning failinimede laiend peab olema <filename class="extension"
>.ogg</filename
>. </para
></listitem
><listitem
><para
>Failinimed peavad olema näiteks <filename
>s3.ogg</filename
>, mis antud juhul vastab kivile 3. Sellised failid tuleks luua kõigi kivide ning võimalike nõudluste ja väljakuulutamiste tarvis. </para
></listitem
></itemizedlist>
            <para
>Palun kontrolli, et heli kestus oleks lühike, aga see kõlaks selgelt - mäng võib minna väga kiirelt, kui oled selle käppa saanud. Lihtsam on kõigepealt panna kirja kõik helid, mida sinu arvates vaja läheb. Ära loe neid üksteise järel, vaid püüa iga heli välja öelda, nagu see oleks ainuke, ja nii, nagu see võiks kõlada, kui oled mänguhoos. Väljaütlemine võib nõuda veidi harjutamist.</para>
            <para
>Toome ära ühe võimaluse helifailide loomiseks: </para
><para
><itemizedlist
><listitem
><para
>Salvesta helifailid programmiga <command
>qarecord</command
> ja kindlasti <literal
>WAV</literal
>-vormingusse. Kõnele selles ühes helifailis kõik helid. </para
></listitem
><listitem
><para
>Redigeeri faili heliredaktoriga <command
>audacity</command
>. Kasuta redaktoris hiirt helilainete vahemiku märkimiseks. Redaktor esitab valitud osa. Korda, kuni oled valinud korrektse osa. See võib olla lihtsam menüükäsuga <menuchoice
><guimenu
>Vaade</guimenu
><guimenuitem
>Suurenda</guimenuitem
></menuchoice
>. Kasuta menüükäsku <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Ekspordi valik</guimenuitem
></menuchoice
> ja salvesta ogg-vormingusse. <guilabel
>Valikute</guilabel
> all vali madal kvaliteet - see on piisav ja isegi soovitav, sest nii väheneb heli teistele mängijatele edastamise aeg. </para
></listitem
></itemizedlist
></para>
            <para
>Allpool on ära toodud failide nimed, mida sul tuleks luua. Alati lisa neile faililaiend <filename
>.ogg</filename
>:</para>

<table>
<title
>Helifailide nimed</title>
<tgroup cols="2">
<tbody>
<row>
<entry
>&s1; .. &s9;</entry
><entry
>Kivid 1 kuni 9</entry>
</row>
<row>
<entry
>&b1; .. &b9;</entry>
<entry
>Bambused 1 kuni 9</entry>
</row>
<row>
<entry
>&c1; .. &c9;</entry>
<entry
>Märgid 1 kuni 9</entry>
</row>
<row>
<entry
>&we; &ws; &ww; &wn;</entry>
<entry
>Tuuled - ida, lõuna, lääs, põhi</entry>
</row>
<row>
<entry
>&db; &dr; &dg;</entry>
<entry
>Draakonid - sinine/valge, punane, roheline</entry>
</row>
<row>
<entry
>&chow; &pung; &kong; &mahjongg;</entry>
<entry
>Peamised nõudlused</entry>
</row>
<row>
<entry
>&originalcall; &violatesoriginalcall;</entry>
<entry
>Algkäik ja selle rikkumine</entry>
</row>
<row>
<entry
>&dangerousgame;</entry>
<entry
>Mängija kaotab kontrolli (ohtlik mäng)</entry>
</row>
<row>
<entry
>&nochoice;</entry>
<entry
>Mängija kuulutab, et tema ainuke valik on mängida ohtlikult</entry>
</row>
</tbody>
</tgroup>
</table>
	</sect2>
</sect1>

<sect1 id="tiles-options"
><title
><guilabel
>Kivide</guilabel
> valikud</title>
        <screenshot>
                <screeninfo
>Kivide valija</screeninfo>
                <mediaobject>
                        <imageobject>
                                <imagedata fileref="config_tiles.png" format="PNG"/>
                        </imageobject>
                        <textobject
><phrase
>Kivide valija</phrase
></textobject>
                </mediaobject>
        </screenshot>
	<para
><guilabel
>Kivide</guilabel
> valija abil saab valida kivide graafilise välimuse. </para>
</sect1>

<sect1 id="background-options"
><title
><guilabel
>Tausta</guilabel
> valikud</title>
        <screenshot>
                <screeninfo
>Tausta valija</screeninfo>
                <mediaobject>
                        <imageobject>
                                <imagedata fileref="config_background.png" format="PNG"/>
                        </imageobject>
                        <textobject
><phrase
>Tausta valija</phrase
></textobject>
                </mediaobject>
        </screenshot>
	<para
><guilabel
>Tausta</guilabel
> valija võimaldab valida mängulaua tausta graafilise välimuse. </para
><para
>Mõned taustad, näiteks Hiina maastik, nõuavad laadimiseks veidi aega. Kui arvad, et rakendus peaks käivituma kiiremini või et peaakna suuruse muutmine võtab liiga kaua aega, proovi mõnda muud tausta. </para>
</sect1>

<sect1 id="ruleset-options"
><title
>Reeglite redaktor</title>
			<screenshot>
				<screeninfo
>Reeglite redaktor</screeninfo>
				<mediaobject>
					<imageobject>
						<imagedata fileref="ruleseteditor.png" format="PNG"/>
					</imageobject>
					<textobject
><phrase
>Reeglite redaktor</phrase
></textobject>
				</mediaobject>
			</screenshot>
			<para
>Reeglite redaktoriga saab kohandada reeglistikke. Valmisreeglistikke näidatakse kaldkirjas, kohandatud reeglistikke tavalises kirjas. Valmisreeglistikke ei saa kasutaja kuidagi muuta, küll võib seda teha &kajongg;i uuendamine. Kohandatud reeglistikke uuendamisel ei muudeta. </para
><para
>Uue mängu käivitamisel on võimalik valida selle reeglistik. Kasutada saab kõiki reeglistikke, mis on defineeritud reeglite redaktori abil. Reeglistik salvestatakse koos mänguga, nii et siin võib reeglistikke alati muuta - muudatused mõjutavad ainult edaspidiseid mänge. </para>
			<sect2
><title
>Reegel, tulemus ja ühik</title
><para
>Tee lihtsalt topeltklõps sellel, mida soovid muuta.</para>
			</sect2>
			<sect2
><title
>Definitsioon</title
><para
>Reegli definitsioon võib olla päris keeruline. Seda seletab lähemalt eraldi peatükk <link linkend="rule"
>Reegli defineerimine</link
>. Tavaliselt ei ole põhjust definitsiooni muuta. Põhimõtteliselt määrab see kindlaks, millise jaotuse korral antud reegel rakendub.</para>
			</sect2>
			<sect2
><title
>Kopeerimine ja eemaldamine</title
><para
>Kopeerida võib kogu reeglistikku või ainult selle üht reeglit. Et valmisreeglistikke muuta ei saa, saab üksikreegleid kopeerida ainult kohandatud reeglistikesse. </para
><para
>Soovi korral võib eemaldada kogu kohandatud reeglistiku või ainult kindla reegli. Ka seda võib teha siis, kui mõni olemasolev mäng kasutab muudetavat reeglistikku, sest nagu öeldud, salvestatakse reeglistik koos mänguga. Soovi korral võib näha vanade mängude reeglistikke: <link linkend="game-menu-scoreGame"
>laadi</link
> vana mäng ja <link linkend="view-menu"
>vaata selle tulemusi</link
>. </para>
			</sect2>
			<sect2
><title
>Võrdlemine</title
><para>
			<screenshot>
				<screeninfo
>Reeglistiku võrdleja</screeninfo>
				<mediaobject>
					<imageobject>
						<imagedata fileref="differ.png" format="PNG"/>
					</imageobject>
					<textobject
><phrase
>Reeglistiku võrdleja</phrase
></textobject>
				</mediaobject>
			</screenshot>
Võrdlemiskäsku saab kasutada, kui valitud on terve reeglistik. See võimaldab võrrelda üht reeglistikku teisega. </para
></sect2>
</sect1>

<sect1 id="default-keybindings">
<title
>Vaikimisi kiirklahvid</title>

<para
>Menüükäsu <menuchoice
><guimenu
>Seadistused</guimenu
><guimenuitem
>Kiirklahvide seadistamine...</guimenuitem
></menuchoice
> valimine lubab muuta vaikimisi kiirklahve.</para>

<para
>Vaikimisi kiirklahvid on järgmised: </para>

<para>
<variablelist>

<varlistentry>
<term
><keycap
>F1</keycap
></term>
<listitem>
<para
>Avab käesoleva käsiraamatu. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
></term>
<listitem>
<para
>Mängu tulemuste käsitsi määramine. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></term>
<listitem>
<para
>Mängimine sõpradega või arvutimängijatega. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>W</keycap
></keycombo
></term>
<listitem>
<para
>Aktiivse mängu katkestamine. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></term>
<listitem>
<para
>Rakendusest väljumine. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>T</keycap
></keycombo
></term>
<listitem>
<para
>Edetabeli avamine. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
></term>
<listitem>
<para
>Vaatenurga muutmine. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycombo action="simul"
>&Shift;<keycap
>F1</keycap
></keycombo
></term>
<listitem>
<para
>"Mis see on?" abi </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>F</keycap
></keycombo
></term>
<listitem>
<para
>Täisekraanirežiim </para>
</listitem>
</varlistentry>

</variablelist>
</para>

</sect1>
</chapter>

<chapter id="rule"
><title
>Reegli defineerimine</title>
<para
>Tulemuste mootorit ja veel paljusid &kajongg;i omadusi saab kohandada reeglite redaktoriga. Reegel koosneb nimest, tulemusest (kaasa arvatud ühikust) ja <link linkend="ruledefinition"
>definitsioonist</link
>. </para>
        <sect1 id="rulegroups">
        <title
>Reeglirühmad</title>
        <para
>Reeglitel on mitmeid rühmi:</para>
        <variablelist>
                <varlistentry>
                        <term
>Kombinatsiooni reeglid</term>
                        <listitem
><para
>Kombinatsiooni reeglid rakendatakse konkreetsele kombinatsioonidele sõltumata ülejäänud jaotusest. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Jaotuse reeglid</term>
                        <listitem
><para
>Jaotuse reeglid kehtivad kogu jaotusele ja kõigile mängijatele. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Mah Jonggi reeglid</term>
                        <listitem
><para
>Mah Jonggi reeglid määravad, kui suur on tõenäosus, et jaotus on võidetav. Tavaliselt tähendab see nelja kolmest või neljast kivist koosnevat kombinatsiooni ja üht paari. Kuid on olemas ka erilisi jaotusi, näiteks klassikalise hiina mängu puhul 13 orbu. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Võitja reeglid</term>
                        <listitem
><para
>Võitja reeglid kehtivad kogu jaotusele, aga ainult võitjale. See sisaldab enamikku erilisi jaotusi. Neid reeglite puhul ei pea rakendamiseks tingimata olema korrektne kivide arv. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Valikud</term>
                        <listitem
><para
>Siit leiab mitmeid eriparameetreid, näiteks piirangujaotuse punktid. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Karistused</term>
                        <listitem
><para
>Karistusi rakendab käsitsi kasutaja </para
></listitem>
                </varlistentry>
        </variablelist>
        <sect2 id="executionorder"
><title
>Rakendamise järjekord</title>
        <para>
                <itemizedlist>
                        <listitem
><para
>rakendatavate reeglite nimekirja loomine kombinatsiooni ja jaotuse reeglite põhjal</para
></listitem>
                        <listitem
><para
>Mah Jonggi reeglite kasutamine leidmaks, kas väljakuulutatud võitja jaotus on ikka tõepoolest võitev jaotus.</para
></listitem>
                        <listitem
><para
>võitja korral rakendatavate võitja reeglite lisamine</para
></listitem>
                        <listitem
><para
>kui mõnel leitud reeglil on toiming "&absolute;", siis ainult nende alles jätmine. Praegu ei ole veel määratletud, mis juhtub siis, kui neid leitakse enam kui üks.</para
></listitem>
                        <listitem
><para
>kui mõned reeglid defineerivad piirangud, siis kõigi teiste hülgamine</para
></listitem>
                        <listitem
><para
>leitud reeglite rakendamine toodud järjekorras</para
></listitem>
                </itemizedlist>
        </para>
        </sect2>
        </sect1>
        <sect1 id="ruledefinition">
        <title
>Definitsioon</title>
        <para
>Definitsioon koosneb ühestainsast stringist, sest seda peab olema hõlpus salvestada andmebaasi. See koosneb mitmest osast, mida eraldavad kaks märki "||". Iga osa väljendab kas tingimust, mille korral reeglit rakendatakse, või siis mõnda toimingut. Defineerida saab ainult ühe toiminguosa, kuid tingimusavaldisi võib olla mitu. Reegel rakendub otsekohe, kui vähemalt üks tingimus vastab jaotusele.</para
><para
>&kajongg; pakub omalt poolt valmisreeglistikku, mis vastab klassikalise hiina mängu reeglitele, nagu need on defineerinud Saksamaa DMJL. See peaks andma ohtralt eeskuju.</para
><para
>Lubatud osad on järgmised:</para>
        <variablelist>
                <varlistentry>
                        <term
>Tõstutundetu regulaaravaldis</term>
                        <listitem
><para
>Osa, mille alguses seisab I, on <link linkend="regex"
>regulaaravaldis</link
>, mis ei tee vahet suur- ja väiketähtedel. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Toiming</term>
                        <listitem
><para
>Osa, mille alguses seisab A, sisaldab <link linkend="actions"
>toimingute</link
> nimekirja. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Käsitsimängu avaldis</term>
                        <listitem
><para
>See on täiendav <link linkend="regex"
>regulaaravaldis</link
>. Mängu tulemuse käsitsi määramise korral määrab see, kas kasutaja saab antud reeglit valida märkekastiga. Osa alustav M ei kuulu regulaaravaldise hulka. Näiteks võib tuua reegli "Viimase kivi võtmine surnud müürist". </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Regulaaravaldis</term>
                        <listitem
><para
>Kõik muud osad kujutavad endast <link linkend="regex"
>regulaaravaldist</link
>. </para
></listitem>
                </varlistentry>
        </variablelist>
        </sect1>
        <sect1 id="regex">
        <title
>Regulaaravaldised</title>
        <para
>Regulaaravaldised on väga võimas programmeerimise abivahend, mis võimaldab leida sobivaid märgistringe. Aga see on ühtlasi ka päris keeruline ja raske. Kindlasti ei ole see mõeldud tavalise mängija jaoks. On lausa terved raamatud, mis ainult regulaaravaldiste seletamisega tegelevadki.</para>
        <para
>Regulaaravaldistel on mitmeid "dialekte". &kajongg; on kirjutatud programmeerimiskeeles Python. Et Pythoni standardteek sisaldab regulaaravaldiste moodulit, siis seda dialekti ongi kasutatud. </para
><para
>Lähemalt räägib sellest <ulink url="http://docs.python.org/library/re.html#regular-expression-syntax"
></ulink
> </para
><para
>Kogu teave jaotuse kohta, mis võib mõjutada tulemust, on kodeeritud ühteainsasse stringi. &kajongg; kontrollib siis, kas regulaaravaldis vastab sellele stringile. Kui jah, siis reeglit ka rakendatakse.</para>
        <para
>Toome näiteks regulaaravaldise, mis vastab piirangujaotusele "Kõik rohelised":</para
><programlisting
>( |[bB][23468]|[dD]g)*[fy/]</programlisting>
        <sect2
><title
>Jaotusestringi struktuur</title>
        <para
>Jaotusestringi sisu on alati ühesugune sõltumata sellest, millist keelt kasutad oma töökeskkonnas.</para>
        <para
>Jaotust esindav string koosneb mitmest osast, mida eraldavad tühikud. Nende osade järjestus on alati ühesugune, välja arvatud alguses leiduvad kombinatsioone puudutavad osad.</para>
        <para
>&kajongg; võib varjatud kivid rühmitada sellistesse kombinatsioonidesse, et tulemus oleks võimalikult hea. Sealjuures ei ole vahet, kuidas varjatud kivid on õieti rühmitatud. Aga kui tegemist on piirangujaotustega, siis ei pruugi see toimida. Seepärast püüab &kajongg; kasutada kivide algset rühmitamist, nagu selle on sisestanud kasutaja, aga ka ümberrühmitatud kive. Mõlema variandi korral rakendatakse kõiki reegleid. Kasutusele võetakse see variant, mis saavutab suurema kogutulemuse.</para>
        <para
>Toome siin näite. Tegelikult on see kõik ühel real, aga loetavuse huvides jagasime selle siin kahe rea peale. Lisaks on seda korratud, sest mõningaid regulaaravaldisi on palju hõlpsam kirjutada, kui selle osade järjestust saab muuta. Vaatame kongi röövimise reeglit: selle regulaaravaldis uurib enne kombinatsioone gruppi L (viimane kivi).</para
><programlisting
><literal
>c1c1c1C1 s1s2s3 b6b6b7b7b8b8 b5b5 fn yn
/c416s000b000b000b200 -C416s000b000b000b200 %n Mneka LB5B5B5</literal
></programlisting>
<para
>Kivi tähistab kaks märki. Esimese puhul tähistab s kivi (stone), b bambust, c märki (character), w tuult (wind), d draakonit, y aastaajaboonust ja f lilleboonust. Teise märgi puhul tähistavad 1-9 kive, e, s, w, n tuuli, w, r, g draakoneid (white - valge, red - punane, green - roheline) ning 1, 2, 3, 4 boonuskive. Paljastatud kivide puhul on esimene märk väike-, varjatud kivide puhul suurtäht.</para>
<para
>Kõik järgnevad osad on alati olemas ja just sellises järjekorras, välja arvatud osa "Viimane kivi". See on olemas ainult võitva jaotuse puhul. <variablelist>
                <varlistentry>
                        <term
>Kombinatsioon</term>
                        <listitem
><para
>Osa, mis algab mõnega järgmistest tähtedest, on kombinatsioon: <literal
>sbcdwSBCDW</literal
>. Kombinatsioon võib sisaldada suvalise arvu kive. &kajongg; jagab liiga paljude kividega kombinatsioonid, püüdes saavutada maksimaalse tulemuse.</para
><para
>Kongide puhul on kasutusel eriline süntaks: c1c1c1c1 on paljastatud kong, c1c1c1C1 on paljastatud kong, mille neljas kivi täiendas varjatud pungi. Seda on vaja piirangumänguks "varjatud õiges värvis mäng". c1C1C1c1 on varjatud väljakuulutatud kong, C1C1C1C1 varjatud väljakuulutamata kong. Aga et see ei ole välja kuulutatud, käsitletakse seda pungina. Niisiis, see kombinatsioon jagatakse pungiks C1C1C1 ja üksikuks C1.</para
><para
>Boonuskivid esinevad pärast kõiki kombinatsioone.</para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Kokkuvõte</term>
                        <listitem
><para
>Osa, mille alguses seisab /, sisaldab kokkuvõtlikku teavet kombinatsioonide kohta. See muudab mõningate regulaaravaldiste kirjutamise lihtsamaks. Iga kombinatsiooni tähistab neli märki. Esimene on üks märkidest <literal
>sbcdwSBCDW</literal
> ning ka siin tähistab väiketäht paljastatud ja suurtäht varjatud kivi. Teine märk on number, mis teatab, mitut kivi kombinatsioon sisaldab. See on kongi puhul vahemikus 1 kuni 4. Chow' puhul kasutatakse 0. Viimased kaks märki sisaldavad kombinatsiooni väärtust. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Alternatiivne kokkuvõte</term>
                        <listitem
><para
>Osa, mille alguses seisab -, on samasugune äsja tutvustatud kokkuvõttega, kuid see sisaldab nõueldud konge varjatud kongidena. Mõned reeglid, näiteks "Kolm varjatud pongi", käsitlevad nõueldud kongi varjatuna. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Jaotuse pikkus</term>
                        <listitem
><para
>Osa, mille alguses seisab %, sisaldab teavet jaotuse pikkuse kohta: s tähistab lühikest kätt, milles on liiga vähe kive, n korrektse kivide arvuga jaotust ja l pikka kätt, milles on liiga palju kive. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Mah Jongg</term>
                        <listitem
><para
>Osa, mille alguses seisab m, M või x, sisaldab lisateavet. M tähistab võitvat jaotust, m kaotavat jaotust ja x jaotust, mille korral on keelatud kuulutada Mah Jonggi. M/m/x järel seisab üks märk oma tuule, üks märk valitseva tuule, üks märk Mah Jonggini viinud viimase kivi päritolu ja üks märk mängija tehtud väljakuulutamiste kohta.</para
><para
>Viimane kivi võib olla pärit mitmest kohast: w=müür, d=äravisatud, e=surnud müür, z=elava müüri viimane kivi, Z=elava müüri viimane kivi, ära visatud, k=kongi röövimine, l=taevane/maine õnnistus. Väärtused w ja d on erilised - need on omamoodi vaheväärtused. Kui valida viimaseks kiviks varjatud kivi, määratakse päritoluks w. Edasi sätestavad mitmed reeglid, et neid saab rakendada ainult juhul, kui viimane kivi on pärit müürist. Niisiis võimaldab see tegelikult rakendatavate reeglite paremat eelvalikut. Asja paremaks mõistmiseks lugege palun tulemuste käsitsi määramise reegleid, samuti <link linkend="actions"
>toimingu</link
> &lastsource; kohta.</para
> <para
>Võimalikud väljakuulutamised on järgmised: a=avakäigul, t=kahekordne õnn. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Viimane kivi</term>
                        <listitem
><para
>Osa, mille alguses seisab L, sisaldab teavet viimase kivi kohta. Seal on kirjas viimane kivi ise ja seejärel kombinatsioon, mis lõpetati viimase kiviga. Seda viimast kombinatsiooni on vaja reeglile "Viimane kivi on ainuke võimalik", sest mõnikord ei piisa ainult viimase kivi teadmisest. Pane tähele, et viimane kombinatsioon ei saa olla kong, sest kui see lõpetab kongi, tuleb võtta asenduskivi. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>Piirangujaotus</term>
                        <listitem
><para
>See ei ole veel teostatud, kuid seda võib vaja minna selliste reeglite jaoks, nagu on näiteks defineerinud BMJA (Inglismaal). Osa, mille alguses seisab K, sisaldab kõiki võimalikke kive, mille olemasolu tuleb kontrollida, et jagada punkte piirangujaotuse eest. Võiks muidugi käituda ka sirgjoonelisemalt ja kontrollida kõiki kive, aga see võiks võtta liiga palju aega. </para
></listitem>
                </varlistentry>
        </variablelist>
        </para>
        </sect2>
        </sect1>
        <sect1 id="actions">
        <title
>Toimingud</title>
        <para
>Kõik reegli toimingud on defineeritud ühesainsas stringis. Neid eraldavad tühikud. Mõned neist defineerivad väärtuse. </para>
        <variablelist>
                <varlistentry>
                        <term
>&payforall;</term>
                        <listitem
><para
>Mängija tegi midagi väga vastikut, mistõttu ta peab kõigile tasuma. See ei ole siiski karistus, sest tasusumma on sama, ainult tasuja muutub. Lisaks ei pea kaks asjasse mittepuutuvat tasujat summasid vahetama. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>&payers;=X</term>
                        <listitem
><para
>Defineerib, mitmele tasujale see karistusreegel kehtib. X on arv. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>&payees;=X</term>
                        <listitem
><para
>Defineerib, mitmele saajale see karistusreegel kehtib. X on arv. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>&absolute;</term>
                        <listitem
><para
>See toiming defineerib absoluutse tasu. Jaotuse tulemist eiratakse. Seda kasutatakse karistusreeglite puhul. </para
></listitem>
                </varlistentry>
                <varlistentry>
                        <term
>&lastsource;</term>
                        <listitem
><para
>See toiming defineerib viimase kivi päritolu. Seda kasutatakse mängu tulemuste käsitsi sisestamisel selliste reeglite puhul, nagu näiteks "viimane kivi surnud müürist". Viimase kivi päritolu määramine selle toiminguga on omamoodi filter teistele reeglitele - need võivad rakenduda ainult teatava päritolu korral. Need teised reeglid võivad mõistagi samuti olla mängu tulemuste käsitsi määramise reeglid. Niisiis, piirab see filter reeglite hulka, mida kasutaja näeb tulemuste dialoogis. Kui see tundub esmapilgul veidi keerulisena, mängi veidi ning uuri tulemuste dialoogi, et näha, kuidas märkekastid ilmuvad ja kaovad vastavalt sellele, milline oli viimase kivi päritolu. </para
></listitem>
                </varlistentry>
        </variablelist>
        </sect1>
</chapter>

<chapter id="problems"
><title
>Teadaolevad probleemid</title>
        <itemizedlist>
                <listitem
><para
>Praegu ei ole veel mängijal endal võimalik avada kontot mänguserveris.</para
></listitem>
                <listitem
><para
>Mängimisrežiimis ei ole veel karistused võimalikud.</para
></listitem>
                <listitem
><para
>Arvutimängijad on veel üpris rumalad.</para
></listitem>
                <listitem
><para
>Arvutimängijate nimesid ei saa veel muuta.</para
></listitem>
                <listitem
><para
>Arvutimänge ei saa veel jätkata.</para
></listitem>
        </itemizedlist>
</chapter>

<chapter id="future"
><title
>Võimalikud tulevased omadused</title>
        <itemizedlist>
                <listitem
><para
>Uued reeglistikud. Soovitavalt võiksid neid pakkuda inimesed, kes kasutavad pakutud reeglistikku regulaarselt.</para
></listitem>
                <listitem
><para
>Helide lisamine. Väljakuulutamisi "chow" jne. peaks olema võimalik esitada, samuti ära visatud kivide nimesid. Standardhelide kindlaks määramine, samuti mängijatele võimaluse andmine salvestada oma häält.</para
></listitem>
        </itemizedlist>
</chapter>

 <chapter id="faq"
><title
>Korduma kippuvad küsimused</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
>Ma soovin muuta mängu välimust. On see võimalik? </para
></question>
                 <answer
><para
>Jah. &kappname;i välimuse muutmiseks kasuta <link linkend="settings-menu-settings"
>menüükäsku</link
>, mis avab <link linkend="configuration"
>seadistustedialoogi</link
>.</para
></answer>
        </qandaentry>
        <qandaentry>
                 <question
><para
>Kas kive saab mängijatele omistada ka klaviatuuri abil?</para
></question>
                 <answer
><para
>Jah. Vaata lõiku <link linkend="enterhand-tiles"
>Tulemuse arvutab &kajongg;</link
>.</para
></answer>
        </qandaentry>
<!--Please add more Q&As if needed-->

</qandaset>
</chapter>

<chapter id="credits"
><title
>Autorid ja litsents</title
> <!-- do not change this! -->
<!--This chapter is for credits and licenses.-->
	<para
>&kde; &kappname; </para>

	<para
>Rakenduse autoriõigus &copy; 2009, 2010: <personname
><firstname
>Wolfgang</firstname
><surname
>Rohdewald</surname
></personname
> <email
>wolfgang@rohdewald.de</email
> </para>
	<para
>Dokumentatsiooni autoriõigus &copy; 2009, 2010: <personname
><firstname
>Wolfgang</firstname
><surname
>Rohdewald</surname
></personname
> <email
>wolfgang@rohdewald.de</email
> </para>

<!-- !!!do not change ANYTHING after this line!!!! -->
<para
>Tõlge eesti keelde: Marek Laane <email
>bald@smail.ee</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Paigaldamine</title>
<para
>Kasuta .deb-paketti aadressilt <ulink url="http://www.kde-apps.org/content/show.php/kajongg?content=103206"
></ulink
>. Kui see ei toimi, võid samalt aadressilt alla laadida kajongg-x-y.tar.gz ja seejärel sooritada järgmised toimingud: <programlisting
>tar xfz kajongg-x-y.tar.gz
cd kajongg-x-y
./setup.py install
</programlisting>
</para
><para
>Mõlemal juhul tuleb üle kontrollida, et paigaldatud oleks ka mõned muud vajalikud paketid. Debiani pakett ei sisalda veel selliseid nõudmisi. &kajongg; vajab (sulgudes on ära toodud vastavad Debiani paketid): </para>
<itemizedlist>
	<listitem
><para
>KDE4 mängude teek (libkdegames5)</para
></listitem>
	<listitem
><para
>Python 2.5 või uuem (python)</para
></listitem>
	<listitem
><para
>QT4.4 või uuem (libqt4-core, libqt4-gui, libqt4-svg, libqt4-sql, libqt4-sql-sqlite)</para
></listitem>
	<listitem
><para
>QT4 Pythoni seosed (python-qt4, python-qt4-sql)</para
></listitem>
	<listitem
><para
>KDE4 Pythoni seosed (python-kde4)</para
></listitem>
        <listitem
><para
>Pythoni twisted teek (python-twisted-core)</para
></listitem>
        <listitem
><para
>sqlite3 (libsqlite3-0)</para
></listitem>
</itemizedlist>

</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:
-->
