summaryrefslogtreecommitdiffstats
path: root/tde-i18n-et/docs/tdepim/kalarm/index.docbook
blob: 2826f0f12b0c3f5f5e6d0f6456eba5c0a68f54d6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kalarm;">
  <!ENTITY package "tdepim">
  <!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> <surname>Jarvie</surname> <affiliation> <address><email>&David.Jarvie.mail;</email></address>
</affiliation>
</author>

<othercredit role="developer"><firstname>David</firstname> <surname>Jarvie</surname> <affiliation><address><email>&David.Jarvie.mail;</email></address></affiliation>
<contrib>Arendaja</contrib>
</othercredit>

<othercredit role="translator"><firstname>Marek</firstname><surname>Laane</surname><affiliation><address><email>bald@starman.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><year>2005</year><year>2006</year><year>2007</year><year>2008</year>
<holder>David Jarvie</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

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

<date>2008-01-23</date>
<releaseinfo>1.05.00</releaseinfo>

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


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

</bookinfo>


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

<para>&kalarm; võimaldab ajastada isiklike häireteadete näitamist, helifailide esitamist, käskude käivitamist ja kirjade saatmist.</para>

<para>Vaikimisi käivitatavas graafilises režiimis näitab &kalarm; ootelolevate 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 või teate kõnelemise 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 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 ootelolevaid 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. Meeldetuletusega häire korral näidatakse häire enda, mitte meeldetuletuse aega.) Iga häire teksti/faili/käsu/kirjateema kõrval vasakul 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, tüübi 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. Seda, millist veergu vaikimisi näidatakse, saab määrata <link linkend="preferences-view">seadistustedialoogis</link>.</para>

<sect2 id="expired">
<title>Aegunud häired</title>

<para>Vaikimisi salvestab &kalarm; häired teatud ajaks ka pärast seda, kui need on aegunud või kustutatud. (Pane siiski tähele, et kustutatud häired salvestatakse ainult siis, kui neid on vähemalt korra käivitatud.) Seda, kas &kalarm; aegunud häired salvestab ja kui kaua neid säilitatakse, saab määrata <link linkend="preferences-general">seadistustedialoogis</link>.</para>

<para>Aegunud 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. Nende vaikimisi näitamise saab sisse lülitada <link linkend="preferences-view">seadistustedialoogis</link>.</para>

</sect2>

<sect2 id="search">
<title>Otsimine häirete nimekirjas</title>

<para>Konkreetsete häirete leidmiseks võib kasutada otsingut. Selleks vali menüükäsk <menuchoice> <guimenu>Redigeerimine</guimenu><guimenuitem>Otsi</guimenuitem></menuchoice>. Otsingudialoogis määra, millist laadi häiret soovid otsida. Täiendavate sobivate häirete leidmiseks kasuta menüükäske <menuchoice> <guimenu>Redigeerimine</guimenu><guimenuitem>Otsi järgmine</guimenuitem></menuchoice> ja <menuchoice> <guimenu>Redigeerimine</guimenu><guimenuitem>Otsi eelmine</guimenuitem> </menuchoice>.</para>

<para>Otsing sooritatakse järgmiselt:</para>

<itemizedlist>
<listitem>
<para>Tekstihäired: otsitakse teate teksti.</para>
</listitem>

<listitem>
<para>Failihäired: otsitakse faili asukohta/URL-i.</para>
</listitem>

<listitem>
<para>Käsuhäired: otsitakse käsurida või skripti.</para>
</listitem>

<listitem>
<para>E-posti häired: lisaks kirja teemale ja sisule otsitakse ka saajaid ja kaasatud failide URL-e.</para>
</listitem>
</itemizedlist>

<note><para>Otsimiseks saab valida ainult häireid, mida näidatakse parajasti häirete nimekirjas. See tähendab, et kui soovid otsida aegunud häireid, tuleb need kõigepealt nimekirjas nähtavaks muuta (seda kirjeldati eespool).</para></note>
</sect2>
</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-dlg">häire muutmise 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 järgi osas <link linkend="templates">Häiremallid</link> toodud juhiseid.</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 <link linkend="alarm-edit-dlg">häire redigeerimise dialoogi</link>, 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 <link linkend="alarm-edit-dlg">häire redigeerimise dialoogi</link>, kus kogu kirja, kaasa arvatud saatja, saaja jne., näidatakse häire tekstina.</para>
</listitem>

<listitem>
<para>Uue häire loomiseks, mis saadaks olemasoleva e-kirja koopia, lohista vastav kiri &kmail;ist &kalarm;i peaaknasse või süsteemse salve ikoonile. Seejärel vali <guilabel>E-post</guilabel>. <link linkend="alarm-edit-dlg">Häire redigeerimise dialoog</link> näitab nüüd kogu kirja, välja arvatud saatja.</para>
</listitem>

<listitem>
<para>Mis tahes teksti lohistamine &kalarm;i peaaknasse või süsteemse salve ikoonile avab <link linkend="alarm-edit-dlg">häire redigeerimise dialoogi</link> 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 <link linkend="alarm-edit-dlg">häire redigeerimise dialoogi</link>, 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 &aadressiraamat;us. Seda kirjeldab lähemalt osa <link linkend="birthdays">Sünnipäevade importimine &aadressiraamat;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>See avab <link linkend="alarm-edit-dlg">häire redigeerimise dialoogi</link>.</para>

</sect2>

<sect2>
<title>Häire aktiveerimine/deaktiveerimine</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>

<para>Kui kustutad aktiivse häire, salvestatakse see aegunud häirena juhul, kui seda on enne kustutamist vähemalt korra käivitatud ja kui aegunud häirete salvestamine on üldse lubatud (seda, kas ja kui jah, siis kui kaua aegunud häireid salvestatakse, saab määrata <link linkend="preferences-general">seadistustedialoogis</link>). Kui kustutad aegunud häire või aktiivse, kuid käivitamata häire, kustutatakse see jäädavalt.</para>

<para>Kustutatud häire saab aegunud häirete nimekirjast uuesti aktiveerida, kui see ei ole just juba sealtki kustutatud. Selleks too kõigepealt aegunud häired nähtavale, nagu kirjeldab osa <link linkend="expired">Aegunud häired</link>. Seejärel:</para>

<itemizedlist>
<listitem>
<para>vali häire või häired klõpsuga nende nimel nimekirjas. Seejärel vali menüükäsk <menuchoice> <guimenu>Toimingud</guimenu><guimenuitem>Aktiveeri uuesti</guimenuitem> </menuchoice>.</para>
</listitem>
<listitem>
<para>klõpsa hiire <mousebutton>parema</mousebutton> nupuga häire nimel aegunud häirete nimekirjas ja vali ilmuvast menüüst <menuchoice><guimenuitem>Aktiveeri uuesti</guimenuitem></menuchoice>.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title>Häire lubamine/keelamine</title>

<para>Täpsemat infot häirete lubamise ja keelamise kohta kas ühe- või mitmekaupa leiab osast <link linkend="enable-disable">Häirete lubamine/keelamine</link>.</para>

</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 avab <link linkend="alarm-edit-dlg">häire redigeerimise dialoogi</link> kirjutuskaitstuna.</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>

<para>Uue häire loomiseks malli põhjal ava <link linkend="alarm-edit-dlg">häire redigeerimise dialoog</link> malli eelnevalt täidetud andmetega:</para>

<itemizedlist>
<listitem>
<para>Vali menüükäsk <menuchoice><guimenu>Toimingud</guimenu> <guimenuitem>Uus häire mallist</guimenuitem></menuchoice> ja seejärel vajalik mall.</para>
</listitem>

<listitem>
<para>klõpsa hiire <mousebutton>parema</mousebutton> nupuga ikoonil süsteemses salves ja vali menüüst <menuchoice><guimenuitem>Uus häire mallist</guimenuitem></menuchoice> ning seejärel vajalik mall.</para>
</listitem>

<listitem>
<para>Ava <link linkend="alarm-edit-dlg">häire redigeerimise dialoog</link> tavalisel viisil ning klõpsa nupule <guibutton>Laadi mall...</guibutton> Seejärel vali mall.</para>
</listitem>
</itemizedlist>

<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 nimekirjast 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 häirete 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 dialoogi.</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-dlg">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 nimekirjas, 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>

<listitem>
<para>kastis <guilabel>Praegusest ajast alates</guilabel> saab sisestada, millal pärast praegust hetke (tundides ja minutites) tuleks häire käivitada.</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="import">
<title>Häirete importimine välistest kalendritest</title>

<para>Häireid saab &kalarm;i muudest kalendrifailidest importida menüükäsuga <menuchoice><guimenu>Fail</guimenu> <guimenuitem>Impordi häired...</guimenuitem></menuchoice>. Importimisel otsitakse valitud kalendrifailist häireid sisaldavaid sündmusi ning kopeeritakse need (koos uue unikaalse ID-ga) &kalarm;i kalendrisse. Häireteta sündmusi ja muud tüüpi kalendrikirjeid ignoreeritakse.</para>

<warning><para>Kui importida häireid kalendrifailist, mis on loodud mõne muu rakendusega kui &kalarm;, võivad häired importimisel muutuda &ndash; isegi häire aeg võib muutuda. See sõltub häire loomiseks kasutatud rakenduse andmesalvestuse viisist ning muutused on vältimatud, kui see erineb sellest, mida eeldab &kalarm;. Seepärast tasub alati imporditud häired üle kontrollida, et neis ei esineks soovimatuid muudatusi, ning vajaduse korral neid kohandada.</para></warning>

