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

<!-- The language must NOT be changed here. -->

<book lang="&language;">

<bookinfo>
<title
>&kalarm;i käsiraamat</title>

<authorgroup>
<author
> <firstname
>David</firstname
> <othername
></othername
> <surname
>Jarvie</surname
> <affiliation
> <address
><email
>software@astrojar.org.uk</email
></address
> </affiliation
> </author>
</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>

<copyright>
<year
>2001</year
><year
>2002</year>
<holder
>David Jarvie</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<!-- Don't change format of date and version of the documentation -->

<date
>2002-10-04</date>
<releaseinfo
>0.08.01</releaseinfo>

<abstract>
<para
>&kalarm; on &kde; personaalsete häirete ja meeldetuletuste ajastaja.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>häire</keyword>
<keyword
>meeldetuletus</keyword>
</keywordset>

</bookinfo>


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

<para
>&kalarm; on personaalsete häireteadete ja -käskude ajastaja. See võimaldab määrata eraviisilisi häireid või meeldetuletusi, mis ilmuvad teadetena ekraanile just määratud ajal või käivitavad mingi tegevuse.</para>

<para
>Vaikimisi käivitatavas graafilises režiimis näitab &kalarm; ootel olevate häirete nimekirja ühes käivitamise aja ja muude üksikasjadega. On võimalik luua uusi häireid või valida olemasolev, et seda muuta või sootuks kustutada.</para>

<para
>Häiret luues või muutes on võimalik kirjutada häire teate tekst, valida tekstifail, mida sel puhul näidatakse, või tegevus, mis käivitatakse. Samuti saab valida häireteate värvi, selle kordumise, heli esitamise ja selle, kas häire tuleb tühistada või mitte, kui seda ei ole võimalik anda ettenähtud ajal.</para>

<para
>Häireid saab ajastada ka käsurea abil või rakenduste esitatavate &DCOP; väljakutsete vahendusel.</para>

<para
>Kui häire aeg on kätte jõudnud, käivitatakse see kõigil &kde; töölaudadel, et sa kindlasti seda tähele paneksid. Teateaken näitab aega, millele häire on ajastatud. Tavaliselt on seal võimalik ka häiret edasi lükata. Üks näide häire kohta:</para>

<screenshot
> <screeninfo
>&kalarm;i teate aken</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="alarmmessage.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Häireteade</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Kui häire on määratud mingit käsku käivitama, ei näita &kalarm; teadet.</para>

<para
>&kalarm; võib töötada kahes režiimis: <quote
>pidev</quote
> (vaikimisi), mille puhul see töötab &kde; süsteemses salves, või <quote
>nõudmisel</quote
>, mille puhul see töötab ainult siis, kui vaja (soovi korral näidates ka siis ennast ikoonina süsteemses salves).</para>

<para
>Käesolevas käsiraamatus on korduvalt viidatud <application
>häiredeemon</application
>ile. See on rakendus, mis toimib taustal, kontrollides ootel olevaid häireid ja andes &kalarm;ile tegutseda, kui õige aeg on kätte jõudnud.</para>

</chapter>

<chapter id="using-kalarm">
<title
>&kalarm;i kasutamine</title>

<sect1 id="graphmode">
<title
>Graafiline režiim</title>

<para
>Käivitamisel ilma käsurea argumentidega alustab &kalarm; tööd graafilises režiimis. Sellisel kujul näitab ta peaaknas eesseisvaid häireid koos käivitamise ajaga, kordamise intervalli, värvide ning näidatava teksti, teksitfaili nime või käivitatava käsuga. (Korduva alarmi korral on näidatav aeg järgmine käivitumise aeg.) Iga häire teksti/faili/käsu kõrval vasakul pool asuv ikoon näitab, millist tüüpi häirega on tegemist.</para>

<screenshot
> <screeninfo
>&kalarm;i peaken</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Peaaken</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Korduva häire korral on nimekirjas näidatud selle järgmise käivitumise aeg ja pärast seda määratud korduvate käivitamiste arv.</para>

<para
>Häireid võib sorteerida kuupäeva/aja, kordumise intervalli, värvi või teksti järgi, klõpsates vastava veeru tiitliribale. Sorteerimiseks samal alusel, aga vastupidises järjekorras klõpsa uuesti tiitliribale.</para>

<para
>Kui &kalarm; käivitada graafilises režiimis, kontrollib ta, kas <application
>häiredeemon</application
> töötab või mitte. Kui ei, siis paneb &kalarm; selle tööle.</para>

<sect2>
<title
>Uue häire lisamine</title>

<para
>Uue häire lisamiseks vali menüükäsk <menuchoice
> <guimenu
>Tegevused</guimenu
><guimenuitem
>Uus</guimenuitem
></menuchoice
>. See avab edaspidi kirjeldatava häire redigeerimise dialoogi.</para>

</sect2>

<sect2>
<title
>Olemasoleva häire muutmine</title>

<para
>Olemasoleva häire muutmiseks:</para>

<itemizedlist
> <listitem
> <para
>Tee topeltklõps selle nimel häirete nimekirjas</para
> </listitem
> <listitem
> <para
>või vali see klõpsuga häirete nimekirjas ja kasuta seejärel menüükäsku <menuchoice
><guimenu
>Tegevused</guimenu
><guimenuitem
>Muuda</guimenuitem
></menuchoice
></para
> </listitem
> <listitem
> <para
>või klõpsa selle nimel häirete nimekirjas hiire <mousebutton
>parema</mousebutton
> nupuga ja vali ilmuvast menüüst käsk <menuchoice
><guimenuitem
>Muuda</guimenuitem
></menuchoice
>.</para
> </listitem
> </itemizedlist>

<para
>Ükspuha millise võimaluse kasutamisel ilmub häire redigeerimise dialoog:</para>

<screenshot
> <screeninfo
>Häire redigeerimise dialoog</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="editwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Häire redigeerimise dialoog</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Sektsioonis <guilabel
>Tegevus</guilabel
> vali <guilabel
>Tekst</guilabel
>, kui soovid sisestada allolevasse kasti teksti (see võib olla ka mitmerealine), <guilabel
>Fail</guilabel
>, mille puhul saad sisestada tekstifaili nime või &URL;-i, mille sisu soovid lasta häireteates näidata, või <guilabel
>Käsk</guilabel
>, mille puhul saad määrata käivitatava shellikäsu. Kui valid võimaluse <guilabel
>Fail</guilabel
>, ilmub tekstikastist paremale nupp, millele klõpsates avaneb faili valimise dialoog.</para>

<para
>Kui häire on korduv ja on viimasel näitamisel edasi lükatud, siis näitab sektsioon <guilabel
>Edasilükatud häire</guilabel
> aega, millele häire on edasi lükatud. Klõps nupul <guibutton
>Muuda...</guibutton
> avab dialoogi, kus saab edasilükkamise aega muuta või selle üldse tühistada.</para>

<para
>Sektsioonis <guilabel
>Aeg</guilabel
> saab</para>

<itemizedlist
> <listitem
> <para
>kasti <guilabel
>Kuupäev/kellaaeg</guilabel
> sisestada kuupäeva ja aja, millal häire käivitatakse. Märgi ära kast <guilabel
>Suvaline aeg</guilabel
>, kui soovid määrata ainult kuupäeva. Sellisel juhul näidatakse häiret tol kuupäeval esimesel võimalusel või pärast määratud algusaega (selle määramist kirjeldab osa <link linkend="preferences"
>Vaikeväärtuste seadistamine</link
>).</para
> </listitem
> <listitem
> <para
>kastis <guilabel
>Praegusest ajast alates</guilabel
> sisestada, millal pärast praegust hetke (tundides ja minutites) tuleks häire käivitada.</para
> </listitem
> </itemizedlist>

<para
>Sektsioonis <guilabel
>Kordamine</guilabel
> saab määrata, kas üldse häiret korrata ja kui jah, siis kuidas ja millal.</para>

