<?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>

<othercredit role="developer"
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
><address
><email
>software@astrojar.org.uk</email
></address
></affiliation>
<contrib
>Arendaja</contrib>
</othercredit>

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

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

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>2004-06-24</date>
<releaseinfo
>1.01.00</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. Lisavõimalusena võib lasta näidata ka varasemaid häireid.</para>

<para
>Häiret luues või muutes on võimalik kirjutada häire teate tekst, valida teksti- või pildifail, mida sel puhul näidatakse, tegevus, mis käivitatakse või e-posti aadress. kuhu vastav kiri saadetakse. 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 või kirja saatma, 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>

<para
>Käivitatuna ilma käsurea argumentideta alustab &kalarm; tööd graafilisena ning näitab parajasti kehtivat häirete nimekirja.</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>

<tip
><para
>Kõigil &kalarm;i kerimiskastidel on olemas kiirendusvõimalus: kui soovid, et kasti väärtus muutuks suurema sammu võrra, hoia kerimisnooltele klõpsates all klahvi <keycap
>Shift</keycap
>.</para>

<mediaobject>
<imageobject>
<imagedata fileref="spinbox.png" format="PNG"/>
</imageobject>
</mediaobject>
</tip>

<sect1 id="alarm-list">
<title
>Häirete nimekiri</title>