</sect2>

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

<para>Sünnipäevade nägemiseks, mis leiduvad &aadressiraamat;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 &aadressiraamat;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-dlg">häirete redigeerimise dialoogis</link>.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2 id="undo">
<title>Võta tagasi / Tee uuesti</title>

<para>Enamikku &kalarm;i aktiivse seansi ajal ettevõetud toiminguid saab tagasi võtta ja uuesti teha, kaasa arvatud häirete ja häiremallide loomine, redigeerimine ja kustutamine ning häirete taasaktiveerimine. Et tagasivõtmiste ajalugu ei nõuaks liiga palju ressursse, on meelespeetavate muudatuste arvule seatud piiranguks 12.</para>

<para>Viimase toimingu tühistamiseks vali menüükäsk <menuchoice> <guimenu>Redigeerimine</guimenu><guimenuitem>Võta tagasi</guimenuitem></menuchoice>. Viimase tagasivõetud toimingu taassooritamiseks vali menüükäsk <menuchoice> <guimenu>Redigeerimine</guimenu><guimenuitem>Tee uuesti</guimenuitem></menuchoice>.</para>

<para>Mõne varasema muudatuse tühistamiseks klõpsa tööriistaribal nupule <guibutton>Võta tagasi</guibutton> ja hoia hiirenuppu all. Ilmub toimingute nimekiri, kus saad valida, milline neist tagasi võtta. Kui sa ei näe vajalikku toimingut, siis arvesta, et vaja võib olla kõigepealt tühistada mõned hilisemad toimingud, millest sinu soovitud toiming sõltub. Kui näiteks oled häiret redigeerinud ja seejärel selle kustutanud, ei saa sa redigeerimist tühistada, kui sa ei ole tühistanud kustutamiskäsku.</para>

<para>Mõne varasema muudatuse taassooritamine käib samamoodi, ainult et mõistagi tööriistariba nupuga <guibutton>Tee uuesti</guibutton>.</para>

</sect2>
</sect1>

<sect1 id="alarm-edit-dlg">
<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>Valik <guilabel>Heli</guilabel> võimaldab valida, kas häireteate näitamise ajal esitatakse ka heli. Valikud on järgmised:</para>

<itemizedlist>
<listitem>
<para><guilabel>Puudub</guilabel> näitab häiret vaikselt.</para>
</listitem>

<listitem>
<para><guilabel>Piiks</guilabel> toob kuuldavale piiksu.</para>
</listitem>

<listitem>
<para><guilabel>Kõnelemine</guilabel> tähendab lisaks häireteate näitamisele ka selle kuuldavat esitamist. See valik on kasutatav ainult siis, kui paigaldatud ja seadistatud on <application>KTTSD</application> (moodulis tdeaccessibility) ning sobiv kõnesüntesaator, &eg; <application>Festival</application>.</para>
</listitem>

<listitem>
<para><guilabel>Helifail</guilabel> esitab helifaili. Paremal asuva nupuga saab avada helifaili dialoogi, kus saab valida esitatava faili ning määrata selle helitugevuse ja soovi korral kordamise. Hiirt nupu kohal seisma jättes näeb kohtspikris parajasti valitud helifaili.</para>

<note><para>&kalarm; kasutab kordamiste ja helitugevuse juhtimiseks heliserverit &arts;. Kui &kalarm; on ehitatud ilma &arts;i toetuseta, ei saa kordamise ja helitugevuse valikuid kasutada ning täieliku helifaili dialoogi asemel näeb tavalist lihtsat failivalijat.</para></note>

<para>Helifaili dialoogis:</para>

<itemizedlist>
<listitem>
<para>Sisesta helifaili asukoht või kasuta tekstikasti kõrval olevat nuppu failidialoogi avamiseks. Valitud faili saab kuulata, kui klõpsata tekstiväljast vasakul pool asuvale esitamisnupule. Seejärel muudab nupp oma funktsiooni ja võimaldab esitamise peatada, kui oled faili piisavalt kuulanud.</para>
</listitem>

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

<listitem>
<para>Soovi korral saab lasta helil tugevneda. See tähendab, et helifaili hakatakse mängima teatud helitugevusega, mis muutub järk-järgult, kuni saavutab määratud aja jooksul lõpliku helitugevuse. Lõplik helitugevus on see, mille määrasid valikuga <guilabel>Helitugevus</guilabel>. Tugevnemise võimaldamiseks märgi <guilabel>Tugevnemine</guilabel>, sisesta sekundites <guilabel>tugevnemise aeg</guilabel> ning määra liuguriga <guilabel>Algne helitugevus</guilabel>.</para>
</listitem>
</itemizedlist>

<note><para>Võimaluse korral kasutatakse helitugevuse määramiseks &kmix;i. See tagab, et helitugevust, millega häiret esitatakse, ei sega muudatused arvuti helitasemes. Kui &kmix; pole paigaldatud (või on varasem kui &kde; 3.1), määratakse helitugevus suhtelisena helitaseme suhtes häire käivitamise ajal. Sel juhul sõltub helitugevus, millega häiret esitatakse, arvuti helitaseme muudatustest.</para></note>

<tip><para>Nupuga <guibutton>Proovi</guibutton> saab valitud helitugevust testida.</para></tip>
</listitem>
</itemizedlist>
</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-fontcolour">seadistustedialoogis</link>.) Konkreetse fondi määramiseks häire tekstile eemalda märge kastist <guilabel>Kasutatakse vaikefonti</guilabel>.</para>

<para>Valitud fonti ja värve näidatakse nupu kõrval näitetekstina. Seda saab muuta näiteks eritähtede väljanägemise uurimiseks.</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>

<para>Häire-eelne toiming võetakse ette ainult üks kord, enne häire esimest kasutamist, kaasa arvatud juhul, kui meeldetuletus on asendatud tegeliku häirega. Seda <emphasis>ei</emphasis> võeta ette järgmistel juhtudel:</para>

<itemizedlist>
<listitem><para>Meeldetuletuse esitamisel.</para></listitem>
<listitem><para>Häire esitamisel uuesti pärast selle edasilükkamist.</para></listitem>
<listitem><para>Häire esitamisel ajal, mil sa olid välja loginud, ning selle taastamisel, kui uuesti sisse logid.</para></listitem>
<listitem><para>Korduva häire käivitumisel, kui eelmine häire (või edasilükatud häire) on veel nähtav - see tähendab juhul, kui häire eelmist korda ei ole veel kustutatud.</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Väljale <guilabel>Häirejärgne toiming</guilabel> saab sisestada shellikäsu, mis käivitatakse pärast häire kustutamist (kas klõpsuga nupule <guibutton>Sulge</guibutton> või akna tiitliriba sulgemisnupule). Seda <emphasis>ei</emphasis> võeta ette järgmistel juhtudel:</para>

<itemizedlist>
<listitem><para>Meeldetuletuse sulgemisel.</para></listitem>
<listitem><para>Häire edasilükkamisel, välja arvatud juhul, kui edasilükatud häire lõpuks suletakse.</para></listitem>
<listitem><para>Häire sulgemisel väljalogimise tõttu.</para></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para>Vaata allpool häirekäskude kirjeldust, kus on juttu, kuidas käivitatakse shellikäsud.</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 eelkirjeldatud tekstihäirete omadega, kuid siiski pole saadaval valik <guilabel>Kõnelemine</guilabel>.</para>
</listitem>

<listitem>
<para><guilabel>Käsk</guilabel> võimaldab sisestada käivitatava käsu.</para>

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

<itemizedlist>
<listitem>
<para>Kastiga <guilabel>Skripti sisestamine</guilabel> saab määrata, kas sisestada shellikäsk või skripti.</para>

<para>Kui see on märkimata, saab 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>

<para>Kui see on märgitud, saab sisestada käivitatava skripti teksti. Pane tähele, et esimesel real oleks midagi sellist nagu <literal>#!/bin/bash</literal>, et kutsutaks välja sobiv käsuinterpretaator.</para>
</listitem>

<listitem>
<para><guilabel>Käsu väljund</guilabel> võimaldab määrata, mida võtta ette käsu käivitamisel tekkiva terminali väljundiga.</para>

<itemizedlist>
<listitem>
<para><guilabel>Käivitatakse terminali aknas</guilabel>: märkimisel käivitatakse käsk terminali aknas. Millist terminali kasutatakse, saab määrata <link linkend="preferences-general">seadistustedialoogis</link>.</para>
</listitem>

<listitem>
<para><guilabel>Logitakse faili</guilabel>: käsu väljund salvestatakse faili. Väljund, mille ette lisatakse päis, mis näitab aega, mil käsk oli ajastatud käivituma, lisatakse faili senisele sisule. Sisesta faili nimi tekstikasti või kasuta selle kõrval asuvat nuppu failidialoogi avamiseks, kust vajalik fail valida.</para>
</listitem>

<listitem>
<para><guilabel>Unusta</guilabel>: käsu väljund unustatakse.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</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>Võimalik on määrata järgmisi valikuid:</para>