<itemizedlist
> <listitem
><para
>Häire ühekordseks käivitamiseks vali <guilabel
>Ei korrata</guilabel
>.</para
></listitem
> <listitem
><para
>Häire käivitamiseks igakordsel sisselogimisel vali <guilabel
>Korratakse sisselogimisel</guilabel
>(arvesta, et sisselogimisel korratav häire käivitub ka juhul, kui oled häired keelanud ja need taas lubad või kui <application
>häiredeemon</application
>i uuesti käivitad või nullid).</para
></listitem
> <listitem
><para
>Häire kordamiseks kindla ajavahemiku tagant vali <guilabel
>Korratakse</guilabel
>. Seejärel tuleb kordumise reegel paika panna kaardil <guilabel
>Kordamine</guilabel
>.</para
> <para
>Sektsioonis <guilabel
>Kordamise reegel</guilabel
> saab määrata kordamise perioodi, valides meelepärase tüübi ning märkides kastis <guilabel
>Korratakse iga</guilabel
> ära, milline hulk vastavaid perioode peab korduste vahele jääma. Näiteks selleks, et häire korduks iga kahe nädala järel, vali <guilabel
>päeva tagant</guilabel
> ja sisesta kasti 14 või vali <guilabel
>nädala tagant</guilabel
> ja kirjuta kasti 2. Vastavalt valitud perioodile saab kasutada ka lisavalikuid:</para
> <itemizedlist
> <listitem
> <para
>nädalase vahe korral saab valida, millisel nädalapäeva peaks häire käivituma.</para
> </listitem
> <listitem
> <para
>kuise vahe korral saab valida kas konkreetse kuupäeva või määratud nädalapäeva (&eg; teine teisipäev).</para
> </listitem
> <listitem
> <para
>aastase vahe korral saab valida kas konkreetse kuupäeva või määratud kuu päeva (&eg; mai viimane laupäev).</para
> </listitem
> </itemizedlist
> <para
>Sektsioonis <guilabel
>Kordamise lõpetamine</guilabel
> saab määrata kordamiste ajalise ulatuse:</para
> <itemizedlist
> <listitem
><para
><guilabel
>ei lõpegi</guilabel
> tähendab kordamist igavesti.</para
></listitem
> <listitem
><para
><guilabel
>lõpp saabub pärast</guilabel
> lubab määrata korduste koguarvu.</para
></listitem
> <listitem
><para
><guilabel
>lõpp saabub</guilabel
> lubab määrata kuupäeva/aja,millal häiret viimane kord korratakse.</para
></listitem
> </itemizedlist
> </listitem
> </itemizedlist>

<para
>Märkekastiga <guilabel
>Tähtaja möödumisel häire katkestatakse</guilabel
> saab määrata, mis juhtub siis, kui häiret ei ole võimalik käivitada määratud ajal. Märkimise korral katkestatakse häire, kui seda ei ole võimalik käivitada minuti jooksul pärast määratud aega. Märkimatajätmise korral käivitatakse häire pärast määratud aja möödumist esimesel võimalusel. Ainult kuupäevaga määratud häired, &ie; need, mille korral on valitud <guilabel
>Suvaline aeg</guilabel
>, katkestatakse juhul, kui neid ei ole võimalik käivitada 24 tunni jooksul pärast määratud aega.</para>

<note
><para
>Häire on võimalik käivitada ainult siis, kui oled end sisse loginud ja kui nii X kui ka <application
>häiredeemon</application
> töötavad.</para
></note>

<para
>Kast <guilabel
>Häire nägemise kinnituse küsimine</guilabel
> lubab määrata, kas häireteate akna sulgemisel küsitakse sinu käest kinnitust. See võib olla kasulik näiteks häirete juhuslike sulgemiste vastu.</para>

<para
>Kasti <guilabel
>Heli</guilabel
> märkimisel käivitatakse häireteate näitamisel ka mingi heli. Vaikimisi on see piiks, kuid parema pool asuvale nupule klõpsates saab valida ka mõne meelepärase helifaili. Uus klõps nupul taastab vaikeväärtuse ehk piiksu. Kui soovid näha, milline heli parajasti on valitud, liiguta hiir nupu kohale ja oota , kuni ilmub kohtspikker.</para>

<para
>Häireteate aknale saab valida ka taustavärvi.</para>

<para
>Kui kõik üksikasjad on soovikohaselt paika pandud, klõpsa nupule <guibutton
>OK</guibutton
>, mis lisab häire nimekirja.</para>

</sect2>

<sect2>
<title
>Olemasoleva häire kustutamine</title>

<para
>Olemasoleva häire kustutamiseks:</para>

<itemizedlist
> <listitem
> <para
>vali häire klõpsuga selle nimel nimekirjas. Seejärel vali menüükäsk <menuchoice
> <guimenu
>Tegevused</guimenu
><guimenuitem
>Kustuta</guimenuitem
> </menuchoice
>.</para
> </listitem
> <listitem
> <para
>klõpsa hiire <mousebutton
>parema</mousebutton
> nupuga häire nimel nimekirjas ja vali ilmuvast menüüst <menuchoice
><guimenuitem
>Kustuta</guimenuitem
></menuchoice
>.</para
> </listitem
> </itemizedlist>

</sect2>

<sect2>
<title
>Häire nägemise kinnitamine</title>

<para
>Seda, kuidas anda märku häire kättesaamisest, vaata osast <link linkend="message-window"
>Häireteate aken</link
>.</para>

</sect2>

<sect2>
<title
>&kalarm;i näitamine süsteemses salves</title>

<para
>&kalarm;i näitamiseks süsteemses salves peab töötama &kde; töölaud. Kui &kalarm; töötab <quote
>pidevas</quote
> režiimis, on süsteemse salve ikoon alati nähtaval. Siintoodud juhised kehtivad ainult <quote
>nõudmisel</quote
> režiimi korral (täpsemat infot töörežiimide kohta leiab osast <link linkend="preferences"
>Vaikeväärtuste seadistamine</link
>).</para>

<para
>&kalarm;i nägemiseks &kde; süsteemses salves vali menüükäsk <menuchoice
> <guimenu
>Vaade</guimenu
><guimenuitem
>Näita ikooni süsteemses salves</guimenuitem
></menuchoice
>.</para>

<para
>&kalarm;i näitamise lõpetamiseks &kde; süsteemses salves:</para>

<itemizedlist
> <listitem
> <para
>vali menüükäsk <menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Ära näita ikooni süsteemses salves</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>klõpsa hiire <mousebutton
>parema</mousebutton
> nupuga süsteemse salve ikoonil ja vali ilmuvast menüüst <menuchoice
><guimenuitem
>Välju</guimenuitem
></menuchoice
>.</para
> </listitem
> </itemizedlist>

<para
>Süsteemse salve ikooni kasutamist kirjeldatakse <link linkend="system-tray"
>edaspidi</link
>.</para>

</sect2>

<sect2 id="enable-disable">
<title
>Häire jälgimise lubamine/keelamine</title>

<sect3>
<title
>Häire jälgimise lubamine</title>

<para
>Kui &kalarm; töötab <quote
>pidevas</quote
> režiimis ning seadistuste dialoogis on märgitud <guilabel
>Kui süsteemses salves ikooni pole, siis keelatakse häired</guilabel
>, pead kontrollima, et &kalarm; ikka töötaks, sest muidu ei ole ka häirete jälgimine võimalik.</para>

<para
>Kui häire jälgimine on parajasti keelatud, siis:</para>

<itemizedlist
> <listitem
> <para
>vali menüükäsk <menuchoice
><guimenu
>Tegevused</guimenu
> <guimenuitem
>Häired lubatud</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>klõpsa hiire <mousebutton
>parema</mousebutton
> nupuga ikoonil süsteemses salves ja vali menüüst <menuchoice
><guimenuitem
>Häired lubatud</guimenuitem
></menuchoice
>.</para
> </listitem
> </itemizedlist>

<para
>Seejärel käivitatakse vajadusel <application
>häiredeemon</application
> ning häireid asutakse nende tähtaja saabumisel jälgima.</para>

<warning
><para
><application
>Häiredeemon</application
>i käivitamine mõjutab kõiki rakendusi, mis <application
>häiredeemon</application
>it kasutavad.</para
></warning>

</sect3>

<sect3>
<title
>Häire jälgimise keelamine</title>

<para
>Häire jälgimist saab mitmel moel keelata ja nii takistada &kalarm;il näitamast häireid seni, kuni need on taas lubatud või kuni  - eeldusel, et <application
>häiredeemon</application
> on seadistatud käivituma sisselogimisel - sa uuesti sisse logid.</para>

<para
>Häirete keelamiseks ilma <application
>häiredeemon</application
>it peatamata (ja sel moel mõjutamata kõiki muid rakendusi, mis samuti <application
>häiredeemon</application
>it kasutavad):</para>

<itemizedlist
> <listitem
> <para
>vali menüükäsk <menuchoice
><guimenu
>Tegevused</guimenu
> <guimenuitem
>Häired lubatud</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>klõpsa hiire <mousebutton
>parema</mousebutton
> nupuga ikoonil süsteemses salves ja vali menüüst <menuchoice
><guimenuitem
>Häired lubatud</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>kui &kalarm; töötab <quote
>pidevas</quote
> režiimis ja seadistuste dialoogis on märgitud <guilabel
>Kui süsteemses salves ikooni pole, siis keelatakse häired</guilabel
>, lihtsalt lõpeta &kalarm;i töö.</para
> </listitem
> </itemizedlist>