<para
>&kalarm;i peaaken näitab eesseisvaid häireid koos käivitamise ajaga, kordamise intervalli, värvide ning näidatava teksti, tekstifaili nime, käivitatava käsu või kirja saaja e-posti aadressiga. (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 alarmi korral näidatakse nimekirjas järgmise käivitamise aega ning kordumise intervalli (&eg; <quote
>1 päev</quote
> igapäevaselt, <quote
>3 nädalat</quote
> iga kolmanda nädala esmas- ja kolmapäeval käivitatava häire või <quote
>sisselogimisel</quote
> alati sisselogimise ajal käivitatava häire korral).</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
>Näidata võib lasta ka iga häireni jäänud aega nii koos häire ajaga või ka ilma selleta. Häire ajaveeru näitamiseks või peitmiseks vali menüükäsk <menuchoice
><guimenu
>Vaade</guimenu
><guimenuitem
>Näita häirete aegu</guimenuitem
></menuchoice
>. Häireni jäänud aja näitamiseks/peitmiseks vali menüükäsk <menuchoice
><guimenu
>Vaade</guimenu
><guimenuitem
>Näita häireteni jäänud aega</guimenuitem
></menuchoice
>. Üht neist veergudest näidatakse alati.</para>

<para
>Varasemate häirete nägemiseks nimekirjas vali menüükäsk <menuchoice
> <guimenu
>Vaade</guimenu
><guimenuitem
>Näita aegunud häireid</guimenuitem
></menuchoice
>. Nende varjamiseks korda seda tegevust.</para>

</sect1>

<sect1 id="create-edit">
<title
>Häire loomine ja muutmine</title>

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

<para
>Uue häire loomiseks talita ühel järgnevatest viisidest. See avab <link linkend="alarm-edit-dialog"
>häire redigeerimise dialoogi</link
>, mis võimaldab häiret seadistada.</para>

<itemizedlist>
<listitem>
<para
>Vali menüükäsk <menuchoice
><guimenu
>Toimingud</guimenu
> <guimenuitem
>Uus</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Klõpsa hiire <mousebutton
>parema</mousebutton
> nupuga süsteemse salve ikoonil ja vali ilmuvast menüüst <menuchoice
><guimenuitem
>Uus</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Klõpsa hiire <mousebutton
>parema</mousebutton
> nupuga süsteemse salve ikoonil.</para>
</listitem>

<listitem>
<para
>Klõpsa hiire <mousebutton
>parema</mousebutton
> nupuga häire nimel nimekirjas ja vali ilmuvast menüüst <menuchoice
><guimenuitem
>Uus</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Tee topeltklõps tühjal ruumil häirete nimekirja viimase kirje järel.</para>
</listitem>
</itemizedlist>

<para
>Uusi häireid võib luua ka mitmesuguste allikate põhjal, mis annavad vähemalt osa parameetreid juba ette:</para>

<itemizedlist>
<listitem>
<para
>uue häire loomiseks häiremalli põhjal ava häire redigeerimise dialoog, nagu eespool kirjeldatud, ning klõpsa nupule <guibutton
>Lae mall</guibutton
>. Vali ilmuvast loendist mall ja klõpsa nupule <guibutton
>OK</guibutton
>. Seejärel täidetakse häire redigeerimise dialoog valitud häiremalli parameetritega, mida võid vastavalt soovile ja vajadusele muuta.</para>
</listitem>

<listitem>
<para
>Uue häire lisamiseks varasema häire põhjal märgi soovitud häire nimekirjas ja vali menüükäsk <menuchoice
> <guimenu
>Toimingud</guimenu
><guimenuitem
>Kopeeri</guimenuitem
></menuchoice
>. See avab häire redigeerimise dialoogi, kus on juba ees valitud häire parameetrid.</para>
</listitem>

<listitem>
<para
>Uue häire loomiseks, mis näitaks olemasolevat e-kirja, lohista vastav kiri &kmail;ist &kalarm;i peaaknasse või süsteemse salve ikoonile. See avab häire redigeerimise dialoogi, kus kogu kirja, kaasa arvatud saatja, saaja jne., näidatakse häire tekstina.</para>
</listitem>

<listitem>
<para
>Mis tahes teksti lohistamine &kalarm;i peaaknasse või süsteemse salve ikoonile avab häire redigeerimise dialoogi ja asetab lohistatud teksti sinna häire tekstina.</para>
</listitem>

<listitem>
<para
>Faili näitava häire loomiseks lohista faili URL &kalarm;i peaaknasse või süsteemse salve ikoonile. See avab häire redigeerimise dialoogi, kus faili nimi on juba ette määratud.</para>
</listitem>

<listitem>
<para
>Võimalik on automaatselt luua sünnipäevahäireid inimeste kohta, kes esinevad sinu &kaddressbook;us. Seda kirjeldab lähemalt osa <link linkend="birthdays"
>Sünnipäevade importimine &kaddressbook;ust</link
>.</para>
</listitem>

</itemizedlist>

</sect2>

<sect2 id="edit-alarm">
<title
>Olemasoleva häire muutmine</title>

<para
>Olemasoleva häire muutmiseks (midagi muuta ei saa vaid aegunud häirete juures) võta ette mõni järgnev samm:</para>

<itemizedlist>
<listitem>
<para
>Tee topeltklõps selle nimel häirete nimekirjas.</para>
</listitem>

<listitem>
<para
>Vali see klõpsuga häirete nimekirjas ja kasuta seejärel menüükäsku <menuchoice
><guimenu
>Toimingud</guimenu
><guimenuitem
>Muuda</guimenuitem
></menuchoice
></para>
</listitem>

<listitem>
<para
>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 <link linkend="alarm-edit-dialog"
>häire redigeerimise dialoog</link
>.</para>

</sect2>

<sect2>
<title
>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
>Toimingud</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 vaatamine</title>

<para
>Olemasoleva häire vaatamiseks ilma võimaluseta seda muuta:</para>

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

<para
>See näitab häire redigeerimise dialoogi ainult loetavana.</para>

</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 id="templates">
<title
>Häiremallid</title>

<para
>Kui sul on sageli vaja ühesuguseid häireid käivitada, võid luua häiremalli, et mitte sisestada alati aina uuesti samu üksikasju. Mall võib sisaldada kõiki häires esinevaid detaile, välja arvatud muidugi algushetk.</para>

<para
>Näiteks soovid määrata häire meelde tuletama telesaadet, mille aeg nädalast nädalasse muutub. Mall sisaldab kõiki häire üksikasju (teate tekst, kas mängida heli või mitte jne.), välja arvatud kuupäev ja kellaaeg. Siis on sul häire loomiseks vaja ainult häire redigeerimise dialoogis laadida vajalik mall ning sisestada kuupäev ja kellaaeg.</para>

<sect3>
<title
>Mallide seadistamine</title>

<para
>Malle saab luua, muuta või kustutada häiremallide dialoogis, samuti võib luua uue häiremalli olemasoleva malli baasil.</para>

<para
>Uue häiremalli loomiseks:</para>

<itemizedlist>
<listitem>
<para
>Ava häiremallide dialoog menüükäsuga <menuchoice
> <guimenu
>Fail</guimenu
><guimenuitem
>Mallid...</guimenuitem
></menuchoice
> ning klõpsa nupule <guibutton
>Uus</guibutton
>. See avab tühja malli redigeerimise dialoogi.</para>
</listitem>

<listitem>
<para
>Ava häiremallide dialoog menüükäsuga <menuchoice
> <guimenu
>Fail</guimenu
><guimenuitem
>Mallid...</guimenuitem
></menuchoice
>, vali loendist olemasolev mall ja klõpsa nupul <guibutton
>Kopeeri</guibutton
>. See avab malli redigeerimise dialoogi, kus on juba ees valitud häire parameetrid.</para>
</listitem>

<listitem>
<para
>Vali soovitud häire soovitud häire nimekirjas ja seejärel menüükäsk <menuchoice
> <guimenu
>Toimingud</guimenu
><guimenuitem
>Loo mall</guimenuitem
></menuchoice
>. See avab malli redigeerimise dialoogi, kus on juba ees valitud häire parameetrid.</para>
</listitem>
</itemizedlist>

<para
>Olemasoleva malli muutmiseks ava häiremallide dialoog menüükäsuga <menuchoice
> <guimenu
>Fail</guimenu
><guimenuitem
>Mallid...</guimenuitem
></menuchoice
> ja klõpsa nupule <guibutton
>Muuda</guibutton
>. See avab allpool kirjeldatava malli redigeerimise dialoog.</para>

<para
>Olemasoleva malli kustutamiseks ava häiremallide dialoog menüükäsuga <menuchoice
> <guimenu
>Fail</guimenu
><guimenuitem
>Mallid...</guimenuitem
></menuchoice
>, vali üks või enam mall ja klõpsa nupule <guibutton
>Kustuta</guibutton
>. Selle peale küsitakse sinu käest kinnitust, et vältida juhuslikku kustutamist.</para>

</sect3>

<sect3>
<title
>Malli redigeerimise dialoog</title>

<para
>Malli redigeerimise dialoog on sarnane <link linkend="alarm-edit-dialog"
>häire redigeerimise dialoogiga</link
>. Erinevad on järgmised võimalused:</para>

<itemizedlist>
<listitem>
<para
>Sisesta malli nimi väljale <guilabel
>Malli nimi</guilabel
>. See on nimi, mida näidatakse malli valimise loendis, seepärast on mõttekas anda nimi, mille põhjal saaksid ka ise aru, milleks see on mõeldud. Mallil peab olema unikaalne nimi.</para>
</listitem>

<listitem>
<para
>Sektsioonis <guilabel
>Aeg</guilabel
> saab valida:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Vaikeaeg</guilabel
>, kui sa ei soovi määrata konkreetset käivitamise aega. Sellele mallile tuginevad häired kasutavad sellisel juhul tavalist uute häirete käivitamise vaikeaega.</para>
</listitem>

<listitem>
<para
><guilabel
>Aeg</guilabel
> võimaldab sisestada häire käivitamise aja.</para>
</listitem>

<listitem>
<para
><guilabel
>Suvaline aeg</guilabel
> võimaldab määrata häire käivitumise aja ainult kuupäeva, mitte kellaajaga.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Kaardi <guilabel
>Kordumine</guilabel
> sektsioonis <guilabel
>Kordamise reegel</guilabel
> ei ole vaja määrata kuupäeva ega kuud vastavalt iganädalaste või igakuiste häirete jaoks.</para>
</listitem>
</itemizedlist>

</sect3>

</sect2>

<sect2 id="birthdays">
<title
>Sünnipäevade importimine &kaddressbook;ust</title>

<para
>Sünnipäevade nägemiseks, mis leiduvad &kaddressbook;us, vali menüükäsk <menuchoice
><guimenu
>Fail</guimenu
> <guimenuitem
>Impordi sünnipäevad...</guimenuitem
></menuchoice
>. See avab dialoogi, kus saab valida, millistele sünnipäevadele häire luua.</para>

<itemizedlist>
<listitem>
<para
>Sektsioonis <guilabel
>Häire tekst</guilabel
> saab anda teksti, mida näidatakse sünnipäevade häireteadetes. Selle saab luua kujul <guilabel
>prefiks</guilabel
> pluss isiku nimi pluss <guilabel
>sufiks</guilabel
>. Tühikuid automaatselt ei lisata, nii et väljal <guilabel
>Prefiks</guilabel
> tuleb sul endal anda vajalikud lõpetavad tühikud ning väljal <guilabel
>Sufiks</guilabel
> vajalikud alustavad tühikud.</para>

<note
><para
>Häire teksti muutes vaatab rakendus sünnipäevade nimekirja uuesti üle.</para
></note>
</listitem>

<listitem>
<para
>Nimekirjas <guilabel
>Sünnipäevade valimine</guilabel
> vali kõik need sünnipäevad, millele soovid häiret luua. Pane tähele, et nimekirjas näidatakse ainult neid &kaddressbook;u kirjeid, mis sisaldavad sünnipäeva ja millele ei ole juba määratud häiret parajasti sektsioonis <guilabel
>Häire tekst</guilabel
> määratud vormis.</para>
</listitem>

<listitem>
<para
>Ülejäänud valikud on sarnased häirete <guilabel
>tekst</guilabel
>i võimalustega <link linkend="alarm-edit-dialog"
>häirete redigeerimise dialoogis</link
>.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="alarm-edit-dialog">
<title
>Häire redigeerimise dialoog</title>

<para
>Häire redigeerimise dialoog võimaldab häiret näha ja muuta.</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>

<sect2>
<title
>Häiretoiming</title>

<para
>Määra häire tüüp kastis <guilabel
>Toiming</guilabel
>:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Tekst</guilabel
> võimaldab sisestada tekstikasti häire teksti (see võib olla ka mitmel real ja tarvitada reavahetusi). Määrata saab järgmisi võimalusi:</para>

<itemizedlist>
<listitem>
<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>
</listitem>

<listitem>
<para
>Kasti <guilabel
>Heli</guilabel
> märkimisel käivitatakse häireteate näitamisel ka mingi heli. Vaikimisi on see piiks, kuid paremal 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
>Kui oled valinud helifaili esitamise, saad määrata veel teatud võimalusi:</para>

<itemizedlist>
<listitem>
<para
>Kasti <guilabel
>Kordus</guilabel
> märkimisel korratakse helifaili pidevalt seni, kuni häiret näidatakse (häreteate aknas on nupp, millega saab heli esitamise välja lülitada, kui sa soovid näha häiret ilma helita).</para>
</listitem>

<listitem>
<para
>Vali <guilabel
>Helitugevus</guilabel
> ja kasuta liugurit määramaks, kui vali peab helifail esitamisel olema.</para>

<tip
><para
>Nupuga <guibutton
>Proovi</guibutton
> saab valitud helitugevust testida.</para
></tip>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Kasti <guilabel
>Meeldetuletus</guilabel
> märkimisel saab lasta näidata meeldetuletust enne häiret ja enne selle kordusi (kui neid on). Seda, kui kaua enne häiret meeldetuletust näidatakse, saab määrata kohe kasti kõrval.</para>

<para
>Korduva häire korral märgi ära kast <guilabel
>Meeldetuletus ainult häire esimesel käivitamisel</guilabel
>, kui soovid, et meeldetuletust näidataks ainult enne häire esmakordset kasutamist. Kui kast märkimata jätta, on meeldetuletuse periood väiksem kui kordumise intervall.</para>
</listitem>

<listitem>
<para
>Häireteate aknale saab valida taustavärvi. (Värvivalikut ennast saab määrata <link linkend="preferences"
>seadistustedialoogis</link
>.) </para>
</listitem>

<listitem>
<para
>Nupuga <guibutton
>Font ja värv...</guibutton
> saab valida häireteate fondi ning esi- või tagaplaani värvi. Dialoogis <guilabel
>Häire fondi ja värvi valimine</guilabel
> võib märkida kasti <guilabel
>Kasutatakse vaikefonti</guilabel
>, millisel juhul häiret näidatakse selle fondiga, mis häire kõlamise ajal on süsteemis vaikefondiks. (Vaikefonti saab määrata <link linkend="preferences"
>seadistustedialoogis</link
>.) Konkreetse fondi määramiseks häire tekstile eemalda märge kastist <guilabel
>Kasutatakse vaikefonti</guilabel
>.</para>
</listitem>

<listitem>
<para
>Nupuga <guibutton
>Eritoimingud...</guibutton
> saab määrata shellikäsud, mis käivitatakse enne häire näitamist. Dialoogis <guilabel
>Spetsiaalsed häiretoimingud</guilabel
>:</para>

<itemizedlist>
<listitem>
<para
>Sisesta väljale <guilabel
>Häire-eelne toiming</guilabel
> shellikäsk, mis tuleb käivitada enne häire näitamist. Pane tähele, et &kalarm; ootab käsu lõplikku täitmist, enne kui näitab häiret.</para>
</listitem>

<listitem>
<para
>Sisesta väljale <guilabel
>Häirejärgne toiming</guilabel
> shellikäsk, mis tuleb käivitada pärast häireakna sulgemist.</para>
</listitem>
</itemizedlist>

<para
>Vaata allpool häirekäskude kirjeldust, ksu on juttu, kuidas käivitatakse shellikäsud.</para>

<para
>Pane tähele, et eritoiminguid ei käivitata, kui häiret näidati ajal, mil sa välja logisid ning taastatakse, kui sa uuesti sisse logid.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Fail</guilabel
> lubab sisestada teksti- või pildifaili nime või &URL;-i, mille sisu esitatakse häireteatena. Tekstivälja kõrval asuv nupp avab faili valimise dialoogi. Ülejäänud valikud sarnanevad eelkirjeldatutega.</para>
</listitem>

<listitem>
<para
><guilabel
>Käsk</guilabel
> võimaldab määrata käsureakorralduse, mis häire aktiveerumise ajal antakse. Käsk edastatakse vahetult vaikeshellile (selle määrab keskkonnamuutuja <envar
>SHELL</envar
>) ning see võib sisaldada mis tahes võtmeid, argumente, filtreeritavaid käske jne., mida shell üheainsa käsureakorralduse puhul vähegi võimaldab.</para>

<note
><para
>Seda võimalust ei saa kasutada, kui &kde; töötab nn. Kioski-režiimis.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>E-post</guilabel
> võimaldab saata kirja, määrates siin saajate aadressid, kirja teema ehk subjekti ning selle sisu. Adressaatide välja kõrval asuva nupuga saab avada &kde; aadressiraamatu ning valida sealt vajalikud aadressid. Kirjale saab ka faile lisada, kasutades selleks nuppu <guibutton
>Lisa...</guibutton
>. Arvesta, et kaasatud failid peavad olemas olema ka sel hetkel, kui häire käivitub. Häire määramise ajal neist koopiaid ei salvestata. Kaasatud faili eemaldamiseks vali see hüpikmenüüst ning klõpsa nupule <guibutton
>Eemalda</guibutton
>.</para>

<para
>Enda e-posti aadressi, mida saajatele näidatakse, saab määrata <link linkend="preferences"
>seadistustedialoogis</link
>. Vaikimisi on selleks &kde; juhtimiskeskuses määratud e-posti aadress.</para>

<para
>Võimalik on määrata järgmine lisavõimalus:</para>

<itemizedlist>
<listitem>
<para
>Kasti <guilabel
>Kiri ka iseendale</guilabel
> märkimisel saadetakse häire käivitamisel pimekoopia (BCC) saadetavast kirjast ka sulle. Aadressi, millele kiri saadetakse, saab määrata <link linkend="preferences"
>seadistustedialoogis</link
>, vaikimisi kasutatakse &kde; juhtimiskeskuses määratud aadressi.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Edasilükkamine</title>

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

</sect2>

<sect2>
<title
>Aeg</title>

<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"
>&kalarm;i seadistamine</link
>).</para>