<itemizedlist>
<listitem>
<para>Liitkastis <guilabel>Kellelt</guilabel> saab valida, millist &kmail;i identiteeti kasutada oma e-posti aadressina kirja saatmisel. See on kasutatav ainult siis, kui sinu e-posti aadressi välja <guilabel>Kellelt</guilabel> jaoks on <link linkend="preferences-email">seadistustedialoogis</link> määratud valik <guilabel>Kasutatakse &kmail;i identiteete</guilabel>. Kui aga oled <link linkend="preferences-email">seadistustedialoogis</link> määranud konkreetse e-posti aadress, ei ole siin midagi valida.</para>
</listitem>

<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-email">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-general">&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>Meeldetuletus</title>

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

<note><para>Meeldetuletusi ei näidata kordusesiseste alamkorduste puhul. Meeldetuletusi näidatakse ainult iga häire peakorduse eel.</para></note>

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

</sect2>

<sect2>
<title>Katkestamine</title>

<para>Katkestamisvalikud lubavad määrata, mida võetakse häirega ette pärast selle käivitamise aja möödumist:</para>

<itemizedlist>
<listitem>
<para><guilabel>Tähtaja möödumisel häire katkestatakse</guilabel> võimaldab määrata, mis juhtub siis, kui häiret ei saa ettenähtud ajal käivitada.</para>

<para>Kasti märkimisel katkestatakse häire, kui seda ei õnnestu käivitada määratud aja jooksul pärast käivitamisaega. Tähtaja saab määrata valikutega, mis ilmuvad siis, kui kasti märgistad. Kui näiteks määrad tähtajaks 1 tunni, käivitatakse häire pärast käivitamisaja saabumist esimesel võimalusel järgneva tunni jooksul, aga kui seda selle tunni jooksul ei õnnestu käivitada, häire tühistatakse.</para>

<note><para>Ainult kuupäevaga määratud häirete korral, &ie; häirete puhul, mille korral on valitud <guilabel>Suvaline aeg</guilabel>, arvutatakse tähtaega vaikimisi kehtivast päevaalgusest.</para></note>

<para>Kui jätta kast märkimata, käivitatakse häire pärast käivitamisaja möödumist esimesel võimalusel alati sõltumata sellest, kui palju aega on möödunud.</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>
</listitem>

<listitem>
<para>Valiku <guilabel>Akna automaatne sulgemine pärast seda aega</guilabel> märkimisel suletakse häireaken automaatselt pärast määratud tähtaja möödumist.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title>Kordamine</title>

<para>Määramaks, kas häiret korratakse või mitte, tuleb kasutada kaarti <guilabel>Kordus</guilabel>.</para>

<note><para>Häire kordumise põhimalli näidatakse kaardi <guilabel>Kordus</guilabel> pealkirjas. Kaardil on esmalt näha kordamise intervall, seejärel aga võimalike alamkorduste intervall, mis on määratud nupuga <guibutton>Alamkordus</guibutton>.</para></note>

<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>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>Kordamise intervall</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äev</guilabel> ja sisesta kasti 14 või vali <guilabel>nädal</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äeval 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>

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

<para>Kui soovid teatud kuupäevad/ajad määratud kordamistest välja jätta, tee seda sektsioonis <guilabel>Erandid</guilabel>. Erandite (&ie; väljajä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>

<sect3>
<title>Alamkordus</title>

<para>Nuppu <guibutton>Alamkordus</guibutton> saab kasutada kordusesisese kordamise määramiseks. Sellisel juhul ei käivitata häireid ajal, mida määrab kaart Kordamine, mitte ühekordselt, vaid korduvalt vastavalt intervallile, mis on määratud nupuga Alamkordus. Kui näiteks soovid luua häiret, mis kordub igal neljapäeval lõunast kella kuueni õhtul, võid kaardil Kordamine määrata häire kordamise iga nädala neljapäeval kell 12:00 ning alamkorduse dialoogis määrata intervalli 1 tund ja kordamise arvuks 6 või kestvuseks 6 tundi.</para>

<para>Alamkorduse dialoogis, mille saab avada klõpsuga nupule <guibutton>Alamkordus</guibutton>, saab kastiga <guilabel>Kordumise intervall</guilabel> kordamise sisse või välja lülitada, Kui <guilabel>Kordumise intervall</guilabel> on märgitud, saab kordamise seadistada järgmiselt:</para>

<itemizedlist>
<listitem><para>Määra kordamistevaheline intervall kasti <guilabel>Kordumise intervall</guilabel> kõrval olevate elementidega. Vali vajalik ajaühik (&eg; <guilabel>päev</guilabel>) ja seejärel ühiku arv.</para>
</listitem>

<listitem><para>Määra kas kordamiste arv või kestvus:</para>

<itemizedlist>
<listitem><para><guilabel>Korduste arv</guilabel> võimaldab määrata, mitu korda häiret pärast peamist kordust käivitatakse. Kui näiteks soovid, et häiret käivitataks iga peakorduse puhul 4 korda, &ie; 3 lisakorda, sisesta siia 3.</para>
</listitem>

<listitem><para><guilabel>Kestus</guilabel> võimaldab määrata aja, mille jooksul häiret korratakse. See ei pea täpselt ühilduma kordamise intervalliga: kui klõpsad <guibutton>OK</guibutton>, ümardatakse seda vajaduse korral intervallile vastavaks.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<note><para>Ühe ja sama häire alamkorduste kattumise vältimiseks on alamkorduste kestus piiratud: see peab olema väiksem kui peakorduste pikim intervall. Iga kord, kui peakorduses määratud häire aktiveerub, katkestatakse automaatselt kõik häire eelmisest kordusest kehtima jäänud aktiivsed alamkordused.</para></note>

</sect3>
</sect2>

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

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

<para>Kasti <guilabel>Näidatakse &korganizer;is</guilabel> märkimisel lisatakse häire &korganizer;i aktiivsesse kalendrisse, kus seda näidatakse ilma häireta sündmusena. See võimaldab pidada häiretel silma peal &korganizer;i abil, sekkumata samas &kalarm;i tegevusse.</para>

<note><para>Kui hiljem muudad sellist häiret &kalarm;is või selle seal kustutad, muudetakse või kustutatakse vastav sündmus ka &korganizer;is. Kui aga muudad sündmust &korganizer;is, ei mõjuta see häiret &kalarm;is.</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ärkad. 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>Häireteate aknad jäävad nähtavale seni, kuni sa oled neile reageerinud, kui just pole märgitud valik <guilabel>Akna automaatne sulgemine pärast seda aega</guilabel> <link linkend="alarm-edit-dlg">häire redigeerimise dialoogis</link>. 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 vastavalt häire seadistustele järgmisi võimalusi:</para>

<itemizedlist>
<listitem>
<para>Häire nägemist saab kinnitada klõpsuga nupule <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>Häiret saab muuta klõpsuga nupule <guibutton>Muuda...</guibutton> See avab <link linkend="alarm-edit-dlg">häire redigeerimise dialoogi</link>.</para>
</listitem>

<listitem>
<para>Häire edasilükkamise võimalusi saab valida klõpsuga nupule <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>Aeg, millele häire edasi lükatakse, peab olema varasem kui häire järgmine kordumine või meeldetuletus. Seepärast ei saa nuppu <guibutton>Lükka edasi</guibutton> häireteate aknas ja nuppu <guibutton>OK</guibutton> edasilükkamise dialoogis kasutada, kui häire järgmise korduseni või meeldetuletuseni on jäänud vähem kui minut.</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.</para>
</listitem>

<listitem>
<para>Kui häireteade on loodud kirja &kmail;ist lohistades, saab kirja &kmail;is ka otsekohe näha klõpsuga &kmail;i ikooniga nupule. See valib kirja &kmail;is ja tõstab selle esile.</para>

<warning><para>&kmail;i indeksi regenereerimisel läheb link kirjale &kmail;is kaotsi.</para></warning>
</listitem>

<listitem>
<para>Nupp, millel on kujutatud <guiicon>&kalarm;</guiicon>i ikoon, pakub mugava võimaluse &kalarm; aktiveerida.</para>
</listitem>
</itemizedlist>

<para>Häireteate akent saab näidata kahel erineval moel vastavalt valitud seadistusele. Režiimi saab valida <link linkend="preferences-view">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 klaviatuuri fookus ei muutu 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 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-view">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älgimise. Seda saab kasutada ainult siis, kui häired ei ole parajasti sisse lülitatud.</action></para>
<para>Täpsemat infot leiab osast <link linkend="enable-disable">Häire lubamine ja keelamine</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenuitem>Keela häired</guimenuitem></menuchoice></term>
<listitem><para><action>Keelab häirete jälgimise. Seda saab kasutada ainult siis, kui häired on parajasti sisse lülitatud.</action></para>
<para>Täpsemat infot leiab osast <link linkend="enable-disable">Häire lubamine ja 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>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenuitem>Uus häire mallist</guimenuitem></menuchoice></term>
<listitem><para><action>Näitab alammenüüs häiremallide nimekirja. Neist mõnda valides avatakse häire redigeerimise dialoog, kus mallis antud väärtused on juba ette täidetud.</action></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>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-general">&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; või mõni muu sobiv 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-general">&kalarm;i seadistamine</link>).</para>

<para>&kalarm;i nägemiseks 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 süsteemses salves:</para>

<itemizedlist>
<listitem>
<para>vali menüükäsk <menuchoice><guimenu>Vaade</guimenu> <guimenuitem>Peida ikoon 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>

</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äirete lubamine ja keelamine</title>

<para>Häireid saab lubada ja keelata nii korraga kui ükshaaval:</para>