<para
>Häirete keelamiseks <application
>häiredeemon</application
>it peatades:</para>

<itemizedlist
> <listitem
> <para
>vali menüükäsk <menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Häiredeemoni juhtimine...</guimenuitem
></menuchoice
>. See avab teenuste halduri, kus on võimalik <application
>häiredeemon</application
> peatada.</para
> </listitem
> </itemizedlist>

<warning
><para
>See mõjutab ka kõiki muid rakendusi, mis kasutavad <application
>häiredeemon</application
>it.</para
></warning>

</sect3>
</sect2>

<sect2>
<title
>Häirete uuendamine</title>

<para
>Väga ebatõenäolisel juhtumil, kui mõni häire ei käivitu ajal, mil ta pidanuks käivituma, saab häirete nimekirja uuendada ja kõik vahelejäänud häired käivituma panna menüükäsuga <menuchoice
><guimenu
>Tegevused</guimenu
><guimenuitem
>Uuenda häireid</guimenuitem
></menuchoice
>.</para>

<para
>&kalarm; käivitab vahelejäänud häired uuesti, lähtestades <application
>häiredeemon</application
>i, millest on lähemalt juttu osas <link linkend="daemon-reset"
>Häiredeemon</link
>.</para>

</sect2>

<sect2>
<title
><application
>Häiredeemon</application
>i juhtimine</title>

<para
><application
>Häiredeemon</application
>i juhtimiseks vali menüükäsk <menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Häiredeemoni juhtimine...</guimenuitem
></menuchoice
>. See avab teenuste halduri, mis võimaldab <application
>häiredeemon</application
>i peatada või käivitada ning määrata, kas see peaks sisselogimisel automaatselt käivituma. Täpsemat infot leiab osast <link linkend="daemon-control"
>Häiredeemoni juhtimine teenuste halduri abil</link
>.</para>

</sect2>

<sect2>
<title
>Rakenduse töö lõpetamine</title>

<para
>&kalarm;i töö saab lõpetada kõiki selle aknaid ja süsteemse salve ikooni sulgedes või juhul, kui rakendus töötab <quote
>pidevas</quote
> režiimis, kõiki teateaknaid sulgedes ja valides süsteemse salve ikooni kontekstimenüüst <menuchoice
><guimenuitem
>Välju</guimenuitem
></menuchoice
>.</para>

<para
>Menüükäsk <menuchoice
><guimenu
>Fail</guimenu
> <guimenuitem
>Välju</guimenuitem
></menuchoice
> sulgeb ainult konkreetse akna. Süsteemse salve ikooni kontekstimenüü käsu <menuchoice
><guimenuitem
>Välju</guimenuitem
></menuchoice
> toime sõltub töörežiimist: <quote
>nõudmisel</quote
> režiimi korral peidetakse süsteemse salve ikoon, <quote
>pideva</quote
> režiimi korral lõpetatakse rakenduse töö.</para>

<tip
><para
>&kalarm;i töö lõpetamine ei mõjuta <application
>häiredeemon</application
>it, mis juhul, kui see juba töötab, jätkab ajastatud häirete jälgimist ja sunnib need määratud ajal ilmuma (kui seadistuste dialoogis ei ole just märgitud <guilabel
>Kui süsteemses salves ikooni pole, siis keelatakse häired</guilabel
>).</para
></tip>

</sect2>
</sect1>

<sect1 id="message-window">
<title
>Häireteate aken</title>

<para
>Kui häire määratud aeg kätte jõuab, näidatakse seda igal &kde; töölaual ning seda ei saa varjata tavalise aknaga, mis tagab, et sa kindlasti seda märkaksid. Teateaken näitab aega, millal häire pidi käivituma, nii et sa võid seda näha ka juhul, kui oled arvuti juurde naasnud pärast mõningast eemalolekut.</para>

<para
>Korduva häire korral ilmub juhul, kui eelmise häirega käivitunud aken on jäänud sulgemata, seesama aken uuesti. Nii välditakse arvukate ühesuguste teadete ilmumist ekraanile, kui sa mingil põhjusel ei soovi või ei saa teate nägemist kinnitada selle ilmumisel.</para>

<para
>Kui ilmub häireteate aken, võid:</para>

<itemizedlist
> <listitem
> <para
>kinnitada selle nägemist klõpsuga nupul <guibutton
>Sulge</guibutton
>. See sulgeb akna (pärast kinnituse küsimist, kui märgitud on võimalus <guilabel
>Häire kustutamisel küsitakse kinnitust</guilabel
>).</para
> </listitem
> <listitem
> <para
>valida häire edasilükkamise võimalused klõpsuga nupul <guibutton
>Lükka edasi</guibutton
>. Seejärel vali <guilabel
>Lükka edasi kuupäeavle/ajale</guilabel
> ja sisesta kuupäev ning aeg, millal teadet uuesti tuleks näidata, või <guilabel
>Lükka edasi ajavahemiku võrra</guilabel
> ja sisesta, mitme tunni ja minuti võrra tuleks teate näitamist edasi lükata. Seejärel klõpsa häireteate edasilükkamiseks nupul <guibutton
>Lükka edasi</guibutton
>.</para
> <note
><para
>Kui häire on korduv, peab aeg, millele see edasi lükatakse, olema varasem kui järgmise korduse aeg.</para
></note
> <note
><para
>Nupp <guibutton
>Lükka edasi</guibutton
> ei ilmu nende häirete korral, mida näidatakse sisselogimisel võimaluse <guilabel
>Korratakse sisselogimisel</guilabel
> valimise tõttu.</para
></note
> </listitem
> </itemizedlist>

<para
>Nupp, millel on kujutatud <guiicon
>&kalarm;</guiicon
>i ikoon, pakub mugava võimaluse &kalarm; aktiveerida. Sellel klõpsamine ei mõjuta kuidagi häireteate akent.</para>

</sect1>

<sect1 id="system-tray">
<title
>Süsteemse salve ikoon</title>

<para
>&kalarm; on võimalik panna tööle ikoonina &kde; süsteemses salves. See ikoon võimaldab üheainsa klõpsuga aktiveerida &kalarm;i ning lubab häire jälgimist nii juhtida kui vaadata selle olekut. Tavaline &kalarm;i ikoon näitab, et häireid jälgitakse, punane rist üle ikooni aga osutab, et alarme ei jälgita.</para>

<para
>Klõps hiire <mousebutton
>vasaku</mousebutton
> nupuga süsteemse salve ikoonil lülitab &kalarm;i peaakna näitamist ja peitmist.</para>

<para
>Klõps hiire <mousebutton
>parema</mousebutton
> nupuga süsteemse salve ikoonil avab selle kontekstimenüü:</para>

<variablelist
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Luba häired</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Lubab häirete jälgimist.</action
></para
> <para
>Täpsemat infot leiab osast <link linkend="enable-disable"
>Häire jälgimise lubamine/keelamine</link
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Häired lubatud</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Keelab häirete jälgimise.</action
></para
> <para
>Täpsemat infot leiab osast <link linkend="enable-disable"
>Häire jälgimise lubamine/keelamine</link
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>&kalarm;i seadistamine...</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Avab &kalarm;i seadistuste dialoogi.</action
></para
> <para
>Seadistuste dialoogi kirjeldatakse osas <link linkend="preferences"
>Vaikeväärtuste seadistamine</link
>. Seal on juttu ka &kalarm;i süsteemse salve ikooni puudutavatest valikutest.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Häiredeemoni juhtimine...</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Avab teenuste halduri dialoogi, kus muu hulgas saab juhtida ka häiredeemoni tegevust.</action
></para
> <para
>Täpsemat infot leiab osast <link linkend="daemon-control"
>Häiredeemoni juhtimine teenuste halduri abil</link
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Taasta/Minimeeri</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Taastab või minimeerib &kalarm;i peaakna.</action
></para
> <para
>See võimalus on kasutatav ainult <quote
>pideva</quote
> töörežiimi korral (töörežiime kirjeldab osa <link linkend="preferences"
>Vaikeväärtuste seadistamine</link
>).</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Välju</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Sulgeb &kalarm;i süsteemse salve ikooni.</action
></para
> <para
>Ainult <quote
>pidevas</quote
> töörežiimis sulgeb see käsk ka kõik &kalarm;i peaaknad. See ei mõjuta kuidagi <application
>häiredeemon</application
>i häirete jälgimist (kui just seadistuste dialoogis ei ole märgitud <guilabel
>Kui süsteemses salves ikooni pole, siis keelatakse häired</guilabel
>).</para
> </listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="preferences">
<title
>Vaikeväärtuste seadistamine</title>