<para
>Mittekorduva häire korral peab sisestatav kuupäev/kellaaeg olema tulevikus või kui sisestada ainult kuupäev, siis mitte varasem kui käesolev päev. Korduva häire korral sellist piirangut pole, sest sellisel juhul rakendatakse kuupäeva/kellaaega automaatselt esimesel sobival käesolevale hetkele järgneval ajal.</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>

</sect2>

<sect2>
<title
>Kordus</title>

<para
>Häire kordumise põhimalli näidatakse kaardil <guilabel
>Häire</guilabel
>. Seda, kas häiret korratakse ja kuidas seda tehakse, saab määrata kaardil <guilabel
>Kordumine</guilabel
>:</para>

<itemizedlist>
<listitem>
<para
>Sektsioonis <guilabel
>Kordamise reegel</guilabel
> saab määrata kordamiste tüübi või ajalise ulatuse:</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
>Kordamiseks regulaarse ajavahemiku järel vali meelepärane tüüp ning märgi 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). Vali ühtlasi kõik kuud, millal soovid häire käivitada.</para>
</listitem>
</itemizedlist>

<tip
><para
>Häire käivitamiseks ainult teatud nädalapäevadel vali nädalane vahe ja märgi ära kõik vajalikud nädalapäevad.</para
></tip>