<itemizedlist>
<listitem>
<para><quote>Häirete jälgimine</quote> käib kõigi häirete kohta. Kui see on keelatud, ei kontrolli <application>häiredeemon</application> enam häireid ning seepärast neid ka enam ei käivitata. Kui häirete jälgimine on lubatud (vaikimisi ongi), käivitatakse ettenähtud ajal kõik häired, mida ei ole konkreetselt keelatud.</para>
</listitem>

<listitem>
<para>Sõltumata häirete jälgimise olekust saab häireid ka ükshaaval lubada või keelata. See tähendab, et konkreetsete häirete lubamise või keelamise olek ei muutu, kui häirete jälgimine keelata ning hiljem uuesti lubada. Kui häirete jälgimise võib lõpetada ka näiteks see, et &kalarm; või <application>häiredeemon</application> ei tööta, siis konkreetseid häireid saab keelata ainult menüükäskudega.</para>

<para>Iga häire olekut näitab selle värv häirete nimekirjas (värv saab muuta seadistustedialoogi kaardil <link linkend="preferences-fontcolour">Font ja värv</link>).</para>
</listitem>
</itemizedlist>

<para>Häire käivitamiseks peab see olema lubatud, samuti peab olema lubatud häirete jälgimine.</para>

<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 saab häired lubada järgmiselt:</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>

</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 &ndash; eeldusel, et <application>häiredeemon</application> on seadistatud käivituma sisselogimisel &ndash; sa uuesti sisse logid.</para>

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

<itemizedlist>
<listitem>
<para>vali menüükäsk <menuchoice><guimenu>Toimingud</guimenu> <guimenuitem>Keela häired</guimenuitem></menuchoice>.</para>
</listitem>

<listitem>
<para>klõpsa hiire <mousebutton>parema</mousebutton> nupuga ikoonil süsteemses salves ja vali menüüst <menuchoice><guimenuitem>Keela häired</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>

</sect2>

<sect2>
<title>Konkreetsete häirete lubamine ja keelamine</title>

<para>Konkreetsete häirete lubamiseks, mis on parajasti keelatud, talita järgmiselt:</para>

<itemizedlist>
<listitem>
<para>vali häire/häired klõpsuga selle/nende nimel nimekirjas. Seejärel vali menüükäsk <menuchoice> <guimenu>Toimingud</guimenu><guimenuitem>Luba</guimenuitem> </menuchoice>.</para>
</listitem>

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

<para>Konkreetsete häirete keelamiseks, mis on parajasti lubatud, talita järgmiselt:</para>

<itemizedlist>
<listitem>
<para>vali häire/häired klõpsuga selle/nende nimel nimekirjas. Seejärel vali menüükäsk <menuchoice> <guimenu>Toimingud</guimenu><guimenuitem>Keela</guimenuitem> </menuchoice>.</para>
</listitem>

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

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

<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>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>In this mode, if no system tray exists, &kalarm; runs
continuously in the background and alarms are always enabled.</para>
-->
</listitem>

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

<listitem><para><guilabel>Alarmide monitooringu käivitamine sisselogimisel</guilabel>: käivitab häirete jälgimise KDE-sse sisselogimisel, pannes tööle <application>häiredeemon</application>i. Pane tähele, et häirete aktiveerimiseks tuleb langetada vajalikud valikud ka sektsioonis <guilabel>Töörežiim</guilabel>.</para>

<warning><para>See valik peaks olema alati märgitud, kui sa just ei kavatse &kalarm;i kasutamisest loobuda.</para></warning>

<note><para>See valik lülitatakse alati automaatselt sisse, kui käivitad &kalarm;i. See tähendab, et kui oled selle valiku välja lülitanud ning soovid ka edaspidi vältida <application>häiredeemon</application>i töölepanekut sisselogimise ajal, tuleb see valik välja lülitada iga kord, kui käivitad &kalarm;i.</para></note>
</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. Pane tähele, et kustutatud häired salvestatakse ainult siis, kui neid on eelnevalt käivitatud. Kui kustutad häire enne selle käivitamist, kustutatakse see täielikult.</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>

<listitem><para><guilabel>Käsualarmide terminal</guilabel>: siin saab valida, millist terminali kasutatakse käsuhäirete jaoks, mis käivitatakse terminaliaknas. Mõned levinumad terminalirakendused on juba eelnevalt seadistatud, &eg; <application>xterm</application>, &konsole;, ehkki siin näidatakse ainult neid, mis on sinu süsteemi paigaldatud. Iga rakenduse korral kasutatavaid tegelikke käske näeb vastavate kirjete kontekstiabis.</para>

<para>Kui soovid kasutada mõnda muud rakendust või mõnda nimekirjas olevat teistsuguste võtmetega, vali <guilabel>Muu</guilabel> ning sisesta käsk, millega terminaliaken välja kutsutakse. Vaikimisi lisatakse häire käsustring sellele, mida sa siia sisestad. Sa võid küll ka ise määrata, kuhu häire käsustring lisatakse, kasutades järgmisi koode:</para>

<variablelist>
<varlistentry>
<term>%c</term>
<listitem>
<para>Häire käsustringi kohatäitja.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>%w</term>
<listitem>
<para>Häire käsustringi kohatäitja, millele lisatakse <literal>sleep</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>%C</term>
<listitem>
<para>Luuakse ajutine käsufail, mis sisaldab häire käsustringi, ning see asendab faili käivitamise käsku.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>%W</term>
<listitem>
<para>Luuakse ajutine käsufail, mis sisaldab häire käsustringi ja mille lisatakse <literal>sleep</literal>, ning see asendab faili käivitamise käsku.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Käsuhäire käivitamisel seatakse käsustring jutumärkidesse, enne kui lisatakse terminaliakna käsku.</para>
</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 &kmail;i vahendusel (mis vajaduse korral esmalt käivitatakse) järgmiselt:</para>

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

<listitem><para>kui &kmail; on vanema versiooniga, lisatakse kiri &kmail;i kausta <filename>väljuvad</filename>, kust selle saab hiljem ära saata.</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><guilabel>Koopia saadetud kirjadest jääb &kmail;i kausta 'saadetud'</guilabel>: selle valimisel salvestatakse iga kord, kui käivitatakse e-posti häire, saadetud kirja koopia &kmail;i kausta <filename>saadetud</filename>.</para>

<note><para>Seda valikut ei saa kasutada, kui e-posti kliendiks on valitud &kmail;, sest &kmail; teeb seda niigi automaatselt.</para></note>
</listitem>

<listitem>
<para>Vali oma e-posti aadress, mida kasutatakse e-posti häirete saatmisel saatja aadressina:</para>

<itemizedlist>
<listitem><para>Vali <guilabel>Kellelt</guilabel> e-posti aadressi sisestamiseks.</para>
</listitem>

<listitem><para>Vali <guilabel>Kasutatakse juhtimiskeskuses määratud aadressi</guilabel>, et tarvitada aadressi, mis on määratud kindlaks &kde; juhtimiskeskuses.</para>
</listitem>

<listitem><para>Vali <guilabel>Kasutatakse &kmail;i identiteete</guilabel>, mis võimaldab e-posti häire seadistamise ajal valida kasutatava &kmail;i identiteedi. Juba seadistatud häirete jaoks kasutatakse selle valiku valimisel &kmail;i vaikeidentiteeti.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Vali e-posti aadress, millega saata endale e-posti häiretest pimekoopia, kui valitud on <guilabel>Kiri saadetakse ka iseendale</guilabel>:</para>

<itemizedlist>
<listitem><para>Vali <guilabel>Bcc</guilabel> e-posti aadressi sisestamiseks. Kui pimekoopia saadetakse sinu kontole samas arvutis, kus töötab &kalarm;, võid siia sisestada ka lihtsalt oma kasutajanime.</para>
</listitem>

<listitem><para>Vali <guilabel>Kasutatakse juhtimiskeskuses määratud aadressi</guilabel>, et tarvitada aadressi, mis on määratud kindlaks &kde; juhtimiskeskuses.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para><guilabel>Märguanne kirja 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>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>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 keelatud häirete värvi nende näitamisel häirete nimekirjas.</para>
</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-dlg">häire redigeerimise dialoogi</link> vaikeväärtusi:</para>

<para>Näidatavate häirete korral:</para>

<itemizedlist>
<listitem><para>Valida vaikeväärtused võimalustele <guilabel>Tähtaja möödumisel häire katkestatakse</guilabel>, <guilabel>Akna automaatne sulgemine pärast seda aega</guilabel> ja <guilabel>Häire nägemise kinnituse küsimine</guilabel>.</para>
</listitem>

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

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

<listitem><para>Määrata vaikimisi helivalikud. Pane tähele, et vaikehelifaili saab määrata isegi siis, kui heli tüübiks ei ole valitud <guilabel>helifail</guilabel>.</para>
</listitem>
</itemizedlist>

<para>Käsuhäirete korral:</para>

<itemizedlist>
<listitem><para>Valida vaikeväärtused võimalustele <guilabel>Skripti sisestamine</guilabel> ja <guilabel>Käivitatakse terminaliaknas</guilabel>.</para>
</listitem>
</itemizedlist>

<para>E-posti häirete korral:</para>

<itemizedlist>
<listitem><para>Valida vaikeväärtuse võimalusele <guilabel>Kiri saadetakse ka iseendale</guilabel>.</para>
</listitem>
</itemizedlist>

<para>Kõigi häiretüüpide korral:</para>