<para
>&kalarm;i vaikeväärtuste määramiseks vali menüükäsk <menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>&kalarm;i seadistamine...</guimenuitem
></menuchoice
>. See avab, nagu nimigi ütleb, seadistuste dialoogi. Kaardil <guilabel
>Üldine</guilabel
> saab määrata &kalarm;i üldist käitumist:</para>

<itemizedlist
> <listitem
><para
>määrata &kalarm;i töörežiim. Valida saab selle pideva töötamise &kde; süsteemses salves või käivitumise ainult nõudmisel. See valik ei puuduta häirete näitamist määratud ajal, sest häirete nimekirja jälgib <application
>häiredeemon</application
>, mitte aga &kalarm; ise. &kalarm;i töötamine süsteemses salves muudab rakenduse ligipääsetavamaks ja näitab ühtlasi, kas häired on lubatud või mitte, kuid rakenduse pidev töö nõuab süsteemilt ka omajagu ressursse. Nii et kui su arvuti ei ole just väga võimas, on usutavasti mõistlikum valida <quote
>nõudmisel</quote
> töörežiim.</para
> <para
><quote
>Nõudmisel</quote
> töörežiimi korral on samuti võimalik lasta näidata süsteemse salve ikooni. Kahe režiimi põhierinevus seisab siin süsteemse salve sulgemise mõjus: <quote
>nõudmisel</quote
> töörežiimi korral ei mõjuta see kuidagi ühtegi &kalarm;i akent, <quote
>pideva</quote
> režiimi korral aga tähendab ikooni sulgemine ka kõigi &kalarm;i peaakende sulgemist.</para
> </listitem
> <listitem
><para
>kui määrad &kalarm;i töötama <quote
>pidevas</quote
> režiimis, võid keelata kõigi häirete näitamise, mille tähtaeg jääb aega, mil &kalarm; ei tööta.</para
> </listitem
> <listitem
><para
>määrata, et &kalarm;i süsteemse salve ikooni näidataks &kde; seansi sisselogimisel.</para
> </listitem
> <listitem
><para
>määrata &kalarm;i süsteemse salve ikooni uuendamise sageduse, et see näitaks, milliseid häireid parajasti jälgitakse. Sellega kaasneb kontroll, kas <application
>häiredeemon</application
> ikka töötab.</para
> </listitem
> <listitem
><para
>määrata alguskellaaja ainult kuupäevaga määratud häiretele, &ie; häiretele, mille puhul on valitud võimalus <guilabel
>Suvaline aeg</guilabel
>. Määratud kuupäeval käivituvad sellised häired alates alguskellaajast 24 tunni jooksul esimesel võimalusel.</para
> </listitem
> <listitem
><para
>määrata, kas iga kord, kui sulgeb häireteate, küsitakse sinu käest selle kinnitust.</para
> </listitem
> </itemizedlist>

<para
>Kaartidel <guilabel
>Häire vaikeväärtused</guilabel
> ja <guilabel
>Välimus</guilabel
> sab määrata häire redigeerimise dialoogi vaikeväärtusi:</para>
<itemizedlist
> <listitem
><para
>määrata häireteadete vaikimisi fondi ja taustavärvi.</para
> </listitem
> <listitem
><para
>määrata vaikeväärtused võimalustele <guilabel
>Tähtaja möödumisel häire katkestatakse</guilabel
> ja <guilabel
>Häire nägemise kinnituse küsimine</guilabel
>.</para
> </listitem
> <listitem
><para
>määrata piiksu võimaluse <guilabel
>Heli</guilabel
> vaikeväärtuseks.</para
> </listitem
> <listitem
><para
>määrata korduvate häirete vaikimisi kordumiste perioodi.</para
> </listitem
> </itemizedlist>

</sect1>

<sect1 id="cmdline-operation">
<title
>Käsurea kasutamine</title>

<para
>Kui käivitamisel määratakse mingid käsurea argumendid, siis ei näita &kalarm; ajastatud häirete nimekirja, mida kirjeldati eespool <link linkend="graphmode"
>graafilisest režiimist</link
> kõneldes. &kalarm;i spetsiifilisi käsurea argumente saab kasutada järgmiste toimingute teostamiseks:</para>

<itemizedlist
> <listitem
><para
>uue häire ajastamine</para
> </listitem
> <listitem
><para
><application
>häiredeemon</application
>i juhtimine</para
> </listitem
> <listitem
><para
>&kalarm;i esitusviisi juhtimine</para
> </listitem
> <listitem
><para
>abi hankimine</para
> </listitem
> </itemizedlist>

<para
>Muid käsurea argumente saab kasutada ennekõike muude rakenduste &kalarm;iga suhtlemise võimaldamiseks. Neid kirjeldatakse peatükis <link linkend="cmdline-interface"
>&kalarm;ist arendajatele</link
>.</para>

<para
>Käsureale tohib korraga kaasata ainult argumente ühe &kalarm;i toimingu tarbeks. Kui soovid läbi viia mitu toimingut, tuleb &kalarm; välja kutsuda mitu korda, andes iga kord konkreetse toimingu argumendid.</para>

<sect2 id="cmdline-schedule">
<title
>Uue häire ajastamine</title>

<para
>Uue häire ajastamiseks saab kasutada järgmisi argumente:</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Argument</entry
> <entry
>Kirjeldus</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry
> <entry
>Kinnituse küsimine häire nägemisel ja sulgemisel.</entry
> </row
> <row
> <entry
><option
>-b</option
>, <option
>--beep</option
></entry
> <entry
>Kuuldava piiksu esitamine teate näitamisel. Selle argumendi korral ei tohi kasutada argumenti <option
>--sound</option
>.</entry
> </row
> <row
> <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>värv</replaceable
></option
></entry
> <entry
>Määrab teate taustavärvi vastava &Qt; värvi nime või 16-koodis 0xRRGGBB kohaselt.</entry
> </row
> <row
> <entry
><option
>-e</option
>, <option
>--exec <replaceable
>käsurea käsk</replaceable
></option
></entry
> <entry
>Määrab käivitatava shellikäsu. Selle kasutamise korral peab see &kalarm;i argument olema &kalarm; käsurea viimane argument. Kõiki eelnevaid argumente tõlgendatakse käivitatava käsu osana. Selle korral ei saa kasutada argumenti <option
>--file</option
>. Argumente <option
>--ack-confirm</option
>, <option
>--beep</option
> ja <option
>--color</option
> aga lihtsalt ignoreeritakse.</entry
> </row
> <row
> <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry
> <entry
>Määrab tekstifaili nime või &URL;-i, mille sisu kujutab endast häireteate sisu. Selle argumendiga koos ei saa kasutada <replaceable
>message</replaceable
>.</entry
> </row
> <row
> <entry
><option
>-i</option
>, <option
>--interval <replaceable
>periood</replaceable
></option
></entry
> <entry
>Määrab intervalli häire kordamiste vahel. Tunnid ja minutid määratakse vormingus <replaceable
>nHnM</replaceable
>, kus <replaceable
>n</replaceable
> on number, &eg; 3H30M. Muud perioodid määratakse vormingus <replaceable
>nX</replaceable
>, kus <replaceable
>n</replaceable
> on number ja <replaceable
>X</replaceable
> üks järgmistest tähtedest: Y (aastad), M (kuud), W (nädalad), D (päevad). See argument on kohustuslik, kui kasutatakse argumente <option
>--repeat</option
> või <option
>--until</option
>.</entry
> </row
> <row
> <entry
><option
>-l</option
>, <option
>--late-cancel</option
></entry
> <entry
>Katkestab häire, kui seda pole võimalik käivitada määratud ajal.</entry
> </row
> <row
> <entry
><option
>-L</option
>, <option
>--login</option
></entry
> <entry
>Käivitab häire igal sisselogimisel. Selle argumendi kasutamisel ei saa kasutada argumente <option
>--interval</option
>, <option
>--repeat</option
> ja <option
>--until</option
>.</entry
> </row
> <row
> <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>korrad</replaceable
></option
></entry
> <entry
>Määrab, mitu korda häire käivitatakse. Kui see peab käivituma lõputu arv kordi, siis määra -1. Selle argumendi kasutamine nõuab argumenti <option
>--interval</option
> ja välistab argumendi <option
>--until</option
>.</entry
> </row
> <row
> <entry
><option
>-s</option
>, <option
>--sound <replaceable
>URL</replaceable
></option
></entry
> <entry
>Määrab häire näitamisel mängitava helifaili nime või &URL;-i. Selle argumendi kasutamisel ei saa kasutada argumenti <option
>--beep</option
>.</entry
> </row
> <row
> <entry
><option
>-t</option
>, <option
>--time <replaceable
>kuupäev/aeg</replaceable
></option
></entry
> <entry
>Käivitab häire määratud kuupäeval või kuupäeval/ajal. Kuupäev ilma ajata määratakse vormingus <replaceable
>yyyy-mm-dd</replaceable
>, kuupäev ajaga vormingus <replaceable
>[[[yyyy-]mm-]dd-]hh:mm</replaceable
> (kui see ära jäetakse, määratakse kuupäev vaikimisi käesolevaks kuupäevaks).</entry
> </row
> <row
> <entry
><option
>-u</option
>, <option
>--until <replaceable
>kuupäev/aeg</replaceable
></option
></entry
> <entry
>Kordab häiret kuni määratud kupäeva või kuupäeva/ajani. Kuupäev ilma ajata määratakse samas vormingus nagu argumendi <option
>--time</option
> puhul. Selle argumendi kasutamine nõuab argumenti <option
>--interval</option
> ja välistab argumendi <option
>--repeat</option
>.</entry
> </row
> <row
> <entry
><replaceable
>message</replaceable
></entry
> <entry
>Näidatava teate tekst.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
>Määratud peab olema kas teate tekst, <option
>--file</option
> või <option
>--exec</option
>; kui ülal ei ole teisiti märgitud, on ülejäänud argumendid kõigest võimalikud, mitte kohustuslikud.</para>