</listitem>
</itemizedlist>
</listitem>

<listitem>
<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>

<listitem>
<para
>Kui soovid teatud kuupäevad/ajad määratud kordamistest välja jätta, tee seda sektsioonis <guilabel
>Erandid</guilabel
>. Erandite (&ie; välja jäetud kuupäevade/aegade) nimekirja näidatakse vasakul. Uue erandi lisamiseks määra kuupäev paremal ja klõpsa nupule <guibutton
>Lisa</guibutton
>. Erandi muutmiseks vali see nimekirjas, määra paremal uus kuupäev ja klõpsa nupule <guibutton
>Muuda</guibutton
>. Erandi kustutamiseks vali see nimekirjas ja klõpsa nupule <guibutton
>Kustuta</guibutton
>.</para>
</listitem>

</itemizedlist>

</sect2>

<sect2>
<title
>Muud valikud</title>

<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
>Klõpsa nupule <guibutton
>Lae mall</guibutton
> ja vali eelnevalt määratud võimalustega mall, mida kirjeldatakse osas <link linkend="create-edit"
>Häirete loomine ja muutmine</link
>. </para>

<para
>Häire testimiseks klõpsa nupule <guibutton
>Proovi</guibutton
>. See käivitab häire täpselt nagu tavalisel käivitamisel.</para>

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

</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. (Meeldetuletuste korral on küll näidatav kuupäev/aeg häire toimumise või kordumise, mitte meeldetuletuse enda aeg, ning ka akna tiitliribal seisab <quote
>Meeldetuletus</quote
>.)</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
>Häireteate aken pakub järgmisi võimalusi:</para>

<itemizedlist>
<listitem>
<para
>kinnitada häire 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äevale/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>

<listitem>
<para
>Nupp, millel on kujutatud <quote
>mängimise lõpetamise</quote
> sümbol, lubab lõpetada häirele määratud helifaili esitamise. Sellel klõpsamine ei mõjuta kuidagi häireteate akent.</para>

<note
><para
>See nupp ilmub ainult siis, kui häirele on määratud helifail.</para
></note>
</listitem>

<listitem>
<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>
</listitem>
</itemizedlist>

<para
>Häireteate akent saab näidata kahel erineval moel vastavalt valitud seadistusele. Režiimi saab valida <link linkend="preferences"
>seadistustedialoogis</link
>.</para>

<itemizedlist>
<listitem>
<para
>Tavalise akna korral võtab see ilmudes fookuse ka klaviatuuri jaoks, nii et kui töötad parajasti mõnes muus aknas, siis seal enam klahvile vajutamine ei toimi.</para>
</listitem>

<listitem>
<para
>Niinimetatud mittemodaalse akna korral häireteade küll ilmub, kuid seal ei saa kasutada klaviatuuri ning mõnes muus aknas töötamise korral võid seal oma tegevust jätkata. Selles režiimis ei ole aga aknal ka tiitliriba, mistõttu seda ei saa liigutada.</para>
</listitem>
</itemizedlist>

</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, hallikas ikoon aga osutab, et alarme ei jälgita.</para>

<para
>Kuii jätad hiirekursori mõneks hetkeks süsteemse salve ikooni kohale, näidatakse kohtspikrina järgmise 24 tunni jooksul käivitatavaid häireteateid või vähemalt neist esimesi. Selle võimaluse saab ka välja lülitada või näidatavate häirete arvu ja vormi muuta <link linkend="preferences"
>seadistustedialoogis</link
>.</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
>Uus häire...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Avab häire redigeerimise dialoogi ja lubab luua uue häire.</action
></para>
<para
>Vaata lähemalt <link linkend="alarm-edit-dialog"
>häire redigeerimise dialoogi</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>&kalarm;i seadistamine...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Avab &kalarm;i seadistustedialoogi.</action
></para>
<para
>Seadistustedialoogi kirjeldatakse osas <link linkend="preferences"
>&kalarm;i 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"
>&kalarm;i 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>

<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"
>&kalarm;i 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>
</sect1>

<sect1 id="refreshing">
<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
>Toimingud</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>

</sect1>

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

<sect2>
<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
>Toimingud</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>

</sect2>

<sect2>
<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
>Toimingud</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>

</sect2>
</sect1>

<sect1 id="using-daemon">
<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>

</sect1>

<sect1 id="quitting">
<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 kui rakendus töötab <quote
>pidevas</quote
> režiimis, siis 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 seadistustedialoogis ei ole just märgitud <guilabel
>Kui süsteemses salves ikooni pole, siis keelatakse häired</guilabel
>).</para
></tip>

</sect1>
</chapter>

<chapter id="preferences">
<title
>&kalarm;i seadistamine</title>

<para
>&kalarm;i tegevuse seadistamiseks nii, et see rahuldaks nii süsteemi kui sind ennast, vali menüükäsk <menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>&kalarm;i seadistamine...</guimenuitem
></menuchoice
>. See avab, nagu nimigi ütleb, seadistustedialoogi.</para>

<sect1 id="preferences-general">
<title
>Üldine</title>

<para
>Kaardil <guilabel
>Üldine</guilabel
> saab määrata &kalarm;i üldist käitumist:</para>