<itemizedlist>
<listitem><para>Valida häirete kordumise vaiketüüp.</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>--auto-close</option></entry>
  <entry>Sulgeb automaatselt häireakna pärast aja möödumist, mille määrab <option>--late-cancel</option>. Selle võtme kasutamisel peab olema määratud ka võti <option>--late-cancel</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>--speak</option>, <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>-d</option>, <option>--disable</option></entry>
  <entry>Keelab häire. Seda ei käivitata enne, kui oled selle käsitsi lubanud.</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;i 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>-F</option>, <option>--from-id <replaceable>ID</replaceable></option></entry>
  <entry>Kirja saatjaks määratakse konkreetne &kmail;i identiteet. Selle kasutamisel peab kasutama ka võtit <option>--mail</option>.</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 arv, &eg; 3H30M. Muud perioodid määratakse vormingus <replaceable>nX</replaceable>, kus <replaceable>n</replaceable> on arv ja <replaceable>X</replaceable> üks järgmistest tähtedest: Y (aastad), M (kuud), W (nädalad), D (päevad). Kui määratud on ka võti <option>--recurrence</option>, ei saa kasutada Y (aastad) ja M (kuud). See võti on kohustuslik, kui kasutatakse võtmeid <option>--repeat</option> või <option>--until</option>.</entry>
</row>
<row>
  <entry><option>-k</option>, <option>--korganizer</option></entry>
  <entry>Näitab häiret sündmusena &korganizer;i aktiivses kalendris.</entry>
</row>
<row>
  <entry><option>-l</option>, <option>--late-cancel <replaceable>periood</replaceable></option></entry>
  <entry>Katkestab häire, kui seda ei saa pärast ettenähtud aega käivitada määratud <replaceable>periood</replaceable>i jooksul. See <replaceable>periood</replaceable> määratakse samasuguse süntaksiga, nagu võti <option>--reminder</option>. Vaikimisi on <replaceable>periood</replaceable> 1 minut.</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>, <option>--beep</option> ega <option>--speak</option>.</entry>
</row>
<row>
  <entry><option>-P</option>, <option>--play-repeat <replaceable>URL</replaceable></option></entry>
  <entry>Määrab häire näitamisel korduvalt mängitava helifaili nime või &URL;-i. Selle võtme kasutamisel ei saa kasutada võtit <option>--play</option>, <option>--beep</option> ega <option>--speak</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 <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html">RFC2445</ulink>), &eg; <quote>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote>. Sellega koos ei saa kasutada võtit <option>--until</option>.</entry>
</row>
<row>
  <entry><option>-r</option>, <option>--repeat <replaceable>kordade_arv</replaceable></option></entry>
  <entry>Määrab, mitu korda häiret käivitatakse või kui võtmega <option>--recurrence</option> on määratud kordumine, siis mitu korda häire käivitatakse alati, kui <option>--recurrence</option> selle aktiveerib (&ie; kordus korduse sees). Kui võtit <option>--recurrence</option> pole antud, määrab väärtus -1 häire lõputult korduma. Selle võtmega peab kasutama võtit <option>--interval</option>, kuid ei saa kasutada võtit <option>--until</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>, <option>--mail</option> või <option>--reminder-once</option>.</entry>
</row>
<row>
  <entry><option>--reminder-once <replaceable>periood</replaceable></option></entry>
  <entry>Määrab meeldetuletuse näitamise määratud ajal enne häire esimest kordumist. Häire järgmiste kordumiste ajal (kui neid on) meeldetuletust enam ei näidata. Seda võtit ei saa kasutada koos võtmetega <option>--exec</option>, <option>--mail</option> või <option>--reminder</option>.</entry>
</row>
<row>
  <entry><option>-s</option>, <option>--speak</option></entry>
  <entry>Kõneleb näidatava teate. Selleks peab olema paigaldatud ja seadistatud <application>KTTSD</application> ning sobiv kõnesüntesaator. Seda võtit ei saa kasutada koos võtmetega <option>--beep</option>, <option>--play</option> ja <option>--play-repeat</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äevaks vaikimisi käesolev kuupäev).</entry>
</row>
<row>
  <entry><option>-v</option>, <option>--volume <replaceable>protsent</replaceable></option></entry>
  <entry>Määrab audiofaili 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 kuupäeva või kuupäeva/kellaajani. Kuupäev ilma kellaajata 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, <link linkend="alarm-edit-dlg">häire redigeerimisdialoogi</link> avamiseks 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>--edit <replaceable>sündmuseID</replaceable></option></entry>
  <entry>Avab häire redigeerimisdialoogi määratud sündmuse ID-ga häire redigeerimiseks.</entry>
</row>
<row>
  <entry><option>-n</option>, <option>--edit-new</option></entry>
  <entry>Avab häire redigeerimise dialoogi uue häire redigeerimiseks.</entry>
</row>
<row>
  <entry><option>--edit-new-preset <replaceable>mallinimi</replaceable></option></entry>
  <entry>Avab häire redigeerimise dialoogi määratud nimega häiremalliga uue häire redigeerimiseks.</entry>
</row>
<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 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><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 <link linkend="preferences-general">seadistustedialoogis</link> ei ole automaatne käivitamine ära keelatud ja sa ei kasuta &kalarm;i) 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 või ainult võtmega <option>--tray</option>), lubada häired &kalarm;i süsteemse salve ikooni menüüst, lähtestada deemoni (seda kirjeldatakse <link linkend="daemon-reset">edaspidi</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.</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>

<para><application>Häiredeemon</application>i peatamiseks anna järgmine käsk:</para>

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

</sect1>
</chapter>

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

<para>&kalarm; pakub välja liidese, mis võimaldab muudel rakendustel esitada soovi 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>
<listitem><para>avada häire redigeerimise dialoog</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>

<para>Käsiraamatus kirjeldatud DCOP-väljakutsed on teostatud &kalarm;i DCOP-objektis <constant>request</constant>. Liides on defineeritud failis <filename>kalarmiface.h</filename>.</para>

<note><para>&kalarm;i versioonis 1.2 töötati DCOP-liides põhjalikult ümber, et võimaldada funktsioonide hõlpsamat väljakutsumist ning ühilduda paremini &kde; standardse DCOP-i seadistusega. Ühilduvuse nimel saab endiselt kasutada ka vana DCOP-liidest, kuid tulevikus see eemaldatakse.</para></note>

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

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

</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 katkestamise väärtus ja see on möödas, &ie; kui ajastatud käivitusaeg oli enam kui määratud katkestamise perioodi 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 QString&amp; <replaceable>dateTime</replaceable>,
                     int <replaceable>lateCancel</replaceable>,
                     int <replaceable>flags</replaceable>, 
                     const QString&amp; <replaceable>bgColor</replaceable>, 
                     const QString&amp; <replaceable>fgColor</replaceable>, 
                     const QString&amp; <replaceable>font</replaceable>, 
                     const KURL&amp; <replaceable>audioURL</replaceable>, 
                     int <replaceable>reminder</replaceable>, 
                     const QString&amp; <replaceable>recurrence</replaceable>,
                     int <replaceable>subRepeatInterval</replaceable>, 
                     int <replaceable>subRepeatCount</replaceable>)
</synopsis>
<synopsis>bool scheduleMessage(const QString&amp; <replaceable>message</replaceable>, 
                     const QString&amp; <replaceable>dateTime</replaceable>, 
                     int <replaceable>lateCancel</replaceable>, int <replaceable>flags</replaceable>, 
                     const QString&amp; <replaceable>bgColor</replaceable>, 
                     const QString&amp; <replaceable>fgColor</replaceable>, 
                     const QString&amp; <replaceable>font</replaceable>, 
                     const KURL&amp; <replaceable>audioURL</replaceable>, 
                     int <replaceable>reminder</replaceable>, 
                     int <replaceable>recurType</replaceable>, 
                     int <replaceable>recurInterval</replaceable>, 
                     int <replaceable>recurCount</replaceable>)