<para
>Kaks alternatiivi, mis näitavad mitmerealist teadet punasel taustal käesoleva kuu 27. päeval kell 22.00:</para>

<informalexample
><screen>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>red</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Jäta nüüd töö\nKOHE POOLELI"</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>0xFF0000</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Jäta nüüd töö\nKOHE POOLELI"</replaceable
></option
></userinput>
</screen
> </informalexample>

</sect2>

<sect2>
<title
>Muud argumendid</title>

<para
>Järgmisi argumente saab kasutada <application
>häiredeemon</application
>i peatamiseks või lähtestamiseks ning &kalarm; esitusviisi juhtimiseks.</para>

<para
>Vaata osa <link linkend="daemon-reset"
>Häiredeemon</link
>, kus räägitakse lähemalt <application
>häiredeemon</application
>i lähtestamisest ja peatamisest.</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Argument</entry
> <entry
>Kirjeldus</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--reset</option
></entry
> <entry
>Lähtestab <application
>häiredeemon</application
>i.</entry
> </row
> <row
> <entry
><option
>--stop</option
></entry
> <entry
>Peatab <application
>häiredeemon</application
>i.</entry
> </row
> <row
> <entry
><option
>--tray</option
></entry
> <entry
>Näitab &kalarm;i ikoonina &kde; süsteemses salves.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
>Näide <application
>häiredeemon</application
>i lähtestamise kohta:</para>

<informalexample
><screen>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--reset</option
></userinput>
</screen
> </informalexample>

</sect2>

<sect2>
<title
>Abiargumendid</title>

<para
>Järgmised abiargumendid on kasutatavad kõigi &kde; rakenduste puhul:</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Argument</entry
> <entry
>Kirjeldus</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--help</option
></entry
> <entry
>Näitab lühidalt argumentide abiteksti.</entry
> </row
> <row
> <entry
><option
>--help-qt</option
></entry
> <entry
>Näitab &Qt; spetsiifilisi argumente.</entry
> </row
> <row
> <entry
><option
>--help-kde</option
></entry
> <entry
>Näitab &kde; spetsiifilisi argumente.</entry
> </row
> <row
> <entry
><option
>--help-all</option
></entry
> <entry
>Näitab kõiki argumente.</entry
> </row
> <row
> <entry
><option
>--author</option
></entry
> <entry
>Näitab &kalarm;i autorite nimesid ja e-posti aadresse.</entry
> </row
> <row
> <entry
><option
>-v</option
>, <option
>--version</option
></entry
> <entry
>Näitab &Qt; teegi, &kde; ja &kalarm;i töötavat versiooni.</entry
> </row
> <row
> <entry
><option
>--license</option
></entry
> <entry
>Näita infot litsentsi kohta.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

</sect2>
</sect1>

<sect1 id="daemon">
<title
>Häiredeemon</title>

<para
><application
>Häiredeemon</application
> &kalarmd; jälgib &kalarm;i kalendrifaili ja tuvastab eesseisvaid häireid. Kui häire tähtaeg kätte jõuab, annab ta &kalarm;ile korralduse seda näidata või käivitada või katkestada, kui tähtaeg on möödas ja antud alarmi puhul ei ole valitud võimalust käivitada teda ka hiljem esimesel võimalusel.</para>

<para
>&kde;3 korral saab <application
>häiredeemon</application
>it kasutada ka muudes rakendustes, sealhulgas KOrganizeris.</para>

<para
><application
>Häiredemon</application
> töötab taustal, sel puudub kasutajaliides. Seda saab juhtida järgmiselt.</para>

<sect2>
<title
><application
>Häiredeemon</application
>i käivitamine, lähtestamine ja peatamine</title>

<para
><application
>Häiredeemon</application
> käivitatakse tavaliselt &kde; seans sisselogimisel (kui just teenuste halduris ei ole automaatne käivitamine ära keelatud) ning see töötab kuni väljalogimiseni. Kui deemon mingil põhjusel ei tööta, ei jälgi ka miski häireid ning &kalarm; ei näita ega käivita häireid.</para>

<sect3>
<title
><application
>Häiredeemon</application
>i käivitamine</title>

<para
><application
>Häiredeemon</application
>i käivitamiseks võib kas käivitada &kalarm;i selle vaikimisi graafilises režiimis (&ie; ilma käsurea argumentideta), lubada häired &kalarm;i süsteemse salve ikooni menüst, lähtestada deemoni (seda kirjeldatakse <link linkend="daemon-reset"
>edaspidi</link
>), käivitada selle teenuste halduri dialoogis (vaata osa <link linkend="daemon-control"
>Häiredeemoni juhtimine teenuste halduri abil</link
>) või käivitada <application
>häiredeemon</application
>i otse käsurealt käsuga:</para>

<screen width="40">
<prompt
>%</prompt
> <userinput
><command
>kalarmd</command
></userinput>
</screen>

</sect3>

<sect3 id="daemon-reset">
<title
><application
>Häiredeemon</application
>i lähtestamine</title>

<para
><application
>Häiredeemon</application
> on võimalik ka lähtestada ilma seda peatamata. Lähtestamine sunnib <application
>häiredeemon</application
>i uuesti lugema ajastatud teadete nimekirja kalendrifailist ja taasinitsialiseerima oma &kalarm;iga seotud andmed.</para>

<para
>Aga miks peaks üldse olema vaja <application
>häiredeemon</application
> lähtestada? See ei ole küll väga tõenäoline, aga kui &kalarm; ei suuda mingil põhjusel tööle hakata, kui <application
>häiredeemon</application
> annab talle korralduse häire käivitada, siis seda häiret ei näidatagi ega käivitata, kuni <application
>häiredeemon</application
> pole lähtestatud või uuesti käivitatud. <application
>Häiredeemon</application
>i lähtestamine on selle peatamisele ja uuestikäivitamisele eelistatav variant, sest lähtestamine ei mõjuta muid rakendusi, mis samuti <application
>häiredeemon</application
>it kasutavad.</para>

<tip
><para
>Lähtestamine käivitab <application
>häiredeemon</application
>i arusaamaga, nagu poleks ta varem töötanud.</para
></tip>

<para
><application
>Häiredeemon</application
>i lähtestamiseks kasuta menüükäsku <menuchoice
><guimenu
>Tegevused</guimenu
><guimenuitem
>Uuenda häireid</guimenuitem
></menuchoice
> või anna järgmine käsk:</para>

<screen width="40">
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--reset</option
></userinput>
</screen>

</sect3>

<sect3>
<title
><application
>Häiredeemon</application
>i peatamine</title>

<para
><application
>Häiredeemon</application
>i peatamine katkestab ajastatud häireteadete jälgimise, kuni deemon ei ole uuesti käivitatud.</para>

<warning
><para
>Selle peatamine mõjutab ka kõiki muid rakendusi, mis kasutavad <application
>häiredeemon</application
>it, nii et selle asemel tasuks kaaluda pigem lähtestamist.</para
></warning>