<itemizedlist>
<listitem
><para
>Sektsioon <guilabel
>Töörežiim</guilabel
>: siinsed valikud puudutavad &kalarm;i süsteemse salve ikooni ning võimaldavad teatud määral juhtida ka &kalarm;i süsteemi ressursside kasutamist vastavalt sellele, kas see töötab pidevalt või mitte. Kui süsteemi jõudlus on sulle oluline, võib olla eelistatav rakenduse töö ainult nõudmisel ja ilma ikooni süsteemses salves näitamata. Pidev töö kasutab rohkem süsteemi ressursse, kuid see-eest on ka pidevalt näha häireikoon ning kogu rakendus on paremini ligipääsetav. &kalarm;i töö nõudmisel ei mõjuta häirete käivitamist, sest nende nimekirja jälgib ja nende käivitamisega tegeleb <application
>häiredeemon</application
>, mitte &kalarm;.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Töötatakse pidevalt süsteemses salves</guilabel
>: &kalarm; töötab pidevas režiimis ning töötamise ajal näidatakse alati ikooni süsteemses salves. Selles režiimis suleb süsteemse salve ikooni sulgemine kõik &kalarm;i peaaknad ja kui ühtki teadeteakent ei ole nähtaval, lõpetab ka rakenduse töö. Selle režiimi korral saab kasutada järgmisi lisavõimalusi:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Käivitatakse sisselogimise ajal automaatselt</guilabel
>: kalarm; käivitatakse kohe &kde; seansi sisselogimise ajal, mis tagab, et &kalarm; töötab sisuliselt kogu aeg, kui sa just käsitsi selle tööd ei lõpeta.</para>
</listitem>
<listitem
><para
><guilabel
>Kui süsteemses salves ikooni pole, siis keelatakse häired</guilabel
>: selle valimine tähendab, et häireid ei käivitata, kui süsteemses salves pole &kalarm;i ikooni.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Hoiatus enne väljumist</guilabel
>: kui häired &kalarm;i mittetöötamise ajal välja lülitada, siis selle võimaluse valimisel küsitakse sinu käest alati kinnitust, kui proovid lõpetada kalarm;i töö süsteemse salve ikooni kontekstimenüü käsuga <menuchoice
><guimenu
>Välju</guimenu
></menuchoice
>. See väldib häirete juhuslikku väljalülitamist. Turvalisuse kaalutlustel lülitatakse see võimalus alati vaikimisi sisse, kui vahetad töörežiimi.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para
>Selles režiimis töötab &kalarm; &kde; süsteemse salve puudumisel pidevalt taustal ning häired on alati sisse lülitatud.</para>
</listitem>

<listitem
><para
><guilabel
>Käivitatakse vaid nõudmisel</guilabel
>: &kalarm; käivitatakse ainult siis, kui häire käivitatakse, kui käivitad selle käsitsi või kui näidatakse selle ikooni süsteemses salves. Selles režiimis näidatakse küll süsteemse salve ikooni, kuid selle sulgemine ei mõjuta kuidagi ühtegi &kalarm;i akent.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Sisselogimisel laetakse süsteemse salve ikoon automaatselt</guilabel
>: selle korral näidatakse &kalarm;i ikooni süsteemses salves kohe sisselogimisel. &kalarm; töötab, kuni süsteemse salve ikoon suletakse.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Ainult kuupäevaga määratud häirete alguskellaaeg:</guilabel
>: määrab 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
>Kui oled seadnud aastase kordumise 29. veebruarile, saab määrata, kuidas käsitletakse selliseid häireid juhul, kui tegemist ei ole liigaastaga:</para>

<itemizedlist>
<listitem
><para
><guilabel
>28. veebruaril</guilabel
>: häire käivitatakse liigaastal 29. ning muudel aastatel 28. veebruaril.</para>
</listitem>

<listitem
><para
><guilabel
>1. märtsil</guilabel
>: häire käivitatakse liigaastal 29. veebruaril ning muudel aastatel 1. märtsil.</para>
</listitem>

<listitem
><para
><guilabel
>Ei korrata</guilabel
>: häire käivitatakse liigaastal 29. veebruaril, muudel aastatel seda ei käivitatagi.</para>
</listitem>
</itemizedlist>

<note
><para
>Selle võimaluse muutmine ei põhjusta ühegi olemasoleva häire järgmise ajastatud kordumise ümberarvutamist. See mõjutab ainult uusi häireid või olemasolevaid häireid pärast nende järgmist käivitamist.</para
></note>
</listitem>

<listitem
><para
><guilabel
>Häire kustutamisel küsitakse kinnitust</guilabel
>: määrab, kas iga kord, kui sulged häireteate, küsitakse sinu käest selle kinnitust.</para>
</listitem>

<listitem
><para
>Sektsioon <guilabel
>Aegunud häired</guilabel
>: siinsed valikud puudutavad varasemate häirete salvestamist.</para>
<itemizedlist>
<listitem
><para
><guilabel
>Häired jäetakse aegudes alles</guilabel
>: selle valimisel aegunud häired salvestatakse, mittevalimisel häired pärast nende tähtaja läbisaamist kustutatakse.</para>
</listitem>

<listitem
><para
><guilabel
>Aegunud häired visatakse minema pärast</guilabel
>: määrab päevade arvu, mille järel häired pärast nende viimast aktiveerimist kustutatakse.</para>
</listitem>

<listitem
><para
><guibutton
>Kustuta aegunud häired</guibutton
>: see nupp kustutab kõik parajasti salvestatud aegunud häired. Sel ei ole mingit mõju häiretele, mis aeguvad alles hiljem: need salvestatakse vastavalt muudele valikutele.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-email">
<title
>E-post</title>

<para
>Sektsioonis <guilabel
>E-post</guilabel
> saab määrata kirja teel saadetavate häirete saatmise valikuid ja aadresside võimalusi:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>E-posti rakendus</guilabel
>: määrab, millist e-posti klienti kasutada häire saatmiseks kirja teel:</para>

<itemizedlist>
<listitem
><para
><guilabel
>KMail</guilabel
>: kirja teel saadetava häire käivitamisel lähetatakse kiri KMaili vahendusel järgmiselt:</para>

<itemizedlist>
<listitem
><para
>kui &kmail; parajasti töötab ja on versiooniga 1.7 või uuem, saadetakse kiri automaatselt.</para>
</listitem>

<listitem
><para
>kui &kmail; parajasti töötab ja on vanema versiooniga, lisatakse kiri &kmail;i kausta <filename
>väljuvad</filename
>, kust selle saab hiljem ära saata.</para>
</listitem>

<listitem
><para
>kui &kmail; ei tööta, avatakse &kmail;i redaktori aken eelnevalt täidetud väljadega, et saaksid kirja käsitsi teele läkitada.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: kirja teel saadetava häire käivitamisel läkitatakse kiri automaatselt teele rakenduse <application
>sendmail</application
> vahendusel. See võimalus toimib ainult siis, kui süsteem on seadistatud kasutama <application
>sendmail</application
>i või <application
>sendmail</application
>iga ühilduvat rakendust, näiteks <application
>postfix</application
> või <application
>qmail</application
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>E-posti aadress väljal <guilabel
>Kellelt</guilabel
> määrab aadressi, mida näidatakse kirja teel saadetava häire saatja aadressina. Võimalus <guilabel
>Kasutatakse juhtimiskeskuses määratud aadressi</guilabel
> lubab tarvitada siin aadressi, mis on määratud kindlaks &kde; juhtimiskeskuses.</para>
</listitem>

<listitem>
<para
>E-posti aadress väljal <guilabel
>Bcc</guilabel
> määrab aadressi, mida saab kasutada kirja teel saadetava häire pimekoopia saatmiseks iseendale juhul, kui sisse on lülitatud võimalus <guilabel
>Kiri ka iseendale</guilabel
>. Kui pimekoopia tuleb saata snu kontole arvutil, millel &kalarm; töötab, piisab siin lihtsalt kasutajanime andmisest. Võimalus <guilabel
>Kasutatakse juhtimiskeskuses määratud aadressi</guilabel
> lubab tarvitada siin aadressi, mis on määratud kindlaks &kde; juhtimiskeskuses.</para>
</listitem>