</synopsis>
<synopsis>bool scheduleMessage(const QString&amp; <replaceable>message</replaceable>, 
                     const QString&amp; <replaceable>dateTime</replaceable>, 
                     int <replaceable>lateCancel</replaceable>, 
                     int <replaceable>flags</replaceable>, 
                     const QString&amp; <replaceable>bgColor</replaceable>, 
                     const QString&amp; <replaceable>fgColor</replaceable>, 
                     const QString&amp; <replaceable>font</replaceable>, 
                     const KURL&amp; <replaceable>audioURL</replaceable>, 
                     int <replaceable>reminder</replaceable>, 
                     int <replaceable>recurType</replaceable>, 
                     int <replaceable>recurInterval</replaceable>, 
                     const QString&amp; <replaceable>endDateTime</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 või kuupäeva ja kellaaja, millal teadet näidatakse. Ainult kuupäevaga määratud häire puhul peab string olema kujul <quote>YYYY-MM-DD</quote> (nagu tagastab <methodname>QDate::toString(Qt::ISODate)</methodname>). Kuupäeva ja kellaajaga määratud häire korral peab string olema kujul <quote>YYYY-MM-DDTHH:MM[:SS]</quote> (nagu tagastab <methodname>QDateTime::toString(Qt::ISODate)</methodname>) või <quote>HH:MM[:SS]</quote> (nagu tagastab <methodname>QTime::toString(Qt::ISODate)</methodname>). Kui kuupäeva ei ole määratud, kasutatakse käesolevat kuupäeva. Pane tähele, et sekundeid ignoreeritakse.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>lateCancel</parameter></term>
<listitem>
<para>Annab korralduse häire katkestada, kui seda ei saa käivitada määratud arvu minutite jooksul pärast häire ettenähtud aega. Kui väärtus on 0, ei katkestata häiret sellele vaatamata, kui palju aega on ettenähtud ajast möödas.</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>kalarmiface.h</filename> klassiga <classname>KAlarmIface</classname>. Arvesta, et mitte kõiki lipubitte ei saa teatehäire korral kasutada.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>bgColor</parameter></term>
<listitem>
<para>Määrab näidatava teate taustavärvi. String võib olla kujul <quote>#RRGGBB</quote> (nagu tagastab <methodname>QColor::name()</methodname>), kus RR, GG ja BB on vastavalt punase, rohelise ja sinise kahekohalised kuueteistkümnendväärtused. String võib olla mõnel muul kujul, mida tunnustab <methodname>QColor::setNamedColor()</methodname>, näiteks X'i värvide andmebaasi nimi (&eg; <quote>red</quote> või <quote>steelblue</quote>). Kui string tühjaks jätta, kasutatakse parajasti vaikimisi kehtivat taustavärvi.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>fgColor</parameter></term>
<listitem>
<para>Määrab näidatava teate esiplaani värvi. Stringi kuju on samasugune parameetriga <parameter>bgColor</parameter>. Kui string tühjaks jätta, kasutatakse parajasti vaikimisi kehtivat esiplaani värvi.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>font</parameter></term>
<listitem>
<para>Määrab teate näitamisel kasutatava fondi. String peab olema kujul, nagu seda tunnustab <methodname>QFont::toString()</methodname>. Kui string tühjaks jätta, kasutatakse teate näitamisel ajal kehtivat vaikimisi teatefonti.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>audioURL</parameter></term>
<listitem>
<para>Määrab teate näitamisel mängitava helifaili. Väärtuse 0 andmisel helifaili ei esitata.</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 <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html">RFC2445</ulink>. Näiteks <quote>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote> määrab 4 kordust 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurType</parameter></term>
<listitem>
<para>Määrab häire kordumise tüübi. Lubatud väärtused on MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Need on defineeritud failis <filename>kalarmiface.h</filename> klassiga <classname>KAlarmIface</classname>. Igakuised kordumised on kuupäeva ja iga-aastased kordumised samuti kuupäeva tüüpi, kusjuures mõlemal juhul võetakse kuupäev parameetrist <parameter>dateTime</parameter>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurInterval</parameter></term>
<listitem>
<para>Määrab häire korduste vaheliste perioodide hulga (minutid/päevad/nädalad/kuud/aastad, nagu selle määrab <parameter>recurType</parameter>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurCount</parameter></term>
<listitem>
<para>Määrab, mitu korda häiret korrata. -1 tähendab häire lõputut kordamist.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>endDateTime</parameter></term>
<listitem>
<para>Määrab häire kordumise lõppkuupäeva või kuupäeva ja kellaaja. Kui <parameter>dateTime</parameter> sisaldab kellaaega, peab ka see parameeter sisaldama kellaaega; kui <parameter>dateTime</parameter> sisaldab ainult kuupäeva, peab ka see parameeter sisaldama ainult kuupäeva.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>subRepeatInterval</parameter></term>
<listitem>
<para>Määrab häire alamkorduste intervalli minutites. Väärtuse 0 korral lihtne alamkordused puuduvad. Kui kordamist pole määratud, seda eiratakse.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>subRepeatCount</parameter></term>
<listitem>
<para>Määrab häire alamkorduste arvu (kaasa arvatud esimene kordus).</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title>Kirjeldus</title>
<para><function>scheduleMessage()</function> on &DCOP;-väljakutse määratud häireteate ajastamiseks määratud kuupäevale ja ajale. Sel on kolm vormi. Kõige üldisem vorm lubab määrata suvalise kordumise ning seda saab kasutada ka mittekorduvate häirete korral. 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.</para>

<para>Kui määratud aeg (sealhulgas ka korduste aeg) on juba möödas, näitab &kalarm; teadet otsekohe (kui just <parameter>lateCancel</parameter> väärtus ei anna teada, et häiret on juba liiga hilja näidata, millisel juhul &kalarm; ignoreerib soovi. Kui tähtaeg (või korduse tähtaeg) seisab veel ees, lisab &kalarm; häireteate kalendrifaili, et seda hiljem näidata.</para>
</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 KURL&amp; <replaceable>URL</replaceable>,
                  const QString&amp; <replaceable>dateTime</replaceable>,
                  int <replaceable>lateCancel</replaceable>,
                  int <replaceable>flags</replaceable>,
                  const QString&amp; <replaceable>bgColor</replaceable>,
                  const KURL&amp; <replaceable>audioURL</replaceable>,
                  int <replaceable>reminder</replaceable>,
                  const QString&amp; <replaceable>recurrence</replaceable>,
                  int <replaceable>subRepeatInterval</replaceable>, 
                  int <replaceable>subRepeatCount</replaceable>)
</synopsis>
<synopsis>bool scheduleFile(const KURL&amp; <replaceable>URL</replaceable>,
                  const QString&amp; <replaceable>dateTime</replaceable>,
                  int <replaceable>lateCancel</replaceable>,
                  int <replaceable>flags</replaceable>,
                  const QString&amp; <replaceable>bgColor</replaceable>,
                  const KURL&amp; <replaceable>audioURL</replaceable>,
                  int <replaceable>reminder</replaceable>,
                  int <replaceable>recurType</replaceable>,
                  int <replaceable>recurInterval</replaceable>,
                  int <replaceable>recurCount</replaceable>)
</synopsis>
<synopsis>bool scheduleFile(const KURL&amp; <replaceable>URL</replaceable>,
                  const QString&amp; <replaceable>dateTime</replaceable>,
                  int <replaceable>lateCancel</replaceable>,
                  int <replaceable>flags</replaceable>,
                  const QString&amp; <replaceable>bgColor</replaceable>,
                  const KURL&amp; <replaceable>audioURL</replaceable>,
                  int <replaceable>reminder</replaceable>,
                  int <replaceable>recurType</replaceable>,
                  int <replaceable>recurInterval</replaceable>,
                  const QString&amp; <replaceable>endDateTime</replaceable>)
</synopsis>

<refsect2>
<title>Parameetrid</title>
<variablelist>
<varlistentry>
<term><parameter>URL</parameter></term>
<listitem>
<para>Määrab teksti- või pildifaili, mille sisu näidatakse ajastatavas häireteates.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>dateTime</parameter></term>
<listitem>
<para>Määrab kuupäeva või kuupäeva ja kellaaja, millal faili näidatakse. Ainult kuupäevaga määratud häire puhul peab string olema kujul <quote>YYYY-MM-DD</quote> (nagu tagastab <methodname>QDate::toString(Qt::ISODate)</methodname>). Kuupäeva ja kellaajaga määratud häire korral peab string olema kujul <quote>YYYY-MM-DDTHH:MM[:SS]</quote> (nagu tagastab <methodname>QDateTime::toString(Qt::ISODate)</methodname>) või <quote>HH:MM[:SS]</quote> (nagu tagastab <methodname>QTime::toString(Qt::ISODate)</methodname>). Kui kuupäeva ei ole määratud, kasutatakse käesolevat kuupäeva. Pane tähele, et sekundeid ignoreeritakse.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>lateCancel</parameter></term>
<listitem>
<para>Annab korralduse häire katkestada, kui seda ei saa käivitada määratud arvu minutite jooksul pärast häire ettenähtud aega. Kui väärtus on 0, ei katkestata häiret sellele vaatamata, kui palju aega on ettenähtud ajast möödas.</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>kalarmiface.h</filename> klassiga <classname>KAlarmIface</classname>. Arvesta, et mitte kõiki lipubitte ei saa failihäire korral kasutada.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>bgColor</parameter></term>
<listitem>
<para>Määrab näidatava faili taustavärvi. String võib olla kujul <quote>#RRGGBB</quote> (nagu tagastab <methodname>QColor::name()</methodname>), kus RR, GG ja BB on vastavalt punase, rohelise ja sinise kahekohalised kuueteistkümnendväärtused. String võib olla mõnel muul kujul, mida tunnustab <methodname>QColor::setNamedColor()</methodname>, näiteks X'i värvide andmebaasi nimi (&eg; <quote>red</quote> või <quote>steelblue</quote>). Kui string tühjaks jätta, kasutatakse parajasti vaikimisi kehtivat taustavärvi.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>audioURL</parameter></term>
<listitem>
<para>Määrab teate näitamisel mängitava helifaili. Väärtuse 0 andmisel helifaili ei esitata.</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 <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html">RFC2445</ulink>. Näiteks <quote>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote> määrab 4 kordust 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurType</parameter></term>
<listitem>
<para>Määrab häire kordumise tüübi. Lubatud väärtused on MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Need on defineeritud failis <filename>kalarmiface.h</filename> klassiga <classname>KAlarmIface</classname>. Igakuised kordumised on kuupäeva ja iga-aastased kordumised samuti kuupäeva tüüpi, kusjuures mõlemal juhul võetakse kuupäev parameetrist <parameter>dateTime</parameter>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurInterval</parameter></term>
<listitem>
<para>Määrab häire korduste vaheliste perioodide hulga (minutid/päevad/nädalad/kuud/aastad, nagu selle määrab <parameter>recurType</parameter>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurCount</parameter></term>
<listitem>
<para>Määrab, mitu korda häiret korrata. -1 tähendab häire lõputut kordamist.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>endDateTime</parameter></term>
<listitem>
<para>Määrab häire kordumise lõppkuupäeva või kuupäeva ja kellaaja. Kui <parameter>dateTime</parameter> sisaldab kellaaega, peab ka see parameeter sisaldama kellaaega; kui <parameter>dateTime</parameter> sisaldab ainult kuupäeva, peab ka see parameeter sisaldama ainult kuupäeva.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>subRepeatInterval</parameter></term>
<listitem>
<para>Määrab häire alamkorduste intervalli minutites. Väärtuse 0 korral lihtne alamkordused puuduvad. Kui kordamist pole määratud, seda eiratakse.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>subRepeatCount</parameter></term>
<listitem>
<para>Määrab häire alamkorduste arvu (kaasa arvatud esimene kordus).</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 ning esiplaani värvi ja fondi 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 QString&amp; <replaceable>dateTime</replaceable>,
                     int <replaceable>lateCancel</replaceable>,
                     int <replaceable>flags</replaceable>,
                     const QString&amp; <replaceable>recurrence</replaceable>,
                     int <replaceable>subRepeatInterval</replaceable>, 
                     int <replaceable>subRepeatCount</replaceable>)
</synopsis>
<synopsis>bool scheduleCommand(const QString&amp; <replaceable>commandLine</replaceable>,
                     const QString&amp; <replaceable>dateTime</replaceable>,
                     int <replaceable>lateCancel</replaceable>,
                     int <replaceable>flags</replaceable>,
                     int <replaceable>recurType</replaceable>,
                     int <replaceable>recurInterval</replaceable>,
                     int <replaceable>recurCount</replaceable>)
</synopsis>
<synopsis>bool scheduleCommand(const QString&amp; <replaceable>commandLine</replaceable>,
                     const QString&amp; <replaceable>dateTime</replaceable>,
                     int <replaceable>lateCancel</replaceable>,
                     int <replaceable>flags</replaceable>,
                     int <replaceable>recurType</replaceable>,
                     int <replaceable>recurInterval</replaceable>,
                     const QString&amp; <replaceable>endDateTime</replaceable>)
</synopsis>

<refsect2>
<title>Parameetrid</title>
<variablelist>
<varlistentry>
<term><parameter>commandLine</parameter></term>
<listitem>
<para>Määrab käivitatava käsu. Parameeter <parameter>flags</parameter> osutab, kas parameeter sisaldab shellikäsku või skripti.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>dateTime</parameter></term>
<listitem>
<para>Määrab kuupäeva või kuupäeva ja kellaaja, millal käsk käivitatakse. Ainult kuupäevaga määratud häire puhul peab string olema kujul <quote>YYYY-MM-DD</quote> (nagu tagastab <methodname>QDate::toString(Qt::ISODate)</methodname>). Kuupäeva ja kellaajaga määratud häire korral peab string olema kujul <quote>YYYY-MM-DDTHH:MM[:SS]</quote> (nagu tagastab <methodname>QDateTime::toString(Qt::ISODate)</methodname>) või <quote>HH:MM[:SS]</quote> (nagu tagastab <methodname>QTime::toString(Qt::ISODate)</methodname>). Kui kuupäeva ei ole määratud, kasutatakse käesolevat kuupäeva. Pane tähele, et sekundeid ignoreeritakse.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>lateCancel</parameter></term>
<listitem>
<para>Annab korralduse häire katkestada, kui seda ei saa käivitada määratud arvu minutite jooksul pärast häire ettenähtud aega. Kui väärtus on 0, ei katkestata häiret sellele vaatamata, kui palju aega on ettenähtud ajast möödas.</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>kalarmiface.h</filename> klassiga <classname>KAlarmIface</classname>. Arvesta, et mitte kõiki lipubitte ei saa käsuhäire korral kasutada.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurrence</parameter></term>
<listitem>
<para>Määrab häire regulaarse kordumise iCalendari süntaksis, nagu selle defineerib <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html">RFC2445</ulink>. Näiteks <quote>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote> määrab 4 kordust 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurType</parameter></term>
<listitem>
<para>Määrab häire kordumise tüübi. Lubatud väärtused on MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Need on defineeritud failis <filename>kalarmiface.h</filename> klassiga <classname>KAlarmIface</classname>. Igakuised kordumised on kuupäeva ja iga-aastased kordumised samuti kuupäeva tüüpi, kusjuures mõlemal juhul võetakse kuupäev parameetrist <parameter>dateTime</parameter>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurInterval</parameter></term>
<listitem>
<para>Määrab häire korduste vaheliste perioodide hulga (minutid/päevad/nädalad/kuud/aastad, nagu selle määrab <parameter>recurType</parameter>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurCount</parameter></term>
<listitem>
<para>Määrab, mitu korda häiret korrata. -1 tähendab häire lõputut kordamist.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>endDateTime</parameter></term>
<listitem>
<para>Määrab häire kordumise lõppkuupäeva või kuupäeva ja kellaaja. Kui <parameter>dateTime</parameter> sisaldab kellaaega, peab ka see parameeter sisaldama kellaaega; kui <parameter>dateTime</parameter> sisaldab ainult kuupäeva, peab ka see parameeter sisaldama ainult kuupäeva.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>subRepeatInterval</parameter></term>
<listitem>
<para>Määrab häire alamkorduste intervalli minutites. Väärtuse 0 korral lihtne alamkordused puuduvad. Kui kordamist pole määratud, seda eiratakse.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>subRepeatCount</parameter></term>
<listitem>
<para>Määrab häire alamkorduste arvu (kaasa arvatud esimene kordus).</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 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>fromID</replaceable>,
                   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 QString&amp; <replaceable>dateTime</replaceable>,
                   int <replaceable>lateCancel</replaceable>,
                   int <replaceable>flags</replaceable>,
                   const QString&amp; <replaceable>recurrence</replaceable>,
                   int <replaceable>subRepeatInterval</replaceable>, 
                   int <replaceable>subRepeatCount</replaceable>)
</synopsis>
<synopsis>bool scheduleEmail(const QString&amp; <replaceable>fromID</replaceable>,
                   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 QString&amp; <replaceable>dateTime</replaceable>,
                   int <replaceable>lateCancel</replaceable>,
                   int <replaceable>flags</replaceable>,
                   int <replaceable>recurType</replaceable>,
                   int <replaceable>recurInterval</replaceable>,
                   int <replaceable>recurCount</replaceable>)
</synopsis>
<synopsis>bool scheduleEmail(const QString&amp; <replaceable>fromID</replaceable>,
                   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 QString&amp; <replaceable>dateTime</replaceable>,
                   int <replaceable>lateCancel</replaceable>, 
                   nt <replaceable>flags</replaceable>,
                   int <replaceable>recurType</replaceable>,
                   int <replaceable>recurInterval</replaceable>,
                   const QString&amp; <replaceable>endTime</replaceable>)
</synopsis>

<refsect2>
<title>Parameetrid</title>
<variablelist>
<varlistentry>
<term><parameter>fromID</parameter></term>
<listitem>
<para>&kmail;i identiteet, mida kasutatakse kirja saatja määramiseks. Kui see on andmata, kasutatakse saatja aadressina aadressi, mis on määratud &kalarm;i <link linkend="preferences-email">e-posti seadistustes</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>addresses</parameter></term>
<listitem>
<para>Komadega eraldatud saajate e-posti aadresside nimekiri.</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>Komadega eraldatud failide asukohtade võu &URL;-ide nimekiri, mis kaastakse kirjale.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>dateTime</parameter></term>
<listitem>
<para>Määrab kuupäeva või kuupäeva ja kellaaja, millal kiri saadetakse. Ainult kuupäevaga määratud häire puhul peab string olema kujul <quote>YYYY-MM-DD</quote> (nagu tagastab <methodname>QDate::toString(Qt::ISODate)</methodname>). Kuupäeva ja kellaajaga määratud häire korral peab string olema kujul <quote>YYYY-MM-DDTHH:MM[:SS]</quote> (nagu tagastab <methodname>QDateTime::toString(Qt::ISODate)</methodname>) või <quote>HH:MM[:SS]</quote> (nagu tagastab <methodname>QTime::toString(Qt::ISODate)</methodname>). Kui kuupäeva ei ole määratud, kasutatakse käesolevat kuupäeva. Pane tähele, et sekundeid ignoreeritakse.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>lateCancel</parameter></term>
<listitem>
<para>Annab korralduse häire katkestada, kui seda ei saa käivitada määratud arvu minutite jooksul pärast häire ettenähtud aega. Kui väärtus on 0, ei katkestata häiret sellele vaatamata, kui palju aega on ettenähtud ajast möödas.</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>kalarmiface.h</filename> klassiga <classname>KAlarmIface</classname>. Arvesta, et mitte kõiki lipubitte ei saa e-posti häire korral kasutada.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurrence</parameter></term>
<listitem>
<para>Määrab häire regulaarse kordumise iCalendari süntaksis, nagu selle defineerib <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html">RFC2445</ulink>. Näiteks <quote>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote> määrab 4 kordust 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurType</parameter></term>
<listitem>
<para>Määrab häire kordumise tüübi. Lubatud väärtused on MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Need on defineeritud failis <filename>kalarmiface.h</filename> klassiga <classname>KAlarmIface</classname>. Igakuised kordumised on kuupäeva ja iga-aastased kordumised samuti kuupäeva tüüpi, kusjuures mõlemal juhul võetakse kuupäev parameetrist <parameter>dateTime</parameter>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurInterval</parameter></term>
<listitem>
<para>Määrab häire korduste vaheliste perioodide hulga (minutid/päevad/nädalad/kuud/aastad, nagu selle määrab <parameter>recurType</parameter>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>recurCount</parameter></term>
<listitem>
<para>Määrab, mitu korda häiret korrata. -1 tähendab häire lõputut kordamist.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>endDateTime</parameter></term>
<listitem>
<para>Määrab häire kordumise lõppkuupäeva või kuupäeva ja kellaaja. Kui <parameter>dateTime</parameter> sisaldab kellaaega, peab ka see parameeter sisaldama kellaaega; kui <parameter>dateTime</parameter> sisaldab ainult kuupäeva, peab ka see parameeter sisaldama ainult kuupäeva.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>subRepeatInterval</parameter></term>
<listitem>
<para>Määrab häire alamkorduste intervalli minutites. Väärtuse 0 korral lihtne alamkordused puuduvad. Kui kordamist pole määratud, seda eiratakse.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><parameter>subRepeatCount</parameter></term>
<listitem>
<para>Määrab häire alamkorduste arvu (kaasa arvatud esimene kordus).</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 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="dcop_edit">
<refmeta>
<refentrytitle>edit</refentrytitle>
</refmeta>
<refnamediv>
<refname>edit</refname>
<refpurpose>See avab <link linkend="alarm-edit-dlg">häire redigeerimise dialoogi</link>.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>bool edit(const QString&amp; <replaceable>sündmuseID</replaceable>)
</synopsis>

<refsect2>
<title>Parameetrid</title>
<variablelist>
<varlistentry>
<term><parameter>eventID</parameter></term>
<listitem>
<para>Määrab redigeeritava sündmuse unikaalse ID.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title>Tagastatav väärtus</title>
<para><returnvalue>false</returnvalue>, kui määratud häiret ei leita või kui see ei ole redigeeritav, muul juhul <returnvalue>true</returnvalue>.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title>Kirjeldus</title>

<para><function>edit()</function> on &DCOP;-väljakutse, mis avab <link linkend="alarm-edit-dlg">häire redigeerimise dialoogi</link> määratud häire redigeerimiseks.</para>

</refsect1>
</refentry>

<refentry id="dcop_editnew">
<refmeta>
<refentrytitle>editNew</refentrytitle>
</refmeta>
<refnamediv>
<refname>editNew</refname>
<refpurpose>See avab <link linkend="alarm-edit-dlg">häire redigeerimise dialoogi</link> uue häire redigeerimiseks.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>bool editNew(const QString&amp; <replaceable>mallinimi</replaceable>)
</synopsis>

<refsect2>
<title>Parameetrid</title>
<variablelist>
<varlistentry>
<term><parameter>mallinimi</parameter></term>
<listitem>
<para>Määrab häiremalli nime, millele uus häire tugineb, või puudub, kui malli ei kasutata.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title>Tagastatav väärtus</title>
<para><returnvalue>false</returnvalue>, kui <parameter>mallinimi</parameter> on antud, aga sellise nimega malli ei leita, muul juhul <returnvalue>true</returnvalue>.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title>Kirjeldus</title>

<para><function>editNew()</function> on &DCOP;-väljakutse, mis avab <link linkend="alarm-edit-dlg">häire redigeerimise dialoogi</link> uue häire redigeerimiseks. Kui parameetrina anda häiremalli nimi, täidetakse dialoog ette malli andmetega. Kui määratud malli ei leita, avatakse küll <link linkend="alarm-edit-dlg">häire redigeerimise dialoog</link>, aga mõistagi ei ole selles siis midagi ette antud.</para>

</refsect1>
</refentry>

</sect1>

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

<para>Käsurea võtmeid pakutakse võimaldamaks 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 häire.</entry>
</row>
<row>
  <entry><option>--triggerEvent <replaceable>eventID</replaceable></option></entry>
  <entry>Käivitab määratud sündmuse ID-ga häire. 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 häire. &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>$TDEHOME/share/config/kalarmrc</filename>.</para>

<para>Ajastatud häireid sisaldav kalendrifail on <filename>$TDEHOME/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>

<para>Aegunud häireid sisaldav kalendrifail on <filename>$TDEHOME/share/apps/kalarm/expired.ics</filename>, kui seadistustefailis ei ole just määratud mõnda muud kalendrifaili (kirje <parameter>ExpiredCalendar</parameter> sektsioonis <parameter>General</parameter>).</para>

<para>Häiremalle sisaldav kalendrifail on <filename>$TDEHOME/share/apps/kalarm/template.ics</filename>, kui seadistustefailis ei ole just määratud mõnda muud kalendrifaili (kirje <parameter>TemplateCalendar</parameter> sektsioonis <parameter>General</parameter>).</para>

<para>Parajasti näidatavate häirete üksikasju sisaldab kalendrifail <filename>$TDEHOME/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>$TDEHOME/share/config/kalarmdrc</filename>, samas leiab ka &kalarm;i klientrakenduse üksikasjad.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>Millises vormingus häired salvestatakse?</para>
</question>
<answer>
<para>Kalendrifailid, milles &kalarm; salvestab häired, on tekstifailid, mille vormingu määrab kindlaks dokument <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html">RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar)</ulink>. See on standardvorming, mida kasutavad kõik mooduli tdepim rakendused. &kalarm; kasutab teatud mittestandardseid omadusi komponendis Alarm, mis vastavad küll RFC2445 nõuetele: <literal>X-TDE-KALARM-NEXTRECUR</literal>, <literal>X-TDE-KALARM-REPEAT</literal>, <literal>X-TDE-KALARM-TYPE</literal>, <literal>X-TDE-KALARM-NEXTREPEAT</literal>, <literal>X-TDE-KALARM-FONTCOLOR</literal>, <literal>X-TDE-KALARM-VOLUME</literal>, <literal>X-TDE-KALARM-SPEAK</literal>, <literal>X-TDE-KALARM-EMAILID</literal>.</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>.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title>Autorid ja litsents</title>

<para>&kalarm; </para>
<para>Rakenduse autoriõigus 2001, 2002, 2003, 2004, 2005, 2006, 2007: David Jarvie <email>&David.Jarvie.mail;</email> </para>
<para>Häiredeemoni autorid: <itemizedlist>
<listitem><para>Preston Brown <email>pbrown@kde.org</email></para>
</listitem>
<listitem><para>David Jarvie <email>&David.Jarvie.mail;</email></para>
</listitem>
<listitem><para>Cornelius Schumacher <email>schumacher@kde.org</email></para>
</listitem>
</itemizedlist>
</para>

<para>Dokumentatsiooni autoriõigus 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008: David Jarvie <email>&David.Jarvie.mail;</email> </para>

<para>Tõlge eesti keelde: Marek Laane <email>bald@starman.ee</email></para> 
&underFDL; &underGPL; <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>

</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/kalarm">http://www.astrojar.org.uk/kalarm</ulink>. </para>

</sect1>

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

<para>&kalarm; nõuab &kde; standardsete teekide olemasolu (pakett <filename>tdelibs</filename>). Lähtekoodi kompileerimiseks on vajalikud ka &Qt; ja <filename>tdelibs</filename> arenduspaketid. Olemasolu korral saab X11 arenduspaketti kasutada &kalarm;i paremaks toimimiseks &kde;s süsteemse salve puudumisel.</para>

<para>Järgmised lisapaketid pakuvad paigaldamise korral &kalarm;ile lisavõimalusi:</para>

<itemizedlist>
<listitem><para>&kmix; (moodulis tdemultimedia): kui see on paigaldatud, saab &kalarm;is määrata audiofailide esitamisel kasutatava absoluutse helitugevuse.</para>
</listitem>

<listitem><para><application>KTTSD</application> (moodulis tdeaccessibility): kui see on paigaldatud ja seadistatud ning süsteemis on ka sobiv kõnesüntesaator, saab &kalarm;il lasta näidatavaid häireteateid ka kõnelda.</para>
</listitem>
</itemizedlist>

<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/kalarm">http://www.astrojar.org.uk/kalarm</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>tdepim-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>

<warning><para>Kui paigaldad &kalarm;i mõnda muusse kataloogi kui see, kuhu on paigaldatud &kde;, ei tööta rakendus korrektselt, kui sa ei anna selle asukohta &kde;-le teada. Selleks tuleb lisada keskkonnamuutujale <envar>TDEDIRS</envar> iga kord enne &kde; käivitamist &kalarm;i asukoht.</para>

<para>Kui näiteks &kde; on paigaldatud asukohta <literal>/opt/kde</literal>, on <envar>TDEDIRS</envar> tavaliselt <literal>/etc/opt/kde:/opt/kde</literal>. Kui paigaldad &kalarm;i asukohta <literal>/usr/local</literal>, tuleb määrata <envar>TDEDIRS</envar> väärtuseks <literal>/usr/local:/etc/opt/kde:/opt/kde</literal>, enne kui &kde; käivitada.</para></warning>

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

<para>Pane tähele, et see võti ei mõjuta seda, millises keeles kasutajaliidese tõlked on paigaldatud.</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>