<para
><application
>Häiredeemon</application
>i peatamiseks kasuta teenuste halduri dialoogi (vaata lähemalt osast <link linkend="daemon-control"
>Häiredeemoni juhtimine teenuste halduri abil</link
>) või anna järgmine käsk:</para>

<screen width="40">
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--stop</option
></userinput>
</screen>
</sect3>

</sect2>

<sect2 id="daemon-control">
<title
><application
>Häiredeemon</application
>i juhtimine teenuste halduri abil</title>

<para
>Teenuste halduri dialoog võimaldab <application
>häiredeemon</application
>it seadistada ja juhtida. Selle abil saab:</para>

<itemizedlist
> <listitem
> <para
>määrata, kas see käivitub automaatselt sisselogimisel.</para
> <warning
><para
>Kui ei <application
>häiredeemon</application
> ega &kalarm; ole seadistatud käivituma sisselogimisel, ei toimu häirete jälgimist ja &kalarm; ei näita ega käivita häireid.</para
></warning
> </listitem
> <listitem
> <para
>peatada ja käivitada <application
>häiredeemon</application
>i.</para
> <warning
><para
><application
>Häiredeemon</application
>i käivitamine või peatamine mõjutab ka kõiki muid rakendusi, mis kasutavad <application
>häiredeemon</application
>it.</para
></warning
> </listitem
> </itemizedlist>

<para
>Teenuste halduri dialoogi saab avada kas menüükäsuga <menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Häiredeemoni juhtimine...</guimenuitem
></menuchoice
> või &kde; juhtimiskeskusest.</para>

</sect2>
</sect1>
</chapter>

<chapter id="developers">
<title
>&kalarm;ist arendajatele</title>

<para
>&kalarm; pakub välja liidese, mis võimaldab muudel rakendustel esitada soov järgmiste funktsioonide kasutamiseks:</para>

<itemizedlist
> <listitem
><para
>uue häire ajastamine</para
></listitem
> <listitem
><para
>käivitada või katkestada juba ajastatud häire</para
></listitem
> <listitem
><para
>katkestada juba ajastatud häire</para
></listitem
> <listitem
><para
>käivitada juba ajastatud häire</para
></listitem
> </itemizedlist>

<para
>Kõiki mainitud funktsioone saab teostada nii &DCOP; väljakutse kui käsurea vahendusel. &DCOP; väljakutsed on eelistatud, kui &kalarm; juba töötab.</para>

<sect1 id="dcop-interface">
<title
>&DCOP; liides</title>