<listitem>
<para
><guilabel
>Märguanne meili järjekorda panekul</guilabel
>: selle valimisel näidatakse märguannet, kui e-posti rakendus paneb kirja teel saadetava häire järjekorda, mitte ei saada seda kohe minema. See on kasulik näiteks juhul, kui kasutad sissehelistamist või kui kiri pannakse ootele &kmail;i kausta <filename
>väljuvad</filename
>, millisel juhul võid ette võtta vajalikud sammud, et kirjad ka tegelikult teele läkitataks.</para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-view">
<title
>Vaade</title>

<para
>Sektsioonis <guilabel
>Vaade</guilabel
> saab määrata mõningaid &kalarm;i välimusse puutuvaid valikuid:</para>
<itemizedlist>

<listitem>
<para
>Sektsioon <guilabel
>Häirete nimekiri</guilabel
>: need valikud määravad, millist infot näidatakse &kalarm;i käivitamisel häirete nimekirjas (kui &kalarm; on juba käivitatud, saab menüü <guimenu
>Vaade</guimenu
> abil seda muuta).</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Häireaja näitamine</guilabel
>: selle valimisel näidatakse kuupäeva ja aega, millal iga häire peab käivituma.</para>
</listitem>

<listitem>
<para
><guilabel
>Häireni jäänud aja näitamine</guilabel
>: selle valimisel näidatakse, kui palju aega on jäänud iga häire järgmise käivitamiseni. Aega näidatakse päevades, tundides ja minutites.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Sektsioonis <guilabel
>Süsteemse salve kohtspikker</guilabel
> saab määrata, millist infot näidatakse kohtspikril, mis ilmub, kui hoida hiirekursorit mõne hetke &kalarm;i süsteemse salve ikooni kohal.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Järgmise 24 tunni häirete näitamine</guilabel
>: selle valimisel näidatakse järgmise 24 tunni või vähemalt mõne esimese sellesse vahemikku jääva häire kokkuvõtet.</para>
</listitem>

<listitem>
<para
><guilabel
>Maks. näidatavate häirete arv</guilabel
>: selle valimata jätmisel näidatakse kõiki järgmise 24 tunni häireid, valimisel saab määrata, mitut häiret maksimaalselt näidatakse.</para>
</listitem>

<listitem>
<para
><guilabel
>Häireaja näitamine</guilabel
>: selle valimisel näidatakse aega, millal iga häire peab käivituma.</para>
</listitem>

<listitem>
<para
><guilabel
>Häireni jäänud aja näitamine</guilabel
>: selle valimisel näidatakse, kui palju aega on jäänud iga häire järgmise käivitamiseni. Aega näidatakse tundides ja minutites.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Prefiks</guilabel
>: määrab sümboli või teksti, mida näidatakse häireni jäänud aja korral, et oleks võimalik seda eristada häire enda ajast.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Teateaken tiitliribaga ja klahvide kasutamisvõimalusega</guilabel
>: määrab, kas häireteadete aknad on modaalsed või mitte; &ie; kas nad haaravad ilmudes endale ka klaviatuuri fookuse. Täpsemalt vaata osa <link linkend="message-window"
>Häireteate aken</link
></para>
</listitem>

<listitem
><para
><guilabel
>Aegunud häirete näitamine</guilabel
>: selle valimisel näidatakse &kalarm;i käivitamisel häirete nimekirjas ka aegunud häireid (kui &kalarm; on käivitatud, saab näidatava muutmiseks kasutada menüükäsku <menuchoice
><guimenu
>Vaade</guimenu
><guimenuitem
>Näita aegunud häireid</guimenuitem
></menuchoice
>).</para>
</listitem>

<listitem
><para
><guilabel
>Süsteemse salve ikooni värskendamise intervall</guilabel
>: määrab &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>
</itemizedlist>
</sect1>

<sect1 id="preferences-fontcolour">
<title
>Font ja värv</title>

<para
>Sektsioonis <guilabel
>Font ja värv</guilabel
> saab määrata häireteadete vaikevälimuse ja häireloendis kasutatavad värvid:</para>
<itemizedlist>

<listitem
><para
>Valida häireteadete vaikimisi fondi ja taustavärvi.</para>
</listitem>

<listitem
><para
>Muuta värvivaliku nimekirja, mida näidatakse klõpsuga taustavärvi liitkastile:</para>
<itemizedlist>

<listitem
><para
><guilabel
>Lisa värv...</guilabel
>: avab värvi valimise dialoogi, kus saab valida nimekirjale lisatava värvi.</para>
</listitem>

<listitem
><para
><guilabel
>Eemalda värv</guilabel
>: eemaldab parajasti liitkastis <guilabel
>Tausta värv</guilabel
> näidatava värvi nimekirjast. Nimekirjast ei saa eemaldada kohandatud värvi ning selle näitamisel ei ole ka selle nupu kasutamine võimalik.</para>
</listitem>

</itemizedlist>
</listitem>

<listitem
><para
>Valida aegunud häirete värvi nende näitamisel häirete nimekirjas.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-edit">
<title
>Redigeerimine</title>

<para
>Sektsioonis <guilabel
>Redigeerimine</guilabel
> saab määrata <link linkend="alarm-edit-dialog"
>häire redigeerimise dialoogi</link
> vaikeväärtusi:</para>
<itemizedlist>

<listitem
><para
>Valida aegunud häirete värvi nende näitamisel häirete nimekirjas.</para>
</listitem>

<listitem
><para
>Valida vaikeväärtused võimalustele <guilabel
>Tähtaja möödumisel häire katkestatakse</guilabel
>, <guilabel
>Häire nägemise kinnituse küsimine</guilabel
> ja <guilabel
>Kiri ka iseendale</guilabel
>.</para>
</listitem>

<listitem
><para
>Määrata vaikimisi helifaili võtmed. Pane tähele, et vaikehelifaili saab määrata isegi siis, kui kast <guilabel
>Heli</guilabel
> on märkimata või kast <guilabel
>Piiks</guilabel
> märgitud.</para>
</listitem>

<listitem
><para
>Valida häirete kordumise vaiketüüp.</para>
</listitem>

<listitem
><para
>Valida meeldetuletuste perioodi vaikeühik.</para>
</listitem>

<listitem
><para
>Valida spetsiaalse häire näitamise vaiketoimingu.</para>
</listitem>

</itemizedlist>
</sect1>

</chapter>

<chapter 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="using-kalarm"
>&kalarm;i kasutamisest</link
> kõneldes. &kalarm;i spetsiifilisi käsurea võtmeid 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 võtmeid 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 võtmeid ainult ühe &kalarm;i toimingu tarbeks. Kui soovid läbi viia mitu toimingut, tuleb &kalarm; välja kutsuda mitu korda, andes iga kord konkreetse toimingu võtmed.</para>

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