<refentry id="cancelEvent">
<refmeta>
<refentrytitle
>cancelEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelEvent</refname>
<refpurpose
>cancel an already scheduled alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
void cancelEvent(const QString&amp; <replaceable
>calendarFile</replaceable
>, const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameetrid</title>
<variablelist
> <varlistentry
> <term
><parameter
>calendarFile</parameter
></term
> <listitem
> <para
>Määrab katkestatavat sündmust sisaldava kalendrifaili &URL;-i.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>eventID</parameter
></term
> <listitem
> <para
>Määrab katkestatava sündmuse unikaalse ID, nagu see on salvestatud <replaceable
>calendarFile</replaceable
>'is.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Kirjeldus</title>

<para
><function
>cancelEvent()</function
> on &DCOP; väljakutse määratud häire katkestamiseks. &kalarm; kustutab häire kalendrifailist ilma seda näitamata või käivitamata.</para>

<note
><para
>Parameetrit <replaceable
>calendarFile</replaceable
> kasutatakse vaid ühtlusekontrolliks: kui &URL; ei määra &kalarm;i käesolevat vaikekalendrifaili, soovi ignoneeritakse.</para
></note>

<note
><para
>Sama funktsiooni endist nime <function
>cancelMessage</function
> säilitatakse ühilduvuse huvides, kuid kõik uued rakendused peaksid kasutama funktsiooni <function
>cancelEvent</function
>.</para
></note>

</refsect1>
</refentry>

<refentry id="triggerEvent">
<refmeta>
<refentrytitle
>triggerEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>triggerEvent</refname>
<refpurpose
>trigger an already scheduled alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
void triggerEvent(const QString&amp; <replaceable
>calendarFile</replaceable
>, const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameetrid</title>
<variablelist
> <varlistentry
> <term
><parameter
>calendarFile</parameter
></term
> <listitem
> <para
>Määrab käivitatavat sündmust sisaldava kalendrifaili &URL;-i.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>eventID</parameter
></term
> <listitem
> <para
>Määrab käivitatava sündmuse unikaalse ID, nagu see on salvestatud <replaceable
>calendarFile</replaceable
>'is.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Kirjeldus</title>

<para
><function
>triggerEvent()</function
> on &DCOP; väljakutse määratud häire koheseks näitamiseks või käivitamiseks (sõltumata ajast, mis selle käivitamiseks on määratud). &kalarm; hangib häire kalendrifailist ja seejärel näitab seda või käivitab selle.</para>

<para
>Kui häire tähtaeg on nagunii kätte jõudnud, kustutab &kalarm; seejärel kõik häire senised kordused ja kui kordusi ei ole rohkem järele jäänud, siis ka häire kalendrifailist. Kui häire tähtaeg ei ole veel saabunud, jäävad kõik ajastatud korrad muutmata.</para>

<note
><para
>Parameetrit <replaceable
>calendarFile</replaceable
> kasutatakse vaid ühtlusekontrolliks: kui &URL; ei määra &kalarm;i käesolevat vaikekalendrifaili, soovi ignoneeritakse.</para
></note>

<note
><para
>Funktsiooni vana nimi <function
>displayMessage</function
> on säilitatud ühilduvuse huvides, kuid kõik uued rakendused peaksid kasutama funktsiooni <function
>triggerEvent</function
>.</para
></note>

</refsect1>
</refentry>

<refentry id="handleEvent">
<refmeta>
<refentrytitle
>handleEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>handleEvent</refname>
<refpurpose
>trigger or cancel an already scheduled alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
void handleEvent(const QString&amp; <replaceable
>calendarFile</replaceable
>, const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameetrid</title>
<variablelist
> <varlistentry
> <term
><parameter
>calendarFile</parameter
></term
> <listitem
> <para
>Määrab näidatavat/käivitatavat või katkestatavat sündmust sisaldava kalendrifaili &URL;-i.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>eventID</parameter
></term
> <listitem
> <para
>Määrab näidatava/käivitatava või katkestatava sündmuse unikaalse ID, nagu see on salvestatud <replaceable
>calendarFile</replaceable
>'is.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Kirjeldus</title>

<para
><function
>handleEvent()</function
> on &DCOP; väljakutse määratud häire näitamiseks/käivitamiseks või katkestamiseks. &kalarm; hangib häire kalendrifailist ning määrab seejärel, mida ette võtta vastavalt sellele, millal on häire tähtaeg.</para>

<itemizedlist
> <listitem
><para
>Kui häire täheaeg ei ole veel käes, ei juhtu midagi.</para
> </listitem
> <listitem
><para
>Kui häire tähtaeg on käes, tegutsetakse järgmiselt: kui on määratud viimase korduse lipp ja häire viimane kordus on möödas, &ie; kui ajastatud käivitusaeg oli enam kui minuti eest, ei näita ega käivita &kalarm; häiret. Vastasel juhul &kalarm; näitab või käivitab häire. Kui häirel on veel määratud kordusi, kustutab &kalarm; seejäre häire kalendrifailist.</para
> </listitem
> </itemizedlist>

<note
><para
>Parameetrit <replaceable
>calendarFile</replaceable
> kasutatakse vaid ühtlusekontrolliks: kui &URL; ei määra &kalarm;i käesolevat vaikekalendrifaili, soovi ignoneeritakse.</para
></note>

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>schedule a new alarm message.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
bool scheduleMessage(const QString&amp; <replaceable
>message</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>)
</synopsis>
<synopsis>
bool scheduleMessage(const QString&amp; <replaceable
>message</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, int <replaceable
>repeatCount</replaceable
>)
</synopsis>
<synopsis>
bool scheduleMessage(const QString&amp; <replaceable
>message</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, const QDateTime&amp; <replaceable
>endTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameetrid</title>
<variablelist
> <varlistentry
> <term
><parameter
>message</parameter
></term
> <listitem
> <para
>Määrab ajastatava teate teksti.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>dateTime</parameter
></term
> <listitem
> <para
>Määrab kuupäeva ja aja, millal teadet tuleks näidata.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>bg</parameter
></term
> <listitem
> <para
>Määrab näidatava teate tausta värvi.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>flags</parameter
></term
> <listitem
> <para
>Määrab soovitud häireteate lippude loogilise funktsiooni OR. Lipubitid on määratud failis <filename
>msgevent.h</filename
> klassiga KAlarmEvent</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>audioURL</parameter
></term
> <listitem
> <para
>Määrab teate näitamisel mängitava helifaili nime või &URL;-i.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>simpleRepeatType</parameter
></term
> <listitem
> <para
>Määrab häire kordumise tüübi. Võimalikud väärtused on MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. Need on määratud failis <filename
>msgeven.h</filename
> klassiga KAlarmEvent.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>interval</parameter
></term
> <listitem
> <para
>Määrab teate korduste vahelise perioodi (minutid/päevad/nädalad/kuud/aastad).</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>repeatCount</parameter
></term
> <listitem
> <para
>Määrab, mitu korda tuleb häireteadet korrata. -1 tähendab lõputut kordamist.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Kirjeldus</title>
<para
><function
>scheduleMessage()</function
> on &DCOP; väljakutse määratud häireteate ajastamiseks määratud kuupäevale ja ajale. Sel on kolm vormi: mittekorduva häire, kindla korduste arvuga korduva häire ja lõppemisajaga korduva häire vorm.</para>

<para
>Kui määratud aeg (sealhulgas ka korduste aeg) on juba möödas, näitab &kalarm; teadet otsekohe või juhul, kui määratud on lipp LATE_CANCEL, ignoreerib soovi. Kui tähtaeg (või korduse tähtaeg) seisab veel ees, lisab &kalarm; häireteate kalendrifaili, et seda hiljem näidata.</para>

<para
>Kasuta järgnevaga sarnanevat koodi parameetriandmete määramiseks funktsiooni <function
>scheduleMessage</function
> &DCOP; väljakutsele mittekorduva häire jaoks:</para>

<screen>
QString message, audioFile;
QDateTime dateTime;
QColor bgColour;
Q_UINT32 flags;
. . .
QByteArray data;
QDataStream arg(data, IO_WriteOnly);
arg &lt;&lt; message;
arg.writeRawBytes((char*)&amp;dateTime, sizeof(QDateTime));
arg.writeRawBytes((char*)&amp;bgColour, sizeof(QColor));
arg &lt;&lt; flags &lt;&lt; audioFile;
</screen>

<para
>Kasuta järgnevaga sarnanevat koodi parameetriandmete määramiseks funktsiooni <function
>scheduleMessage</function
> &DCOP; väljakutsele korduva häire jaoks:</para>

<screen>
QString message, audioFile;
QDateTime dateTime;
QColor bgColour;
Q_UINT32 flags;
Q_INT32 repeatType, repeatCount, repeatInterval;
. . .
QByteArray data;
QDataStream arg(data, IO_WriteOnly);
arg &lt;&lt; message;
arg.writeRawBytes((char*)&amp;dateTime, sizeof(QDateTime));
arg.writeRawBytes((char*)&amp;bgColour, sizeof(QColor));
arg &lt;&lt; flags &lt;&lt; audioFile &lt;&lt; repeatType &lt;&lt; repeatCount &lt;&lt; repeatInterval;
</screen>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>schedule a new alarm which displays the contents of a
text file.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>)
</synopsis>
<synopsis>
bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, int <replaceable
>repeatCount</replaceable
>)
</synopsis>
<synopsis>
bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, const QDateTime&amp; <replaceable
>endTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameetrid</title>
<variablelist
> <varlistentry
> <term
><parameter
>URL</parameter
></term
> <listitem
> <para
>Määrab tekstifaili nime või &URL;-i, mille sisu näidatakse ajastatavas häireteates.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>dateTime</parameter
></term
> <listitem
> <para
>Määrab kuupäeva ja aja, millal faili näidata.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>bg</parameter
></term
> <listitem
> <para
>Määrab faili näitamise tausta värvi.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>flags</parameter
></term
> <listitem
> <para
>Määrab soovitud häirelippude loogilise funktsiooni OR. Lipubitid on määratud failis <filename
>msgevent.h</filename
> klassiga KAlarmEvent</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>audioURL</parameter
></term
> <listitem
> <para
>Määrab teate näitamisel mängitava helifaili nime või &URL;-i.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>simpleRepeatType</parameter
></term
> <listitem
> <para
>Määrab häire kordumise tüübi. Võimalikud väärtused on MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. Need on määratud failis <filename
>msgeven.h</filename
> klassiga KAlarmEvent.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>interval</parameter
></term
> <listitem
> <para
>Määrab häire korduste vaheliste perioodide (minutid/päevad/nädalad/kuud/aastad) hulga.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>repeatCount</parameter
></term
> <listitem
> <para
>Määrab, mitu korda faili näidata. -1 määrab häire lõputult korduma.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Kirjeldus</title>
<para
><function
>scheduleFile()</function
> on &DCOP; väljakutse määratud tekstifaili näitamise ajastamiseks määratud kuupäevale ja ajale. Kui kõrvale jätta faili nime või &URL;-i määramine, on selle kasutamine samasugune funktsiooniga <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
>, mille juurest tasubki otsida ka selle funktsiooni täpsemat kirjeldust.</para>
</refsect1>
</refentry>


<refentry id="scheduleCommand">
<refmeta>
<refentrytitle
>scheduleCommand</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleCommand</refname>
<refpurpose
>schedule a new alarm which executes a shell
command.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
bool scheduleCommand(const QString&amp; <replaceable
>commandLine</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, int <replaceable
>flags</replaceable
>)
</synopsis>
<synopsis>
bool scheduleCommand(const QString&amp; <replaceable
>commandLine</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, int <replaceable
>flags</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, int <replaceable
>repeatCount</replaceable
>)
</synopsis>
<synopsis>
bool scheduleCommand(const QString&amp; <replaceable
>commandLine</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, int <replaceable
>flags</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, const QDateTime&amp; <replaceable
>endTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameetrid</title>
<variablelist
> <varlistentry
> <term
><parameter
>commandLine</parameter
></term
> <listitem
> <para
>Määrab shellikäsu, mille käivitamine antud funktsiooniga ajastatakse.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>dateTime</parameter
></term
> <listitem
> <para
>Määrab kuupäeva ja aja, millal käsku käivitada.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>flags</parameter
></term
> <listitem
> <para
>Määrab soovitud häirelippude loogilise funktsiooni OR. Lipubitid on määratud failis <filename
>msgevent.h</filename
> klassiga KAlarmEvent, ainult lipubitti BEEP ignoreeritakse.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>simpleRepeatType</parameter
></term
> <listitem
> <para
>Määrab häire kordumise tüübi. Võimalikud väärtused on MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. Need on määratud failis <filename
>msgeven.h</filename
> klassiga KAlarmEvent.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>interval</parameter
></term
> <listitem
> <para
>Määrab häire korduste vaheliste perioodide (minutid/päevad/nädalad/kuud/aastad) hulga.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>repeatCount</parameter
></term
> <listitem
> <para
>Määrab, mitu korda häiret korrata. -1 tähendab häire lõputut kordamist.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Kirjeldus</title>
<para
><function
>scheduleCommand()</function
> on &DCOP; väljakutse määratud shellikäsu käivitamise ajastamiseks määratud kuupäevale ja ajale. Kui kõrvale jätta ühelt poolt käsurea käsu määramine ning teiselt poolt teate värvi ja helifaili parameetrite määramine, on selle kasutamine samasugune funktsiooniga <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
>, mille juurest tasuks vaadata ka selle funktsiooni täpsemat kirjeldust.</para>
</refsect1>
</refentry>
</sect1>

<sect1 id="cmdline-interface">
<title
>Käsurealiides</title>

<para
>Käsurea argumente pakutakse võimaldavaks muudel rakendustel (näiteks <application
>häiredeemon</application
>) käivitada &kalarm;i, kui see juba ei tööta, ajastatud häirete käivitamiseks või katkestamiseks või uute häirete ajastamiseks. Põhjus, miks selleks kasutatakse käsurea argumente, peitub selles, et kui &kalarm; käivitada ilma käsurea parameetriteta ja seejärel esitada talle &DCOP; väljakutse, käivitud see vaikimisi graafilises režiimis, mis rakendustevaheliste väljakutsete puhul ei ole kindlasti soovitav.</para>

<note
><para
>Rakendused peaksid esmalt kontrollima, kas &kalarm; juba töötab. Kui jah, siis tuleks vastavate toimingute soovid esitada &DCOP; väljakutsetena.</para
></note>

<para
>Käsurea argumente uue häire ajastamiseks on kirjeldatud osas <link linkend="cmdline-operation"
>&kalarm;i kasutamine</link
>. Argumendid ajastatud häirete käivitamiseks ja peatamiseks on järgmised:</para>

<note
><para
>Ka tavalised kasutajad võivad soovi korral siintoodud käsurea argumente kasutada (eeldusel mõistagi, et nad määravad argumendile vajaliku info).</para
></note>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Argument</entry
> <entry
>Kirjeldus</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--calendarURL <replaceable
>url</replaceable
></option
></entry
> <entry
>Määratud &URL;-iga kalendrifaili kasutamine. See argument on kasutusel ainult ühtlusekontrolliks: kui &URL; ei määra &kalarm;i käesolevat vaikekalendrifaili, soovi ignoreeritakse.</entry
> </row
> <row
> <entry
><option
>--cancelEvent <replaceable
>eventID</replaceable
></option
></entry
> <entry
>Katkestab määratud sündmuse ID-ga sündmuse.</entry
> </row
> <row
> <entry
><option
>--triggerEvent <replaceable
>eventID</replaceable
></option
></entry
> <entry
>Käivitab määratud sündmuse ID-ga sündmuse. Sooritatav toiming on samasugune, nagu &DCOP; väljakutse <link linkend="triggerEvent"
>triggerEvent()</link
>.</entry
> </row
> <row
> <entry
><option
>--handleEvent <replaceable
>eventID</replaceable
></option
></entry
> <entry
>Käivitab või katkestab määratud sündmuse ID-ga sündmuse. &kalarm; määrab vajaliku tegevuse samamoodi, nagu &DCOP; väljakutse <link linkend="handleEvent"
>handleEvent()</link
> korral.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
><option
>--cancelEvent</option
>, <option
>--triggerEvent</option
> ja<option
>--handleEvent</option
> on vastastikku välistavad. <option
>--calendarURL</option
> ei ole kohustuslik, kuid seda saab kasutada vaid koos ühe eelnevalt mainituga.</para>

<para
>Näited:</para>

<informalexample
><screen>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--triggerEvent <replaceable
>&kalarm;-387486299.702</replaceable
></option
> <option
>--calendarURL <replaceable
>file:/home/zaphod/hydra.ics</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--cancelEvent <replaceable
>&kalarm;-388886299.793</replaceable
></option
></userinput>
</screen
> </informalexample>

</sect1>
</chapter>


<chapter id="faq">
<title
>Küsimused ja vastused</title>

&reporting.bugs;
&updating.documentation;

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Millist seadistustefaili kasutab &kalarm;?</para>
</question>
<answer>
<para
>&kalarm;i seadistused on failis <filename
>$KDEHOME/share/config/kalarmrc</filename
>.</para>

<para
>Ajastatud häireid sisaldav kalendrifail on <filename
>$KDEHOME/share/apps/kalarm/calendar.ics</filename
>, kui seadistustefailis ei ole just määratud mõnda muud kalendrifaili.</para>

<note
><para
>Kalendrifaili muutmisel seadistustefailis tuleks redigeerida ka <application
>häiredeemon</application
>i <filename
>clients</filename
> seadistustefaili ja eemaldada sealt vana kalendrifaili viide. Redigeerimise ajal ei tohiks <application
>häiredeemon</application
> töötada, muidu võib see muudatuse üle kirjutada.</para
></note>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Millist seadistustefaili kasutab <application
>häiredeemon</application
>?</para>
</question>
<answer>
<para
><application
>Häiredeemon</application
>i seadistused on failis <filename
>$KDEHOME/share/config/kalarmdrc</filename
>.</para>

<para
>Failis <filename
>$KDEHOME/share/apps/kalarmd/clients</filename
> on andmed klientrakenduste kohta, mille <application
>häiredeemon</application
> on juba registreerinud, ning nende kalendrifailid.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Milline on &kalarm;i ja <application
>häiredeemon</application
>i rakenduse nimi?</para>
</question>
<answer>
<para
>&kalarm;i rakenduse nimi on <application
>kalarm</application
> ja <application
>häiredeemon</application
>i rakenduse nimi on <application
>kalarmd</application
>. Lisaks on &kde; varasemates versioonides (enne 3.1) väike rakendus <application
>kalarmautostart</application
>, mille funktsioon on käivitada &kalarm;i süsteemse salve ikoon sisselogimisel.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Autorid ja litsents</title>

<para
> &kalarm; </para>
<para
> Rakenduse autoriõigus 2001, 2002: David Jarvie <email
>software@astrojar.org.uk</email
> </para>
<para
> Häiredeemoni autorid: <itemizedlist
> <listitem
><para
>Preston Brown <email
>pbrown@kde.org</email
></para
> </listitem
> <listitem
><para
>David Jarvie <email
>software@astrojar.org.uk</email
></para
> </listitem
> <listitem
><para
>Cornelius Schumacher <email
>schumacher@kde.org</email
></para
> </listitem
> </itemizedlist
> </para>

<para
> Dokumentatsiooni autoriõigus 2001, 2002: David Jarvie <email
>software@astrojar.org.uk</email
> </para>

<para
>Tõlge eesti keelde Marek Laane <email
>bald@online.ee</email
></para>

<para
>Tänusõnad kuuluvad ka &kde;1 rakenduse KAlarm autorile Stefan Nikolausele <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, kes lahkelt lubas nimetust &kalarm; kasutada ka käesoleva &kde;2/&kde;3 rakenduse puhul. </para>

&underFDL;               <!-- FDL: do not remove -->

&underGPL;        	 <!-- GPL License -->

</chapter>

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

<sect1 id="getting-kalarm">
<title
>&kalarm;i hankimine</title>

&install.intro.documentation;

<para
>&kalarm; on saadaval  &kde;2 jaoks ja autonoomse paketina &kde;3 jaoks veebiaadressil <ulink url="http://www.astrojar.org.uk/linux"
>http://www.astrojar.org.uk/linux</ulink
> </para>

</sect1>

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

<para
>&kalarm; nõuab &kde; standardsete teekide olemasolu (pakett <filename
>kdelibs</filename
>). Lähtekoodi kompileerimiseks on vajalikud ka &Qt; ja <filename
>kdelibs</filename
> areduspaketid.</para>

<para
>&kalarm; kasutab töötamiseks umbes 12 Mb ja <application
>häiredeemon</application
> umbes 2,5 Mb mälu, kuid see võib erineda vastavalt platvormile ja seadistusele.</para>

<para
>Muudatustega saab tutvuda failis <filename
>ChangeLog</filename
> või veebiaadressil <ulink url="http://www.astrojar.org.uk/linux/kalarm.html"
>http://www.astrojar.org.uk/linux/kalarm.html</ulink
>.</para>
</sect1>

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

<para
>Kui sul ei õnnestu hankida sobivat eelkompileeritud binaarpaketti, tuleb &kalarm; käsitsi lähtekoodist kompileerida. Hangi selleks fail <filename
>kdepim-x.x.tar.bz2</filename
> või <filename
>kalarm-x.x.tar.bz2</filename
> (või midagi sarnast) vastavalt sellele, kas soovid paigaldada kogu &package; või ainult &kalarm;i. Paki seel lahti uude kataloogi käsuga <userinput
><command
>tar</command
> <option
>xvfj <replaceable
>pakett.tar.bz2</replaceable
></option
></userinput
> (või sarnasega) ning liigu kataloogi, kuhu paketi lahti pakkisid.</para>

&install.compile.documentation;

<note
><para
>Kui sul on paigaldatud enam kui üks &kde; versioon (nt. &kde;2 ja &kde;3), võib juhtuda, et paigaldad &kalarm;i valesse &kde; kataloogi. Vajaduse korral võid &kde; kataloogi määrata argumendina käsule <userinput
><command
>./configure</command
></userinput
>. Kui näiteks &kde; on paigaldatud kataloogi <filename
>/opt/kde2</filename
>, siis:</para
> <para
><userinput
><command
>./configure</command
> --prefix=<replaceable
>/opt/kde2</replaceable
></userinput
></para
> </note>
</sect1>

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

<para
>&kalarm;i töötamiseks &kde; töölaual ei ole vaja midagi spetsiaalselt seadistada. Kui oled &kalarm;i esimest korda käivitanud, käivitub <application
>häiredeemon</application
> edaspidi igal sisselogimisel ja hakkab jälgima ajastatud häireid.</para>

<para
>&kalarm;i kasutamiseks mõnel muul töölaual kui &kde; tuleb ennekõike tagada, et <application
>häiredeemon</application
> käivituks sisselogimisel automaatselt. Täpsemad juhised leiab failist <filename
>INSTALL</filename
>, mis on &kalarm;iga kaasa pandud.</para>

</sect1>

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->