<para
>Uue häire ajastamiseks saab kasutada järgmisi võtmeid:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Võti</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
>-A</option
>, <option
>--attach <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Määrab kirjale kaasatava faili nime või &URL;-i. Seda võtit võib vajadusel korrata. Selle võtme kasutamisel peab olema määratud ka võti <option
>--mail</option
>.</entry>
</row>
<row>
  <entry
><option
>-b</option
>, <option
>--beep</option
></entry>
  <entry
>Kuuldava piiksu esitamine teate näitamisel. Selle võtme korral ei tohi kasutada võtit <option
>--play</option
> ega <option
>--play-repeat</option
>.</entry>
</row>
<row>
  <entry
><option
>--bcc</option
></entry>
  <entry
>Pimekoopia kirjast iseendale. Selle võtme kasutamisel peab olema määratud ka võti <option
>--mail</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
>-C</option
>, <option
>--colorfg</option
>, <option
>--colourfg <replaceable
>värv</replaceable
></option
></entry>
  <entry
>Määrab teate esiplaani 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 võti olema &kalarm; käsurea viimane võti. Kõiki eelnevaid võtmeid tõlgendatakse käivitatava käsu osana. Selle korral ei saa kasutada võtmeid <option
>--file</option
> ega <option
>--mail</option
>. Võtmeid <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> ja <option
>--colorfg</option
> aga lihtsalt ignoreeritakse.</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Määrab teksti- või pildifaili nime või &URL;-i, mille sisu kujutab endast häireteate sisu. Selle puhul ei saa määrata võtmeid <option
>--exec</option
> ja <option
>--mail</option
> ning esineda ei tohi argument <replaceable
>teade</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
>. Selle võtmega koos ei saa kasutada võtit <option
>--recurrence</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 võtme kasutamisel ei saa kasutada võtmeid <option
>--interval</option
>, <option
>--repeat</option
> ja <option
>--until</option
>.</entry>
</row>
<row>
  <entry
><option
>-m</option
>, <option
>--mail <replaceable
>aadress</replaceable
></option
></entry>
  <entry
>Määrab kirja saatmise antud aadressile. Seda võtit võib vajadusel korrata. Sellega koos ei saa kasutada võtmeid <option
>--exec</option
> ja <option
>--file</option
>. Võtmeid <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> ja <option
>--colorfg</option
> aga lihtsalt ignoreeritakse.</entry>
</row>
<row>
  <entry
><option
>-p</option
>, <option
>--play <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Määrab häire näitamisel mängitava helifaili nime või &URL;-i. Selle võtme kasutamisel ei saa kasutada võtit <option
>--play-repeat</option
> ega <option
>--beep</option
>.</entry>
</row>
<row>
  <entry
><option
>-P</option
>, <option
>--play-repeat <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Määrab häire näitamisel mängitava helifaili nime või &URL;-i. Selle võtme kasutamisel ei saa kasutada võtit <option
>--play</option
> ega <option
>--beep</option
>.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>määratlus</replaceable
></option
></entry>
  <entry
>Määrab häire korduma. Kordumise määratlus peab kasutama iCalendari süntaksit (selle defineerib RFC 2445), &eg; <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
>. Sellega koos ei saa kasutada võtmeid <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 võtit <option
>--interval</option
> ja välistab võtmed <option
>--until</option
>ning <option
>--recurrence</option
>.</entry>
</row>
<row>
  <entry
><option
>-R</option
>, <option
>--reminder <replaceable
>periood</replaceable
></option
></entry>
  <entry
>Määrab meeldetuletuse näitamise määratud ajal enne häiret ja selle kordusi (kui neid on). 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). Seda võtit ei saa kasutada koos võtmetega <option
>--exec</option
> või <option
>--mail</option
>.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>subjekt</replaceable
></option
></entry>
  <entry
>Määrab kirja subjektirea ehk teema. Selle kasutamisel peab kasutama ka võtit <option
>--mail</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
>-v</option
>, <option
>--volume <replaceable
>protsent</replaceable
></option
></entry>
  <entry
>Määrab audifaili esitamise helitugevuse. Seda võtit saab kasutada ainult koos võtmega <option
>--play</option
> või <option
>--play-repeat</option
>.</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 võtme kasutamine nõuab võtit <option
>--interval</option
> ja välistab võtmed <option
>--repeat</option
> ning <option
>--recurrence</option
>.</entry>
</row>
<row>
  <entry
><replaceable
>teade</replaceable
></entry>
  <entry
>Näidatava teate tekst või koos võtmega <option
>--mail</option
> kirja sisu.</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 võtmed 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>

</sect1>

<sect1 id="cmdline-other">
<title
>Muud võtmed</title>

<para
>Järgmisi võtmeid saab kasutada <application
>häiredeemon</application
>i peatamiseks või lähtestamiseks ning &kalarm;i 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
>Võti</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>

</sect1>

<sect1 id="cmdline-help">
<title
>Abivõtmed</title>

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

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Võti</entry>
  <entry
>Kirjeldus</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help</option
></entry>
  <entry
>Näitab lühidalt võtmete abiteksti.</entry>
</row>
<row>
  <entry
><option
>--help-qt</option
></entry>
  <entry
>Näitab &Qt; spetsiifilisi võtmeid.</entry>
</row>
<row>
  <entry
><option
>--help-kde</option
></entry>
  <entry
>Näitab &kde; spetsiifilisi võtmeid.</entry>
</row>
<row>
  <entry
><option
>--help-all</option
></entry>
  <entry
>Näitab kõiki võtmeid.</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äitab infot litsentsi kohta.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</sect1>
</chapter>

<chapter 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>

<sect1 id="daemon-start">
<title
><application
>Häiredeemon</application
>i käivitamine, lähtestamine ja peatamine</title>

<para
><application
>Häiredeemon</application
> käivitatakse tavaliselt &kde; seansi 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>

<sect2>
<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 võtmeteta), 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>

</sect2>

<sect2 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
>Toimingud</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>

</sect2>

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

</sect1>

<sect1 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>

</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
>katkestab juba ajastatud häire.</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
>käivitab juba ajastatud häire.</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
>käivitab või katkestab juba ajastatud häire.</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
>uue häire ajastamine.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>message</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, const QColor&amp; <replaceable
>fg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>reminder</replaceable
>, const QString&amp; <replaceable
>recurrence</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>message</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, const QColor&amp; <replaceable
>fg</replaceable
>, const QFont&amp; <replaceable
>font</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>reminder</replaceable
>, const QString&amp; <replaceable
>recurrence</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>message</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, const QColor&amp; <replaceable
>fg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>reminder</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
>, const QColor&amp; <replaceable
>fg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>reminder</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
>fg</parameter
></term>
<listitem>
<para
>Määrab näidatava teate esiplaani värvi.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>font</parameter
></term>
<listitem>
<para
>Määrab näidatava teate fondi.</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
>alarmevent.h</filename
> klassiga KAEvent</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
>reminder</parameter
></term>
<listitem>
<para
>Määrab minutites aja enne häire ja selle korduste (kui neid on) käivitamist, millal näidatakse meeldetuletust. Kui meeldetuletust vaja ei ole, määra 0.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Määrab häire regulaarse kordumise iCalendari süntaksis, nagu selle defineerib RFC 2445. Näiteks <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> määrab 4 kordus 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.</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
>alarmevent.h</filename
> klassiga KAEvent.</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 mitu vormi. Kaks üldisemat vormi lubavad määrata suvalise kordumise ning neid saab kasutada ka mittekorduvate häirete korral. Määrata võib fondi parameetri või selle määramata jätta, millisel juhul kasutatakse &kalarm;i vaikefonti. Teised vormid võimaldavad mugavalt määrata piiratuma häire kordumise tüübi, üks neist kindla korduste arvuga korduva häire ja teine lõppemisajaga korduva häire. Mõlemad kasutavad vaikefonti.</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 või regulaarselt korduva häire jaoks, mis kasutab kordumise määratlemiseks iCalendari süntaksit:</para>

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

<para
>Kasuta järgnevaga sarnanevat koodi parameetriandmete määramiseks funktsiooni <function
>scheduleMessage</function
> &DCOP; väljakutsele korduva häire jaoks, mis ei kasuta iCalendari süntaksit:</para>

<screen
>QString message, audioFile;
QDateTime dateTime;
QColor bgColor, fgColor;
Q_UINT32 flags;
Q_INT32 reminder, 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;bgColor, sizeof(QColor));
arg.writeRawBytes((char*)&amp;fgColor, sizeof(QColor));
arg &lt;&lt; flags &lt;&lt; audioFile &lt;&lt; reminder &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
>uue häire ajastamine, mis näitab teksti- või pildifaili sisu.</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
>, int <replaceable
>reminder</replaceable
>, const QString&amp; <replaceable
>recurrence</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
>reminder</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
>reminder</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 teksti- või pildifaili 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
>alarmevent.h</filename
> klassiga KAEvent</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
>reminder</parameter
></term>
<listitem>
<para
>Määrab minutites aja enne häire ja selle korduste (kui neid on) käivitamist, millal näidatakse meeldetuletust. Kui meeldetuletust vaja ei ole, määra 0.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Määrab häire regulaarse kordumise iCalendari süntaksis, nagu selle defineerib RFC 2445. Näiteks <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> määrab 4 kordus 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.</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
>alarmevent.h</filename
> klassiga KAEvent.</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 teksti- või pildifaili 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
>uue häire ajastamine, mis käivitab shellikäsu.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>commandLine</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>recurrence</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
>alarmevent.h</filename
> klassiga KAEvent, ainult lipubitti BEEP ignoreeritakse.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Määrab häire regulaarse kordumise iCalendari süntaksis, nagu selle defineerib RFC 2445. Näiteks <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> määrab 4 kordus 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.</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
>alarmevent.h</filename
> klassiga KAEvent.</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>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>uue häire ajastamine, mis saadab häire e-postitsi.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>addresses</replaceable
>, const QString&amp; <replaceable
>subject</replaceable
>, const QString&amp; <replaceable
>message</replaceable
>, const QString&amp; <replaceable
>attachments</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>recurrence</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>addresses</replaceable
>, const QString&amp; <replaceable
>subject</replaceable
>, const QString&amp; <replaceable
>message</replaceable
>, const QString&amp; <replaceable
>attachments</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 scheduleEmail(const QString&amp; <replaceable
>addresses</replaceable
>, const QString&amp; <replaceable
>subject</replaceable
>, const QString&amp; <replaceable
>message</replaceable
>, const QString&amp; <replaceable
>attachments</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
>addresses</parameter
></term>
<listitem>
<para
>Määrab saajate e-posti aadressid. Mitme aadressi määramisel eralda need komadega.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subject</parameter
></term>
<listitem>
<para
>Määrab kirja subjektirea ehk teema.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>message</parameter
></term>
<listitem>
<para
>Määrab kirja sisu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>attachments</parameter
></term>
<listitem>
<para
>Määrab kirjale lisatavate failide &URL;-id. Mitme &URL;-i määramisel eralda need komadega.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>dateTime</parameter
></term>
<listitem>
<para
>Määrab kuupäeva ja aja, millal kiri teele saata.</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
>alarmevent.h</filename
> klassiga KAEvent</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Määrab häire regulaarse kordumise iCalendari süntaksis, nagu selle defineerib RFC 2445. Näiteks <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> määrab 4 kordus 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.</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
>alarmevent.h</filename
> klassiga KAEvent.</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 kiri saata. -1 tähendab häire lõputut kordamist.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Kirjeldus</title>
<para
><function
>scheduleEmail()</function
> on &DCOP; väljakutse määratud e-kirja saatmise ajastamiseks määratud kuupäevale ja ajale. Kui kõrvale jätta ühelt poolt kirja päise ja sisu 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 võtmeid 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 võtmeid, peitub selles, et kui &kalarm; käivitada ilma käsurea parameetriteta ja seejärel esitada talle &DCOP; väljakutse, käivitub 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 võtmeid uue häire ajastamiseks on kirjeldatud osas <link linkend="cmdline-operation"
>Käsurea kasutamine</link
>. Võtmed ajastatud häirete käivitamiseks ja peatamiseks on järgmised:</para>

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

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Võti</entry>
  <entry
>Kirjeldus</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--calendarURL <replaceable
>url</replaceable
></option
></entry>
  <entry
>Määratud &URL;-iga kalendrifaili kasutamine. See võti 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
>Mis on häiredeemon?</para>
</question>
<answer>
<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 käsu tegutseda, kui õige aeg on kätte jõudnud.</para>
</answer>
</qandaentry>

<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 (kirje <parameter
>Calendar</parameter
> sektsioonis <parameter
>General</parameter
>).</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>

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

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

<para
>Parajasti näidatavate häirete üksikasju sisaldab kalendrifail <filename
>$KDEHOME/share/apps/kalarm/displaying.ics</filename
>.</para>

</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, 2003, 2004: 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, 2003, 2004: 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; &underGPL; </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/kalarm.html"
>http://www.astrojar.org.uk/linux/kalarm.html</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
> arenduspaketid. Olemasolu korral saab X11 arenduspaketti kasutada &kalarm;i paremaks toimimiseks &kde;s süsteemse salve puudumisel.</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 see 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 parameetrina 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>

<para
>&kalarm;il on spetsiaalne konfiguratsioonivõti, mis lubab määrata, millises keeles dokumentatsioon paigaldada, andes selles käsu <command
>./configure</command
> parameetrina ühe või enam keelekoodi. Vaikimisi paigaldatakse dokumentatsioon kõigis saadaolevates keeltes. Paketti kaasatud keelte loendi koos nende koodidega toob ära fail <filename
>DOC-LANGUAGES</filename
>. Pane tähele, et siin pole oluline, kas paigaldatud on ka sama keele KDE üldpakett. Näiteks ainult prantsus- ja ingliskeelse dokumentatsiooni paigaldamiseks anna käsk:</para>

<para
><userinput
><command
>./configure</command
> --enable-doc-language=<replaceable
>"fr en_GB"</replaceable
></userinput
></para>

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

