summaryrefslogtreecommitdiffstats
path: root/doc/kicker/index.docbook
blob: 1692f8d8d1577a7a1d03572526249cfa2dcb79a7 (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
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY package "tdebase">
  <!ENTITY kappname "&kicker;">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>

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

<book lang="&language;">

<bookinfo>
<title>The &kicker; Handbook</title>

<authorgroup>
<author>&Orville.Bennett; &Orville.Bennett.mail;</author>
<author>&Dirk.Doerflinger; &Dirk.Doerflinger.mail;</author>
<author>&tde-authors;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<date>Reviewed: &tde-release-date;</date>
<releaseinfo>&tde-release-version;</releaseinfo>

<copyright>
<year>2001</year><year>2002</year>
<holder>&Dirk.Doerflinger;</holder>
</copyright>
<copyright>
<year>2004</year>
<holder>&Orville.Bennett;</holder>
</copyright>
<copyright>
<year>2005</year>
<holder>Titus Laska</holder>
</copyright>
<copyright>
<year>&tde-copyright-date;</year>
<holder>&tde-team;</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<abstract>
<para>
&kicker; is the &tde; application starter panel and is also capable of
some useful applets and extensions. It usually resides on the bottom of
the desktop.
</para>
</abstract>

<keywordset>
<keyword>TDE</keyword>
<keyword>Kicker</keyword>
<keyword>tdebase</keyword>
<keyword>panel</keyword>
<keyword>application</keyword>
<keyword>starter</keyword>
</keywordset>

</bookinfo>

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

<para>
&kicker; is the application launcher panel of the Trinity Desktop Environment.
Besides the <guimenu>TDE</guimenu> Menu, where you can start applications,
&kicker; is also capable of running docked applets like the pager, the
taskbar or the clock, and extensions, such as child panels.
</para>

<para>
&kicker; usually resides on the bottom of the desktop, but it can also
be moved to any other border.
</para>

<para>The panel gives you quick access to applications and makes it
easier for you to organize your desktop. Using the &tde; panel you
can:</para>

<itemizedlist>

<listitem><para>Launch applications using the <guimenu>TDE</guimenu> menu or
the application buttons.</para></listitem>
<listitem><para>Switch desktops using the panel's pager applet.</para>
</listitem>
<listitem><para>Switch active windows, and minimize or maximize them.</para>
</listitem>
<listitem><para>Browse folder using the browser menu functionality.</para>
</listitem>
<listitem><para>Access panel applets that extend the panel's functionality,
offering for example mixers, clocks or a system monitor.</para> </listitem>

</itemizedlist>

<para>Please report any problems or feature requests to the &tde; mailing lists.</para>

</chapter>

<chapter id="using-kicker">
<title>Using &kicker;</title>

<para>
This is what you see on a freshly installed &tde;, assuming that you
skipped <application>KPersonalizer</application>. If you are using
lower resolution, some of the icons may not appear immediately. To
cater for those smaller resolutions, the screenshot below is divided
in two parts.
</para>

<screenshot>
<screeninfo>Here is a screenshot of the left side of &kicker;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="screenshot_left.png" format="PNG"/></imageobject>
<textobject>
<phrase>Screenshot Left</phrase>
</textobject>
<caption>
<para>
This is a screenshot of the left side of &kicker;
</para>
</caption>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo>And here is the right side</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="screenshot_right.png" format="PNG"/></imageobject>
<textobject>
<phrase>Screenshot Right</phrase>
</textobject>
<caption>
<para>
This is the right side of &kicker;
</para>
</caption>
</mediaobject>
</screenshot>

<para>
Of course, this is only one way &kicker; might appear on the
screen. There are many more configurations available.
</para>

<sect1 id="newbie">
<title>A quick tour for new &tde; users</title>

<para>
If you are experienced with this kind of application launcher, you can
ignore this chapter and move on to <link linkend="basics">&kicker;
basics</link>.
</para>

<para>
The main use of &kicker; is starting applications. This is
done by clicking icons, either from the panel or from the
<guimenu>TDE</guimenu> Menu. &kicker; shows some more things too, so let's
see.
</para>

<para>
Having a look at the screenshots above, there are from left to right:
</para>

<variablelist>

<varlistentry>
<term>The <guimenu>TDE</guimenu> Menu</term>
<listitem>
<para>
It is used for launching applications and some other useful
things. Refer to <link linkend="tde-menu">The <guimenu>TDE</guimenu> Menu
</link>for more information.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Application start icons</term>
<listitem>
<para>
Here are some icons of commonly used applications. They can be moved and
removed and others can be added. Some of them have a special meaning,
which you can read more about in <link linkend="basics">&kicker;
basics</link>. Resting the mouse over an icon without clicking shows the
name and a short description of that application, if you have set that in
the <link linkend="configuring">Settings Dialog</link>.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>The Pager applet</term>
<listitem>
<para>
This displays a small view of the virtual desktops. Clicking one section
of it will activate that desktop. Please refer to <link
linkend="applets">Applets</link>.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>The Taskbar</term>
<listitem>
<para>
All running applications are displayed as buttons in the
taskbar. Clicking an application's button will bring this application on
top. If it was on top before, it will be iconified. More
information is available in the <link linkend="applets">Applets</link>
section.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>System Tray</term>
<listitem>
<para>
The system tray is able to swallow some kind of applications like - in
this case - &klipper; and the &korganizer; Reminder Daemon. There are
many other applications that dock in the system tray, for example &juk;
and &kopete;. Clicking the icons with the
<mousebutton>left</mousebutton> or the <mousebutton>right</mousebutton>
mousebutton performs specific actions defined for each
application.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Clock</term>
<listitem>
<para>
The Clock applet is - of course - a small, useful clock. It can have
various styles, have a look at the <link
linkend="applets">applets</link> section for more information.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>The <guibutton>Hide panel</guibutton> button</term>
<listitem>
<para>
This button lets you fade out &kicker; for having more space on the
screen. When &kicker; is faded out, only the <guibutton>Hide panel</guibutton> button
will remain in order to fade in &kicker; again.
</para>
</listitem>
</varlistentry>
</variablelist>

<para>
This was only the description of &kicker; on its initial launch. It can
be configured in many ways and styles and more applets can be
added. There are even some extensions like the external taskbar you can
add. See <link linkend="basics">&kicker; basics</link>, <link
linkend="applets">Applets </link> and <link
linkend="extensions">Extensions </link>for more information.
</para>

</sect1>

</chapter>

<chapter id="basics">

<title>&kicker; basics</title>

<sect1 id="general-usage">
<title>General usage</title>

<para>
As mentioned before, there are a lot of things that can be added to
&kicker;. This section will tell you everything about application
starting, folder browsing and adding some kinds of applets and
extensions. Lots of things can be done from the context
menu with <guimenuitem>Configure Panel...</guimenuitem> or via the &kcontrolcenter;'s
 section <menuchoice><guimenu>Desktop</guimenu> <guisubmenu>Panels</guisubmenu></menuchoice>.
</para>

<sect2 id="adding-apps">
<title>Adding applications</title>

<para>
There are three different ways to add an application to &kicker;:
</para>

<variablelist>
<varlistentry>
<term>Drag and Drop</term>
<listitem>
<para>
Simply drag any file from &konqueror; into &kicker; and it's there. Dragging
also works from the <guimenu>TDE</guimenu> Menu with any entry. You can
change the attributes like optional command line parameters or the icon
by clicking it with the &RMB; and choosing <guimenuitem>Configure 
<replaceable>applicationname</replaceable> Button...</guimenuitem> from the
context menu.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Using the context menu to add a &tde; application</term>
<listitem>
<para>
Click the &RMB; on any free space
in &kicker; and choose <guisubmenu>Add Application to Panel</guisubmenu>.
There you can choose an application
which will then be added to &kicker;.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Using the context menu to add a
non-&tde;-application</term>
<listitem>
<para>
Non-&tde;-applications &eg;
<application>xosview</application> or <application>xemacs</application>.
</para>

<para>
Click the &RMB; on any free space
in &kicker; and choose <guisubmenu>Add Application to
Panel</guisubmenu> and then <guimenuitem>Add Non-TDE
Application</guimenuitem>. In the newly appearing window, enter <guilabel>Button title</guilabel> 
and a <guilabel>Description</guilabel> of the application in the first two text boxes. Then fill 
in the command of the application you
wish to add in the <guilabel>Executable:</guilabel> text box. You can
also append command line arguments, have
the application start from a terminal, and choose the icon which will
appear in &kicker; by clicking the <guiicon>gear</guiicon>. If you don't
choose an icon, the application will use the gear as a default.
</para>
</listitem>
</varlistentry>
</variablelist>

<para>
Applications can be moved or removed by &RMB; click and choosing
<guimenuitem>Move <replaceable>application name</replaceable> Button</guimenuitem> or
<guimenuitem>Remove <replaceable>application name</replaceable> Button</guimenuitem>.
You can also move icons using the &MMB; if you have one. To do this click on an icon using
 the &MMB;, hold for a second and then drag the icon to its new position.
Another way to remove an application is by clicking the &RMB; on any free space
and then choosing <menuchoice><guimenu>Remove from Panel</guimenu>
<guisubmenu>Application</guisubmenu></menuchoice> and then the application you want to be
removed.
</para>

<!-- NOTE: Lauri: I'd say it would confuse users if I'd mention Non-TDE-Apps -->
<!-- explicitly here. Please add them if you think there's a need. -->

</sect2>

<sect2 id="adding-folders">
<title>Adding Folders</title>

<para>
Folders can be added by simply dragging a folder to any free space of
&kicker;. Quick Browsers can also be added from the context
menu or the <guimenu>TDE</guimenu> Menu.
</para>

<para>
There are two different ways to have a folder in &kicker;, you can
choose between them in the menu appearing after dropping.
</para>

<variablelist>
<varlistentry>
<term><guimenuitem>Add as File Manager &URL;</guimenuitem></term>
<listitem>
<para>Choosing this will add a link to the selected folder. Clicking
this <guiicon>folder</guiicon> icon will open &konqueror; displaying the
contents of this folder.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Add as Quick Browser</guimenuitem></term>
<listitem>
<para>If you add a folder this way, it will be displayed as a submenu of
&kicker;. This submenu contains <guimenuitem>Open in File
Manager</guimenuitem>, which does the same as a file manager &URL;, and
<guimenuitem>Open in Terminal</guimenuitem>, which opens a terminal with
this folder as the working path. Also, this submenu contains the contents of
that folder. Sub-folders are displayed as new submenus like the Quick
Browser itself. The maximum number of displayed elements can be set in
the <link linkend="configuring">Settings Dialog</link>.
Quick Browsers can also be added from the context menu of
&kicker; and then choosing <guimenuitem>Add Applet to Panel...</guimenuitem> and 
then <guilabel>Special Buttons</guilabel> on the right top of the 
<guilabel>Add Applet</guilabel> dialog.
</para>
</listitem>
</varlistentry>

</variablelist>

<para>
Both kinds of folders can be moved or removed by &RMB; click and
choosing <guimenuitem>Move <replaceable>application name</replaceable> Button</guimenuitem> or
<guimenuitem>Remove <replaceable>application name</replaceable> Button</guimenuitem>.
You can also move icons using the &MMB; if you have one. To do this click on an icon using
 the &MMB;, hold for a second and then drag the icon to its new position.
Another way to remove a folder is by clicking the &RMB; on any free space
and then choosing <menuchoice><guimenu>Remove from Panel</guimenu>
<guisubmenu>Applet</guisubmenu></menuchoice> and then the applet you want to be
removed.
</para>

<para>
File manager &URL;s can also be configured from the
context menu, just like any other folder anywhere in
&tde;.
</para>

</sect2>

<sect2 id="adding-special-icons">
<title>Special Icons</title>

<para>
Some icons in &kicker; have a special meaning. They are added by
choosing <guimenuitem>Add Applet to Panel...</guimenuitem> and 
then <guilabel>Special Buttons</guilabel> on the right top of the 
<guilabel>Add Applet</guilabel> dialog.
</para>

<variablelist>
<varlistentry>
<term>The <guilabel>TDE Menu</guilabel> Icon</term>
<listitem>
<para>
<guiicon><inlinemediaobject><imageobject><imagedata
fileref="k_menu_icon.png"
format="PNG"/></imageobject></inlinemediaobject></guiicon> The
<guiicon>TDE Menu icon</guiicon> is one of the most necessary icons in
&kicker;. As you might guess, it opens the <guimenu>TDE</guimenu> Menu,
which you can learn more about in <link linkend="tde-menu">The K
Menu</link>.
</para>
</listitem>
</varlistentry>


<varlistentry>
<term>The <guilabel>Window List Menu</guilabel></term>
<listitem>
<para>
<guiicon><inlinemediaobject><imageobject><imagedata
fileref="windowlist_icon.png"
format="PNG"/></imageobject></inlinemediaobject></guiicon> Clicking this
<guiicon>icon</guiicon> will show the <guimenu>Window
list</guimenu>. Its first entry, <guimenuitem>Unclutter
Windows</guimenuitem>, tries to move the windows on your active desktop
in a way to see as many as possible.
</para>

<para>
<guimenuitem>Cascade Windows</guimenuitem> puts all windows on the
active desktop over each others, the most recently on top and the others
sorted by the time they where last used.</para> <para>Below those
entries is a list of all currently running applications, grouped by the
desktops on which they are running. Clicking on an application will activate it.
</para>

</listitem>
</varlistentry>

<varlistentry>
<term>The <guilabel>Bookmarks Menu</guilabel></term>
<listitem>
<para>
<guiicon><inlinemediaobject><imageobject><imagedata
fileref="bookmarks_icon.png"
format="PNG"/></imageobject></inlinemediaobject></guiicon> The
<guiicon>Bookmarks</guiicon> icon provides fast access to your
bookmarks. They appear in the same way as if you click the
<guimenu>Bookmarks</guimenu> menu in &konqueror;. Clicking a bookmark in
the menu will launch &konqueror; with the &URL; which
is behind that bookmark.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>The <guilabel>Recent Documents</guilabel> Icon</term>
<listitem>
<para>
<guiicon><inlinemediaobject><imageobject><imagedata
fileref="recent_docs_icon.png"
format="PNG"/></imageobject></inlinemediaobject></guiicon>
This menu shows the most recently used documents. Clicking the element
<guimenuitem>Clear History</guimenuitem> will remove those entries,
which may be useful for privacy reasons.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>The <guilabel>Show Access</guilabel> Icon</term>
<listitem>
<para>
<guiicon><inlinemediaobject><imageobject><imagedata
fileref="desktop_icon.png"
format="PNG"/></imageobject></inlinemediaobject></guiicon> The
<guiicon>Show desktop</guiicon> icon lets you have quick access to all
the things you have on your desktop by minimizing all currently open
applications. Clicking it once will toggle it to show the desktop. The
icon will remain pressed until you either click it
again, which will restore your minimized apps, or reactivate an
application from the taskbar.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>The <guilabel>Quick File Browser</guilabel> Item</term>
<listitem>
<para>
<guiicon><inlinemediaobject><imageobject><imagedata
fileref="quickbrowser_icon.png"
format="PNG"/></imageobject></inlinemediaobject></guiicon>Adding a
<guiicon>Browse</guiicon> icon will open a dialog which will
let you choose a path and an icon, which will appear as a
<guimenu>Quick File Browser</guimenu> menu. Refer to the <link
linkend="adding-folders">Adding Folders</link> section for more information
about quick browsers.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>The <guilabel>Non-&tde; Application Launcher</guilabel></term>
<listitem>
<para>
<!-- <guiicon><inlinemediaobject><imageobject><imagedata -->
<!-- fileref="nontdeapp_icon.png" format="PNG"/></imageobject> -->
<!-- </inlinemediaobject></guiicon> -->
The <guilabel>Non-&tde; Application Launcher</guilabel> lets you add an
application which doesn't appear in the <guimenu>TDE</guimenu> menu to &kicker;.
Refer to <link linkend="adding-apps">Adding Applications</link> for more
information about Non-&tde; Applications.
</para>
</listitem>
</varlistentry>


<varlistentry>
<term>The <guilabel>Terminal Sessions</guilabel> Icon</term>
<listitem>
<para>
<guiicon><inlinemediaobject><imageobject><imagedata
fileref="terminals_icon.png"
format="PNG"/></imageobject></inlinemediaobject></guiicon> This icon
provides a menu of the available Terminal sessions, just as &konsole; does
when you click and hold its <guiicon>New Session</guiicon> button.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>The <guilabel>Print System</guilabel> Icon</term>
<listitem>
<para>
<guiicon><inlinemediaobject><imageobject><imagedata
fileref="printsys_icon.png"
format="PNG"/></imageobject></inlinemediaobject></guiicon>This icon gives
direct access to &tde;'s printing system. &tde; is able to utilize various printing
systems according to users' wishes. The options shown below will vary depending
on the printing system in use. Clicking the &LMB; on the icon opens
a menu which gives the following options:

<itemizedlist>
<listitem><para>
<guimenuitem>Add Printer...</guimenuitem> This will start &tde;'s Add Printer
Wizard which allows you to simply add a new printer to your system.</para>
</listitem>
<listitem><para>
<guimenuitem>&tde; Print Settings</guimenuitem> This item will open the &tde; Print
Configuration dialog.</para>
</listitem>

<listitem>
<para><guimenuitem>Configure Server</guimenuitem> This item allows configuration
of a &CUPS; Server. An authorization dialog, requiring validation, will be presented
to you before allowing any changes.
</para>
</listitem>

<listitem><para>
<guimenuitem>Print Manager</guimenuitem> This item starts the Printing Manager,
&tde;'s main printing control center.</para>
</listitem>

<listitem><para>
<guimenuitem>Print Browser (&konqueror;)</guimenuitem> This item will
start &konqueror; with the <literal>print:/</literal> io-slave to
browse all kinds of printers.</para>
</listitem>

<listitem><para>
<guimenuitem>Print File...</guimenuitem> This item opens a dialog which lets
you easily print one or more files.</para>
</listitem>

<listitem><para>
The next items with the names of all your printers open the KJobviewer window for each printer.</para>
</listitem>

</itemizedlist>

</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="removing-icons">
<title>Removing all kinds of icons</title>

<para>
Clicking the &RMB; on any icon, whether it's an application,
folder or special icon and then choosing
<guimenuitem>Remove <replaceable>name</replaceable></guimenuitem> from the appearing context
menu will remove the icon from &kicker;.
</para>
<para>
Another way of removing icons is clicking the &RMB; on any free space in
&kicker; and choosing <guimenuitem>Remove From Panel</guimenuitem> and then
<guimenuitem>Applet</guimenuitem>, <guimenuitem>Application</guimenuitem> or
<guimenuitem>All</guimenuitem>. You can then choose the button you want to remove in
the submenu.</para>

<note>
<para>
Please note that removing an icon from &kicker; won't remove the
application on the disk!
</para>
</note>

</sect2>

<sect2 id="adding-applets">
<title>Adding Applets</title>

<para>
&kicker; comes with a set of applets like the taskbar or the
mini-pager. They can be added by choosing <guisubmenu>Add
Applet to Panel...</guisubmenu> from the context menu,
which can be opened by
clicking the &RMB; on any free space in &kicker;. In the upcoming
dialog, choose an applet to add and click the <guibutton>Add to
Panel</guibutton> button.
</para>

<para>
Applets can be moved by dragging them on their handle with holding the
&LMB;, or the &MMB;, or by choosing
<guimenuitem>Move</guimenuitem> from the context menu.
</para>

<para>
You can learn more about the applets in the section <link
linkend="applets">Applets</link>.
</para>

</sect2>
<sect2 id="removing-applets">
<title>Removing Applets</title>
<para>
Applets can be removed by choosing the
<guimenuitem>Remove <replaceable>applet name</replaceable></guimenuitem> option from the
context menu, which appears when the &RMB; is clicked on the applet's handle (left or top
side of the applet) or on the icon itself.
</para>


</sect2>

<sect2 id="adding-extensions">
<title>Adding Extensions</title>

<para>
There is also the possibility to add external extensions to &kicker;,
like the <guimenuitem>External Taskbar</guimenuitem>, the <guimenuitem>Dock 
Application Bar</guimenuitem> for WindowMaker
dock-applications, <guimenuitem>Kasbar</guimenuitem>, an iconic kind of
taskbar, an <guimenuitem>Universal Sidebar</guimenuitem> and even child
<guimenuitem>Panel</guimenuitem>s which behave like new instances of
&kicker;.
</para>

<para>
Extensions can be added by selecting them from the
submenu <guisubmenu>Add New Panel</guisubmenu> in the context
menu of &kicker;.
Most of the extensions can be moved to any border of the screen by
dragging them with the &LMB; on a free space. If that does not work,
open the context menu on any free space in &kicker;,
choose <guimenuitem>Configure Panel...</guimenuitem> and set up the panel
positions in the appearing dialog.
</para>

<para>
More about extensions can be read in the <link
linkend="extensions">extensions</link> section.
</para>

</sect2>

<sect2 id="removing-extensions">
<title>Removing Extensions</title>

<para>
You can remove extensions by clicking <guimenuitem>Remove</guimenuitem>
in their context menu, usually located in the
fade-out handles or by selecting them from the <guisubmenu>Remove
Panel</guisubmenu> submenu of the &kicker; context
menu.
</para>
</sect2>

</sect1>

<sect1 id="configuring-apps">
<title>Configuring Application Buttons</title>

<para>
Every <guiicon>application starter</guiicon> has some preferences you
can set from their context menu with <guimenuitem>Configure <replaceable>application name</replaceable>
Button...</guimenuitem>. Usually applications
and folders have the same preferences as in &konqueror;. Only the
applications which are located in the <guimenu>TDE</guimenu> Menu (for
experienced users: those which have a <literal
role="extension">.desktop</literal> extension in the <filename
class="directory">applnk</filename> folder) have a special kind of config
dialog.
</para>

<sect2 id="general-tab">
<title>The <guilabel>General</guilabel> Tab</title>

<para>
Here you can see some information about the application link. You can also
choose an icon by clicking on the <guibutton>icon button</guibutton>
<!-- and change the filename of the link file -->.
This may be useful if you want the icon on the panel behave different
to the analog one in the <guimenu>TDE</guimenu> Menu.
</para>
<!-- Note: illogic-al: Modification not possible from Kicker's Properties menu
as root usually owns these .desktop files-->

</sect2>

<sect2 id="permissions-tab">
<title>The <guilabel>Permissions</guilabel> Tab</title>

<para>
Here you can see the permissions of the link file. Please refer to the
manuals or handbooks of your operating system for more about
permissions.
</para>

</sect2>

<sect2 id="application-tab">
<title>The <guilabel>Application</guilabel> Tab</title>

<para>
You can set the behavior of the application when it's executed on this page.
</para>

<variablelist>
<varlistentry>
<term><guilabel>Name</guilabel></term>
<listitem>
<para>
Here you can set the name of the application which will be shown in the tooltip.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Description</guilabel></term>
<listitem>
<para>
Here you can set an informative title which will be shown in the tooltip.
</para>

<note>
<para>
Once the <guilabel>Description</guilabel> is set however, it alone will be
shown in the tooltip.
</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Comment</guilabel></term>
<listitem>
<para>
See <guilabel>Description</guilabel>.
</para>

<note>
<para>
If you set a <guilabel>Name</guilabel> and a <guilabel>Comment</guilabel>, they will
be shown as tooltips of the start icons in the style <quote>Name - Comment</quote>.
</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Command</guilabel></term>
<listitem>
<para>
Usually, there is only the name of the binary that has to be started
when clicking on the icon. You can search for another application to be
started by clicking the <guibutton>Browse...</guibutton> button and/or add
special command line parameters to the application.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Work path</guilabel></term>
<listitem>
<para>
Not yet written
</para>
</listitem>
</varlistentry>

<!--<varlistentry>
<term><guilabel>Panel Embedding</guilabel></term>
<listitem>
<para>
This feature is not implemented yet.
</para>
</listitem>
<listitem><para>&kicker; has the possibility to swallow some applications
like <abbrev>e.g.</abbrev> <application>XOSView</application>. This means that
the application will show up directly in the panel. Therefore you have to
insert the exact title of the application window in the <guilabel>Window
Title</guilabel> Textfield. You can also specify an application that will be
executed when clicking on the swallowed application by typing it's name in the
<guilabel>Execute on click</guilabel> field.</para></listitem>
</varlistentry>-->

<varlistentry>
<term><guilabel>Supported file types:</guilabel></term>
<listitem>
<para>
In this section you can choose what kinds of filetypes are handled by
this application. Please refer to &konqueror; handbook for more about this.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Advanced Options</guilabel></term>
<listitem>
<para>
This button allows for further configuration of the application to be run.
</para>

<variablelist>
<varlistentry>
<term><guilabel>Run in terminal</guilabel></term>
<listitem>
<para>
If this box is checked, the application will be executed in a terminal
window. You can also add special Terminal options.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Run as different user</guilabel></term>
<listitem>
<para>
Checking this option will let the application start with the permission
of the user you typed in the field <guilabel>Username</guilabel>. You
will be prompted for the user's password on application start. This
option may be very useful if you want to start some applications as
superuser.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Enable launch feedback</guilabel></term>
<listitem>
<para>
If this box is checked, this will display feedback when an application icon is clicked
with the &LMB;.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Place in system tray</guilabel></term>
<listitem>
<para>
When checked, the application's icon will show up in the panel system tray.
You will then be able to hide or show the application by clicking on the system
tray icon. Clicking on it using the &RMB; will allow also you to undock, or quit the
application.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>DCOP registration</guilabel></term>
<listitem>
<para>
Not yet written
</para>
</listitem>
</varlistentry>
</variablelist>

</listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>

</chapter>

<chapter id="configuring">
<title>Configuring &kicker;</title>

<para>
This section describes the ways &kicker; can be configured. It's only
about the basic &kicker; settings. Configuration of applets are
described in another <link linkend="applets">section</link>.
</para>

<para>
You can change the settings by either clicking
<guimenuitem>Configure Panel...</guimenuitem> in the context
menu of &kicker;, or in &kcontrolcenter; by
going to <guilabel>Desktop</guilabel> and then selecting the
<guilabel>Panels</guilabel> or the <guilabel>Taskbar</guilabel> module.
</para>

<sect1 id="panel">
<title>The Panel Section</title>

<sect2 id="panel-extensions">
<title>Extensions</title>
<para>
Panels and panel <link linkend="extensions">extensions</link> are configured
on the same page. Simply choose one of your extensions (&eg;
Child Panel) from the <guilabel>Settings for:</guilabel> listbox. You will then
be adjust its settings rather than that of the Main Panel.
</para>

</sect2>

<sect2 id="panel-arrangement">
<title><guilabel>Arrangement</guilabel></title>

<para>
In the <guilabel>Arrangement</guilabel> tab you can configure some basic
functionality of the &tde; panel (&ie; functionality you'd find in other
panel applications as well; later we'll come to the more interesting
features).
</para>

<para>If you have more than one panel on screen, you can select at the
top of the window which panel you wish to configure.</para>

<para>
In the <guilabel>Position</guilabel> section you can choose which
screen border the panel should be attached. If you
want to play around with different settings you can change the panel's
position even easier by dragging the panel from one border to the other.
</para>

<para>In the section labeled <guilabel>Position</guilabel> is a set of
12 buttons arranged in a square. Each button corresponds to a
location for the panel. Click on a button and notice where the panel
is located on the preview monitor to the right.</para>

<tip><para>Generally, the available space in kicker is used more
efficiently when the panel is aligned horizontally, &ie; attached to the
top or bottom screen border.</para></tip>

<para>
The <guilabel>Length</guilabel> section lets you define how much space a panel
will occupy on the side of the screen which it resides. By default this is on the
bottom so changing this value will affect a panel's width. The value can be anywhere
from 1% to 100%. Use the combo box and slider to adjust the <emphasis>minimum</emphasis>
length of the panel. Checking the check box <guilabel>Expand as required to fit
contents</guilabel> makes sure that a panel is at least as big as needed to show
every icon and applet. The panel will become longer if more space is needed. When
less space is required on the panel, the panel will shrink down to the minimum size.
If there is no mark in the checkbox, then the panel is fixed to the
length specified in this section.
</para>

<para>The final section of this table is labeled
<guilabel>Size</guilabel>, and refers to the
<emphasis>height</emphasis> of the panel. The panel's size can be
<guilabel>Tiny</guilabel>, <guilabel>Small</guilabel>,
<guilabel>Medium</guilabel>, <guilabel>Large</guilabel> or
<guilabel>Custom</guilabel>. If you choose
<guilabel>Custom</guilabel> mode, you can resize &kicker; by
specifying a height in the combobox.</para>

<para>If you have multiple monitors, you can configure the panel for
each screen entirely independently. If you are not sure which screen
is which, Press the <guibutton>Identify</guibutton> and a number will
appear centred on each screen.</para>
<!-- TODO: It's not centered on dual head non-xinerama, they both
appear on the primary head, file a bug -->

<para>Then simply choose the screen you wish to configure from the
drop down box labelled <guilabel>Xinerama screen</guilabel>, or choose
<guilabel>All Screens</guilabel> to have identical configurations on
each.
</para>

</sect2>

<sect2 id="panel-hiding">
<title><guilabel>Hiding</guilabel></title>

<para>
Depending on your screen resolution you may find that the panel
takes away too much of your precious screen real estate. To save
screen space, the panel offers manual hiding of the panel, an auto
hide feature, and the ability to allow other windows to lay on top of
the panel. These features are selected in the section entitled
<guilabel>Hide Mode</guilabel>.</para>

<para>When the <guilabel>Hide Mode</guilabel> feature is enabled, the
panel will hide when the mouse cursor has not been moved over it for the
configured time. If you move the mouse to the panel's screen
border it will show up again.</para>

<para>The <guilabel>Hide Mode</guilabel> section has three options:</para>
<variablelist>
<varlistentry>
<term><guilabel>Only hide when panel-hiding button is clicked</guilabel></term>
<listitem><para>When this option is selected, the panel will remain visible at 
the location you defined unless you click on the button at the far right (for horizontally 
oriented) or bottom (for vertically oriented) button. This button has an arrow on it pointed 
to the edge of the screen.</para>

<para>Once clicked, the panel will disappear. If the button is clicked again, the panel will re-appear 
at the same location.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Hide automatically</guilabel></term>
<listitem><para>If this option is selected, then the panel will automatically disappear after 
the number of seconds specified in the combo box below the option. To make the panel reappear, 
simply move the mouse pointer to the edge of the screen where the panel is located, and the 
panel will reappear immediately.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Allow other windows to cover the panel</guilabel></term>
<listitem><para>As this option's label implies, the panel is always on the desktop when 
this option is selected. It is now possible, however, for application windows to lay 
on top of the panel.</para>  

<para>Once the panel has moved back on top of the application window, it will stay there 
until an application window becomes active again.</para>
</listitem>
</varlistentry>
</variablelist>

<para>If you place a mark in the checkbox labeled <guilabel>Show panel when switching
desktops</guilabel>, the panel will automatically reappear when you switch desktops. (The panel
will disappear again after the specified number of seconds.) Otherwise, if there are too many
applets and icons on &kicker;, two small scroll buttons will be displayed to scroll the whole
panel.</para>

<para>To restore the panel, simply move the mouse cursor to the screen 
location specified in the drop box labeled <guilabel>Raise when the pointer touches 
the screen's:</guilabel>. You can change this value by selecting one of the choices 
provided in the drop down box.</para>

<para>
When the panel's hide buttons are enabled you'll see buttons on both
sides of the panel, with arrows showing to the screen border. If you
click on one of these buttons, the panel will slide away in that
direction. After that, you'll see a remaining show button in that
corner, which will make the panel show again. Check the appropriate
checkbox if you want the hide buttons to show up on any side of
&kicker;. Using the slider you can change the width of the buttons.
</para>

<para>The next section down is labeled <guilabel>Panel-Hiding Buttons</guilabel>. It 
consists of two check boxes: <guilabel>Show left panel-hiding button</guilabel> and 
<guilabel>Show left panel-hiding button</guilabel>. Use these checkboxes to show and 
hide the left and right manual panel hiding buttons.</para>

<para>
The <guilabel>Panel Animation</guilabel> frame allows you to choose
whether the panel will softly slide away or just disappear.
Checking the <guilabel>Animate panel hiding</guilabel> will allow you
to configure the speed of the animation using the sliders. Unchecking,
naturally, disables the panel animations.
</para>

</sect2>

<sect2 id="panel-menus">
<title>Menus</title>

<para>
In the <guilabel>Menus</guilabel> tab you can configure the panel menu
behavior. This affects the <guimenu>TDE</guimenu> menu you will often use
to launch applications, the browser menus you can use to access
folders and other menus like the recent documents menu.
</para>

<para> The first option is the menu style. &tde; supports two menu styles:
a classic menu familiar to many desktops and operating systems and a Kickoff style.</para>

<para>The <guilabel>TDE Menu</guilabel> section provides many options to
configure the <guimenu>TDE</guimenu> menu functionality.</para>

<para>The <guilabel>Menu item format</guilabel> section allows you to adjust the
details of the <guimenu>TDE</guimenu> menu entries. There are four
buttons. Each button option determines how the application <emphasis>Name</emphasis>
(&ie; &konqueror;, &kword;, &etc;) and the <emphasis>Description</emphasis> (&ie; Web
Browser, Word Processor, &etc;) are displayed on the &kmenu;. The <guilabel>Name only</guilabel>
option simply shows the application's name in the menu.
The <guilabel>Name (Description)</guilabel> option will show a small description
besides the name of the application.
The <guilabel>Description (Name)</guilabel> and <guilabel>Name
(Description)</guilabel> options will show both name and description in
the &kmenu;.
</para>

<para>Below the <guilabel>Menu item format</guilabel> section is a button to
<guilabel>Edit TDE Menu</guilabel>. Then menu editor is a tool to customize the
menu layout and add or delete menu items.</para>

<para>The <guilabel>Optional Menus</guilabel> checkboxes allow
you to determine which special menu items appear in the &kmenu;.</para>

<itemizedlist>

<listitem>
<para>The <guilabel>Bookmarks</guilabel> 
menu allows you to quickly select from the same bookmarks that are available in &konqueror;.</para>
</listitem>

<listitem>
<para>The <guilabel>Find</guilabel> menu offers access to the &kfind; application to search for
local files, and a quick link to a search engine to search for things on the Internet.</para>
</listitem>

<listitem>
<para>The <guilabel>Kate Session Menu</guilabel> allows you to
open any of your Kate sessions.</para>
</listitem>

<listitem>
<para>The <guilabel>Konqueror Profiles</guilabel> menu allows you to
launch &konqueror; with any of your configured profiles.</para>
</listitem>

<listitem>
<para>The <guilabel>Network Folders</guilabel> menu can launch a
&konqueror; file manager window displaying any of your configured
network folders.</para>
</listitem>

<listitem>
<para>The <guilabel>Print System</guilabel> menu provides several menu entries to help manage 
the printer(s) attached to your system.</para>
</listitem>

<listitem>
<para>The <guilabel>Quick Browser</guilabel> menu gives you quick links to locations on your
hard drive.</para>
</listitem>

<listitem>
<para>The <guilabel>Recent Documents</guilabel> menu lists the most recently edited documents
and will automatically launch the application to edit or view this document.</para>
</listitem>

<listitem>
<para>The <guilabel>Settings</guilabel> menu allows you to launch each &kcontrol; module 
directly from the TDE menu.</para>
</listitem>

<listitem>
<para>The <guilabel>System Menu</guilabel> allows you quick access to
some commonly visited places, including your Home folder, and the
Trash. You may find this useful instead of having a separate entry for
each of these in the &kmenu;</para>
</listitem>

<listitem>
<para>The <guilabel>Terminal Sessions</guilabel> menu provides menu items to launch several
different types of 
terminal programs (command line interfaces).</para>
</listitem>
</itemizedlist>

<para>Other options in the <guilabel>Menu item format</guilabel> section include:</para>

<para><guilabel>Open menu on mouse hover</guilabel>: This option affects only the Kickoff
menu style. When enabled, hovering the mouse pointer over the menu buttons will atuomatically
open that menu without clicking the mouse button.</para>

<para><guilabel>Show Tooltip</guilabel>: When enabled a tooltip appears when hovering the mouse
pointer over menu items. Using this option requires that tooltips ar enabled in Panels Appearance.</para>

<para><guilabel>Show side image</guilabel>: Enabling this option displays a nice
image on the left side of the <guimenu>TDE</guimenu> menu.</para>

<para><guilabel>Display text in menu button</guilabel>: When enabled the text enter into the
associated text box will be displayed in the menu button.</para>

<para><guilabel>Font</guilabel>: This option allows you to select the font and size for all items
in the menu.</para>

<para><guilabel>Change TDE Menu icon</guilabel>: This option allows you to change the menu icon.</para>

<para>In the <guilabel>QuickBrowser Menus</guilabel> section you can configure
whether the panel's browser menus will show hidden files or not (hidden
files on &UNIX; systems are those whose filenames begin with a dot) as
well as how many files at most will be shown in a quick browser menu. The
latter option might be useful when you have a rather small screen
resolution, because the browser menus would otherwise quickly fill up your screen
when you browse folders containing many files.</para>

<para>The <guilabel>QuickStart Menu Items</guilabel> section provides quick
access to programs you have used often or recently. You
can choose whether to show the most recently programs or the most
frequently used programs. Use the option <guilabel>Maximum number of
entries</guilabel> to configure how many programs the quick start section will remember.
</para>

<para>The <guilabel>Recent Documents Menu</guilabel> section includes an option to enable a
submenu showing the most recent documents opened using &tde; applications. This option does
not show recent documents opened with non &tde; applications.</para>

<para>The <guilabel>TDE Menu Search</guilabel> section includes an option to show a search box
in the menu to help find items in the menu.</para>

</sect2>

<sect2 id="panel-appearance">
<title><guilabel>Appearance</guilabel></title>

<para>
Using the <guilabel>Appearance</guilabel> tab you can configure the
panel's overall appearance.
</para>

<sect3 id="panel-appearance-general">
<title><guilabel>General</guilabel></title>

<para>
The check box <guilabel>Enable icon mouseover effects</guilabel>
toggles the large animated tooltips of &kicker;. They show name and
description of the icons and applets the mousepointer is positioned on.
</para>

<para>When <guilabel>Enable icon activation effects</guilabel> is enabled,
the icons in the panel (not the taskbar) activate or "blink" when selected.</para>

<para>
If <guilabel>Show tooltips</guilabel> is checked, the classical small
tooltips with descriptions of the icons and applets will be shown if the
mousepointer rests over an icon for some seconds. Note that this
has no effect as long as the option to <guilabel>Enable icon mouseover
effects</guilabel> is enabled.
</para>

</sect3>

<sect3 id="panel-appearance-button-backgrounds">
<title><guilabel>Button Backgrounds</guilabel></title>

<para>The &tde; panel supports so-called <guilabel>Button
Backgrounds</guilabel>. This means that the buttons shown on the panel
will be drawn using configurable images. To enable button backgrounds,
simply choose the button type from the list, and change the drop down
box to the color image you would like to use. Choose
<guilabel>Default</guilabel> to return to an unstyled button. If you
choose <guilabel>Custom color</guilabel>, the color button next to the
drop down list will be enabled. Click on it to select a custom color
to use.</para>

<para>
For every kind of panel button there is a combo box offering a custom
color option and tiled images. When the value is changed from &quot;Default&quot;,
tiles are enabled for this kind of button. You can also see a preview of a tile
before use via the combo box.
</para>

<para>
The different kinds of buttons are:
</para>

<variablelist>
<varlistentry>
<term><guilabel>TDE Menu</guilabel> tiles</term>
<listitem>
<para>
The icon for the <guiicon>TDE Menu</guiicon> will be displayed as a tile
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Applications</guilabel> tiles</term>
<listitem>
<para>
The icons which start applications will be displayed as tiles
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Desktop access</guilabel> tiles</term>
<listitem>
<para>
The <guiicon>Desktop Access</guiicon> icon will be displayed as a tile
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>QuickBrowser menus</guilabel> Tiles</term>
<listitem>
<para>
The icons for <guiicon>Quickbrowsers</guiicon> will be displayed as
tiles
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Window list</guilabel> Tiles</term>
<listitem>
<para>
The <guiicon>Window List</guiicon> icon will be displayed as a tile
</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="panel-appearance-background">
<title><guilabel>Panel Background</guilabel></title>

<para>
The <guilabel>Enable transparency</guilabel> option, when checked, allows the
panel to appear transparent.
</para>

<para>
The background image is a picture that will be used
to draw the panel's background, just like you can use a picture for the
desktop background. Check the <guilabel>Enable background
image</guilabel> option to enable this feature. You can specify an image
file in the edit box below or choose one by clicking on the
<guiicon>Open file dialog</guiicon> button. You may also check the
<guilabel>Colorize to match the desktop color scheme</guilabel> box to
modify the background image's colors. You'll see a preview of the selected
picture on the right.
</para>

</sect3>

<sect3 id="panel-appearance-advanced">
<title><guilabel>Advanced Options</guilabel></title>

<para>The <guilabel>Hide button size:</guilabel> option allows you to
choose a width in pixels for the hide buttons, if they are
visible.</para>

<para>The panel itself has several default sizes set, which you can
switch between by simply dragging the edge of it, or by &RMB; clicking
on an empty space in the panel, choosing <guisubmenu>Size</guisubmenu>
and selecting the desired size from the submenu. If you enable
<guilabel>Allow Drag and Drop resizing of panels</guilabel> then by
choosing <guimenuitem>Custom</guimenuitem> in the panel menu, you can
drag the panel edge to any size you like.</para>

<para>Applet handles are normally visible beside each applet on the panel,
so that it is clear where to click to configure them, or to get to the panel menu.
 You can instead have them <guilabel>Fade out</guilabel>, or hide unless you hover
the mouse over them, or you can choose to <guilabel>Hide</guilabel> them completely.</para>

<para>Finally, if the panel is transparent, you can tint it with a
color of your choice. The slider allows you to choose how opaque the
tint is. At the lowest end, there is no tint visible, while at the
highest, the panel is not transparent at all.</para>

</sect3>

</sect2>

<!-- This section seems deprecated...

<sect2 id="panel-applets">
<title>Applets</title>

<para>
Applets are small plugins that extend the panel's functionality. &tde;
comes with some applets but they may be provided by third parties as
well.</para>

<para>
Panel applets can be started using two different ways: internally or
externally. While <quote>internal</quote> is the preferred way to load
applets, this can raise stability or security problems when you are
using poorly programmed third-party applets. To address these problems,
applets can be marked <quote>trusted</quote>. You might want to
configure the panel to treat trusted applets different from untrusted
ones. Your options are:
</para>

<itemizedlist>
<listitem>
<para>
<guilabel>Load only trusted applets internal</guilabel>: All applets but
the ones marked <quote>trusted</quote> will be loaded using an external
wrapper application.
</para>
</listitem>

<listitem>
<para>
<guilabel>Load startup config applets internal</guilabel>: The applets
shown on &tde; startup will be loaded internally, others will be loaded
using an external wrapper application.</para></listitem>
<listitem><para><guilabel>Load all applets internal</guilabel>: will
load all applets internally, regardless of whether they are trusted or
not.
</para>
</listitem>
</itemizedlist>

<para>
For stability and security reasons, we recommend using one of the first
two options and that you mark only those applets as 'trusted' that come
with the &tde; base packages.
</para>

<para>
To mark applets <quote>trusted</quote> or <quote>untrusted</quote> you
can move them from one of the shown listboxes to the other. Just try
selecting an applet in the list of trusted applets and click the
<guibutton>&gt;&gt;</guibutton> button. This will move the selected
applet to the other list, while clicking the
<guibutton>&lt;&lt;</guibutton> button will move the selected applet of
the list of available applets to the list of trusted ones.
</para>

</sect2>
-->

</sect1>

<sect1 id="taskbar-settings">
<title>The <guilabel>Taskbar</guilabel></title>

<sect2>
<title><guilabel>Taskbar</guilabel></title>

<para>
This section changes the settings of the taskbar. Changes affect the
external taskbar and also taskbar applets on &kicker; or child-panels.
The taskbar can be located in the panel (default), or outside the panel
on the desktop.</para>

<variablelist>

<varlistentry>
<term><guilabel>Show windows from all desktops</guilabel></term>
<listitem>
<para>
This option determines whether all open windows are included in the taskbar or not. By default,
the taskbar only shows the open windows <emphasis>on the current
desktop</emphasis>. If this option is enabled, the taskbar will show
all open windows <emphasis>on all desktops</emphasis>.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Sort windows by desktop</guilabel></term>
<listitem>
<para>
This option changes the sort order of the icons on the taskbar, so that windows on virtual
desktop 1 are shown first (to the left, or at the top of the taskbar),
followed by windows on virtual desktop 2, and so on.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Sort alphabetically by application name</guilabel></term>
<listitem>
<para>This options shows the icons in an alphabetical sort order on the taskbar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Allow taskbar items to be rearranged using drag and drop</guilabel></term>
<listitem>
<para>
When selected the order of the taskbar buttons can be rearranged simply by selecting
the button with the mouse pointer and dragging to the desired location.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Cycle through windows with mouse wheel</guilabel></term>
<listitem>
<para>This option allows cycling or switching through all apps in the taskbar by
moving the mouse scrool wheel while the mouse pointer hovers over the taskbar.</para> 
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show only minimized windows</guilabel></term>
<listitem>
<para>
If this box is checked, only windows which have been minimized will be
shown in the taskbar. If <guilabel>Show windows from all desktops</guilabel>
has been checked then all minimized windows will be shown. Otherwise, only the
minimized windows of the current virtual desktop will be shown.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show window list button</guilabel></term>
<listitem>
<para>Checking this box will show the small <guibutton>window list
button</guibutton> at the fat left of the taskbar. This button opens a popup menu listing
all applications in the taskbar.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Display</guilabel></term>
<listitem>
<para>This option affects how taskbar buttons are displayed. The drop-down list button supports
three options: Icons and Text, Text only, and Icons only.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Group similar tasks</guilabel></term>
<listitem>
<para>
<inlinemediaobject><imageobject><imagedata fileref="taskbar_group.png"
format="PNG"/></imageobject></inlinemediaobject>
</para>

<para>
This is option helps you if you often lack space in your
taskbar. If it is set to <guilabel>Always</guilabel>, several
instances of the same application are grouped together in one taskbar
button. Select <guilabel>When Taskbar Full</guilabel> to make &kicker;
only group similar tasks if there is not much space left in the taskbar.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Appearance</guilabel></term>
<listitem>
<para>This option allows you to set the taskbar appearance to
<guilabel>Elegant</guilabel>, <guilabel>Classic</guilabel> or
<guilabel>For Transparency</guilabel>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Use custom colors</guilabel></term>
<listitem>
<para>This option allows you to choose different colors for the taskbar buttons.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title><guilabel>Actions</guilabel></title>

<para>The next set of options allow you to customize the actions
performed with different mouse clicks on taskbar icons.</para>

<para>You can select any action from the list for the <guilabel>Left button</guilabel>, 
the <guilabel>Middle button</guilabel> and the <guilabel>Right button</guilabel>.</para>

<note><para>Some of these settings have effect only when a taskbar button contains
more than one application.
</para></note>

<variablelist>

<varlistentry>
<term>
<guilabel>Show Task List</guilabel>
</term>
<listitem><para>Clicking with the
mouse button will open a menu displaying all
tasks in that group. If you click an entry of that menu with any mouse
button, the corresponding application will become active.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show Operations Menu</guilabel></term>
<listitem>
<para>Clicking with the mousebutton will open a menu with all
applications of that group, where every application has its window
menu as a submenu and there are some group specific entries like
<guimenuitem>Close All</guimenuitem> which closes all applications of
that group, <guisubmenu>All to Desktop</guisubmenu> which lets you
define on which desktop the whole group appears and
<guimenuitem>Maximize All</guimenuitem>, <guimenuitem>Minimize
All</guimenuitem> and <guimenuitem>Restore All</guimenuitem> which
appends those actions to all applications of that group.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Activate, Raise or Minimize Task</guilabel></term>
<listitem>
<para>When a task is minimized, this option activates and raises the task to focus. When open
in the background but not visibile, this option raises the task to focus.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Activate Task</guilabel></term>
<listitem>
<para>
Clicking with the mousebutton will activate
the first application in that group without opening the group menu.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Raise Task</guilabel></term>
<listitem>
<para>The first application of that group will be
put in the foreground without giving focus to it.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Lower Task</guilabel></term>
<listitem>
<para>
The first application of that group will be
put in the background. It won't lose the focus.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Minimize Task</guilabel></term>
<listitem>
<para>The first application of that group will be
minimized. If it is already minimized, it will be restored again.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Move To Current Desktop</guilabel></term>
<listitem>
<para>When the taskbar is configured to show all apps from all desktops, this options will move the
selected app from a different desktop to the current desktop.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Close Task</guilabel></term>
<listitem>
<para>This option closes or terminates the task.
</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

</chapter>

<chapter id="tde-menu">
<title>The <guimenu>TDE</guimenu> Menu</title>

<para>
The <guimenu>TDE</guimenu> Menu is one of the central elements of
&kicker;.
</para>

<para>
There are five main groups in the <guimenu>TDE</guimenu> Menu which will
be described now from bottom to top.
</para>

<sect1 id="tde-group">
<title>The &tde; Group</title>

<para>
This group is for the common &tde; things in the <guimenu>TDE</guimenu>
Menu.
</para>

<variablelist>
<varlistentry>
<term><guimenuitem>Log Out...</guimenuitem></term>
<listitem>
<para>
This entry is used to finish the &tde; session. It also shuts down the
&X-Window; session.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Lock Session</guimenuitem></term>
<listitem>
<para>
With this entry you can lock your session if you don't want anybody else
to access your desktop. If you have set a screensaver, it will appear when
locked, otherwise the screen will turn black. If you hit any key, you
will be prompted for your user password. This is independent from the
screensaver's password settings.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Special Configuration</term>
<listitem>
<para>
Clicking with the &RMB; on the <guimenu>TDE</guimenu> Menu, will produce a
special submenu. In this submenu is the <guisubmenu>Panel Menu</guisubmenu>.
Here you can change the settings of &kicker;, described in the
<link linkend="configuring">Configuring &kicker;</link> section, add
things to &kicker; (see in <link linkend="basics">&kicker; Basics</link>
for more), or  reach the <guisubmenu>Help</guisubmenu> Menu, but as you are
reading this, you probably found it yourself.
You can also start the <application>Menu Editor</application> via this submenu.
</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="run-command">
<title><guilabel>Run Command...</guilabel></title>

<para>
This will bring up a small but powerful application start dialog.
</para>

<para>
In the standard case, you just type in a command and press
<keycap>Enter</keycap> or click <guibutton>Run</guibutton>. But there
is also an <guibutton>Options &gt;&gt;</guibutton> button which will bring up
some starting options to the command window.
</para>

<variablelist>
<varlistentry>
<term><guilabel>Run in terminal window</guilabel></term>
<listitem>
<para>
Checking this box will let the application start in a terminal which means that
you will be able to see any command-line messages the application may give.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Run as a different user</guilabel></term>
<listitem>
<para>
If this box is checked, you can specify a user with whose permission the
application should run in the <guilabel>Username</guilabel> textfield.
If you specify another user, you will have to give a password at the box
below.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Run with different priority</guilabel></term>
<listitem>
<para>
Check this option to run with a different priority. A higher priority
will tell the operating system to give more processing time to the
applications. You can use the slider to change the priority. If you
want to give your app a higher priority than the default one (middle
position), you will need to enter the root password below.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Run with realtime scheduling</guilabel></term>
<listitem>
<para>
The Scheduler is the part of the operating system which processes will
run and which have to wait. Usually, an application will run with normal
schedule, which means it can use the processing time it gets from the
operating system, but you can also set it to
realtime. This means that the application has all
the process time until it gives it away. You will need to enter the root
password to use <guilabel>Run with realtime scheduling</guilabel>.
</para>

<warning>
<para>
This can be dangerous. If the application hangs and cannot give up the
processor, the complete system might hang.
</para>
</warning>

</listitem>
</varlistentry>

</variablelist>

</sect1>


<sect1 id="actions">
<title>The Actions Group</title>

<para>
This group contains some very useful dynamic menus as described in the
<link linkend="panel-menus">Menus</link> section of &kicker;'s settings.
</para>

<variablelist>
<varlistentry>
<term><guisubmenu>Quick Browser</guisubmenu></term>
<listitem>
<para>
This submenu contains quick browsers for three very useful folders:
home, root, and system configuration.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guisubmenu>Recent Documents</guisubmenu></term>
<listitem>
<para>
This menu shows the most recently used documents (works only with &tde;
applications for the moment). Clicking the element <guimenuitem>Clear
History</guimenuitem> will remove those entries, what may be useful for
privacy reasons.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guisubmenu>Bookmarks</guisubmenu></term>
<listitem>
<para>
This submenu shows your personal bookmarks just like &konqueror;
does. Refer to the &konqueror; Handbook for more help on this.
</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="application-group">
<title>The All Applications Group</title>

<para>
The submenus for application starting are located in this group. You can
use &kmenuedit; to add, remove or move the entries. Applications will have a
short description if either the <guilabel>Name (Description)</guilabel> or
<guilabel>Description (Name)</guilabel> option is enabled in the settings.
</para>
</sect1>

<sect1 id="most-recently-group">
<title>The Most Used Applications Group</title>

<para>
This group holds either the most recently or the most frequently used
applications. See the <link linkend="panel-menus">Menus
Configuration</link> section for more about that.
</para>
</sect1>

</chapter>

<chapter id="applets">
<title>Applets</title>

<para>
Applets are small applications running inside of &kicker;. Almost
everything besides the <guiicon>application starter buttons</guiicon>
are applets. They can be added from the context menu
by choosing<guisubmenu>Add Applet to Panel</guisubmenu>. Every
applet contains a small arrow in its handle. Clicking it will bring up a menu
which lets you move or remove it, set the Preferences, if there are any and set
the preferences of &kicker;.
</para>

<sect1 id="taskbar-applet">
<title>The Taskbar Applet</title>

<para>
The taskbar applet shows buttons for the running applications. The
application, which has the focus, is shown as a pressed button. If an
application is minimized, the title displayed in the taskbar will fade
to gray.
</para>

<tip>
<para>
If you click on the button of the active application, it will be
minimized. This means also that if you click twice on an inactive
application, it will also be minimized.
</para>
</tip>

<para>
A click with the &RMB; on a button will show the standard application
menu. Only the entry <guimenuitem>To Current Desktop</guimenuitem>
differs: if you have set the taskbar to show the applications of all
desktops, you can move this app to the current desktop.
</para>

<para>
There is also a small icon on the left or top side of the taskbar, which
opens a menu. This is called the <guibutton>windows list
icon</guibutton>. The menu's first entry, <guimenuitem>Unclutter
Windows</guimenuitem>, tries to move the windows on your active desktop
in a way to see as many as possible. <guimenuitem>Cascade
Windows</guimenuitem> puts all windows on the active desktop over each
others, the most recently on top and the others sorted by the time they
where last used.
</para>

<para>
Below those entries is a list of all currently running applications,
grouped by the desktops on which they are running. Clicking on the name
of a desktop will switch to that one, clicking an application will also
activate it. You can specify the mouse behavior. Please refer to <link
linkend="taskbar-settings">Taskbar</link> settings for more about that.
</para>


<sect2 id="configure-taskbar-applet">
<title>Configuring the Taskbar Applet</title>

<para>
You can configure the taskbar by clicking the &RMB; on the small move
handle.
</para>
<para>
Please refer to <xref linkend="taskbar-settings"/> for details about the
preferences of the taskbar.
</para>

</sect2>

</sect1>

<sect1 id="pager-applet">
<title>The Mini-Pager Applet</title>

<para>
This little applet shows a preview of the virtual desktops, lets you
switch between virtual desktops and gives you the ability to move windows
from one desktop to another by dragging them.
</para>

<para>
There is also a very useful context menu used to
configure this applet:
</para>

<variablelist>
<varlistentry>
<term><guimenuitem>Configure Desktops...</guimenuitem></term>
<listitem>
<para>
This opens the configuration dialog for virtual desktops. There you can
specify how many desktops you want to have and give them names.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guisubmenu>Pager Options</guisubmenu></term>
<listitem>
<para>
In this submenu you can configure the appearance of the Mini-Pager. It
provides the following functionality:
</para>

<variablelist>

<varlistentry>
<term><guimenuitem>Pager Layout</guimenuitem></term>
<listitem>
<para>
In this section you can choose in how many <guimenuitem>Rows</guimenuitem>
or <guimenuitem>Columns</guimenuitem> the desktop previews are arranged,
if you want to see which windows are currently visible on the desktops
and if icons should indicate the applications running on the different
vitual desktops.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Text Label</guimenuitem></term>
<listitem>
<para>
Here you can choose if the desktop previews should be labeled by their
numbers, their names or if you you don't want them to be labeled at all.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Background</guimenuitem></term>
<listitem>
<para>
You can set the background of the pager to
<guimenuitem>Elegant</guimenuitem>, <guimenuitem>Transparent</guimenuitem>
or equivalent to the <guimenuitem>Desktop Wallpaper</guimenuitem>.
</para>
</listitem>
</varlistentry>

</variablelist>

</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Launch Pager</guimenuitem></term>
<listitem>
<para>
This launches the application &kpager;, which provides functions similar
to those offered by the Mini-Pager applet.
</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="clock-applet">
<title>The Clock Applet</title>

<para>
As you might already guess, the clock applet is a small clock which
resides in &kicker;.
</para>

<para>
A click with the &LMB; on the clock will show a small calendar. You can
use the <guibutton>single arrows</guibutton> to switch the months or the
<guibutton>double arrows</guibutton> for switching years. This won't
have any effect of your date settings, it's just for your information.
</para>

<para>
There are some things you can do with the clock applet. This can be done
from the context menu.
</para>

<sect2 id="clock-type">
<title><guisubmenu>Type</guisubmenu></title>

<para>
There are four ways the clock can appear:
</para>

<variablelist>
<varlistentry>
<term>Plain</term>
<listitem>
<para>
This lets the clock appear as a simple text that shows the time in plain text.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Digital</term>
<listitem>
<para>
This lets the clock appear as a digital clock showing the time in the
well known seven segment style.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Analog</term>
<listitem>
<para>
If this is set, the clock will be displayed as an old styled analog
clock.
</para>
<note>
<para>This may only be useful if you set &kicker; to normal or large
size.
</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term>Fuzzy</term>
<listitem>
<para>
This is a very unorthodox style of time display. Try it out, it is
really funny!
</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="show-timezone">
<title><guimenuitem>Show Timezone</guimenuitem></title>

<para>
Select available timezones or open the <guilabel>Timezones</guilabel>
tab of <guilabel>Configure</guilabel> dialog of the clock applet with 
<guimenuitem>Configure Timezones...</guimenuitem>.</para>

</sect2>

<sect2 id="adjust-time">
<title><guimenuitem>Adjust Date &amp; Time</guimenuitem></title>

<para>
This option starts the <guilabel>Date &amp; Time</guilabel>
configuration module in the section <guilabel>System Administration</guilabel> of the
&kcontrolcenter;.</para>

<note>
<para>
You will need the super user password for adjusting date and time.
</para>
</note>

</sect2>

<sect2 id="date-format">
<title><guimenuitem>Date &amp; Time Format</guimenuitem></title>

<para>
This will open the <guilabel>Country/Region &amp; Language</guilabel> module in the section
<guilabel>Regional &amp; Accessibility</guilabel> of the &kcontrolcenter; 
where you can set your formats on the page <guilabel>Times &amp; Dates</guilabel>. There aren't
any special permissions needed for that.
</para>

</sect2>

<sect2 id="copy-date">
<title><guisubmenu>Copy to Clipboard</guisubmenu></title>

<para>
If you need to paste the actual date and/or time in another application
(&eg; in a text editor), you can copy it to the clipboard with this
function. After selecting one of the available formats, the actual date
and/or time is placed in the clipboard using the appropriate format.
</para>

</sect2>

<sect2 id="clock-preferences">
<title><guimenuitem>Configure Clock...</guimenuitem></title>

<para>
Here you can set some general preferences of the clock applet.
</para>

<variablelist>
<varlistentry>
<term><guilabel>Appearence</guilabel></term>
<listitem>
<para>
In the <guilabel>Clock Type</guilabel> settings you can choose between
the clock styles like in the context menu.
</para>

<!--para>
The <guilabel>Date</guilabel> group lets you pick font and color of the
date, which is shown when activated for the specific clock type.
</para>-->
</listitem>
</varlistentry>

<varlistentry>
<term>The <guilabel>Plain Clock</guilabel> options</term>
<listitem>
<para>In the <guilabel>Display</guilabel> section you can check if you
want to have the date and/or the seconds shown. In
<guilabel>Time</guilabel> you can choose if you want the common &tde;
look or your own custom colors and font.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>The <guilabel>Digital Clock</guilabel> options</term>
<listitem>
<para>In the <guilabel>Display</guilabel> section you can check if you
want to have the date, the seconds and/or blinking dots shown. In
<guilabel>Time</guilabel> you can choose if you want the common
<acronym>LCD</acronym>-Look or your own custom colors.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>The <guilabel>Analog Clock</guilabel> options</term>
<listitem>
<para>
In the <guilabel>Display</guilabel> section you can check if you want to
have the date and/or seconds shown. In <guilabel>Time</guilabel> you
can choose if you want the common <acronym>LCD</acronym>-Look or your
own custom colors.
You can also set the level of antialiasing, which means that lines will get
blurred a little bit to prevent steps in the drawing. High quality antialiasing
may catch some system load on low-end systems.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>The <guilabel>Fuzzy Clock</guilabel> options</term>
<listitem>
<para>
In the <guilabel>Display</guilabel> section you can check if you want to
have the date shown. In <guilabel>Time</guilabel>
you can choose the colors and the font of the fuzzy clock. There is also a slider to set the
<guilabel>Fuzziness</guilabel>. This cannot be described in the
documents, just do your own experiments. 
</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="launcher-applet">
<title>The Quick Launcher Applet</title>

<para>
This is a compressed application launcher. It is very useful especially
if the panel is set to normal or large size. You can add applications by
drag and drop or from the context menu. The
context menu is also used to remove an application.
</para>
</sect1>

<sect1 id="systemtray-applet">
<title>The System Tray Applet</title>

<para>
The System Tray is used to dock some special applications &eg;
&klipper; or &juk;. The applications shown in the system tray all
provide individual funtionality. If you need help concerning these
options, please refer to the application handbooks.
</para>

<para>
The System Tray's context menu provides the option
<guimenuitem>Configure System Tray...</guimenuitem> . If you click on it,
a dialog pops up which lets you choose applications that should not be
permanently visible in the System Tray. Hidden icons can be made visible
by clicking on the small arrow appearing on the left or top side of the
applet.
</para>
</sect1>

<sect1 id="lockout-applet">
<title>Lock/Logout Applet</title>
<para>
This little applet contains two buttons.
The <guibutton>Lock the session</guibutton> is used to lock the session if you
ever want to leave your &tde; unattended and don't want anybody to access it.
The <guibutton>Log out</guibutton> is used to close your &tde; session.
</para>
</sect1>

<sect1 id="run-applet">
<title>The Application Launcher Applet</title>

<para>
This applet provides a simple command line embedded in &kicker;. Nothing
more, nothing less.
</para>

</sect1>

<sect1 id="naughty-applet">
<title>The Runaway Process Catcher Applet</title>

<para>
This applet shows a smiley which will get angry when any process catches
up too much system resources. If an application uses too much, a
messagebox will appear and ask you how to handle that application.
</para>

<para>
Clicking it with the &LMB; will show a configuration dialog. Here you
can set the <guilabel>Update interval</guilabel>, which is set in
seconds, and the <guilabel>CPU load threshold</guilabel>. At the
moment, there is no real advice for setting this up, you will have to do
some experimenting. These settings will probably change in a future
release. There is also a section <guilabel>Programs to ignore</guilabel>
where you can add applications that use many resources naturally,
&eg; compilers or 3D renderers.
</para>

</sect1>

<sect1 id="klipper-applet">
<title>&klipper; Applet</title>

<para>
This applet does exactly the same like the &klipper; residing in the system
tray. It has the advantage, that it consumes a little bit less system
resources, which only matters on really slow systems, but has the
disadvantage, that it uses more space than &klipper; in the system
tray. You can read more about that in the manual for
<ulink url="help:/klipper/index.html">&klipper;</ulink>.
</para>
</sect1>

</chapter>

<chapter id="extensions">
<title>Panel Extensions</title>

<para>
There are also some features that run outside of &kicker;, the
extensions. They are added from the
context menu by choosing <guisubmenu>Add New Panel</guisubmenu>. You can move them to any
screenborder by dragging them at the small applet
handle on their side and remove it by right clicking on an empty space and choose
<guimenuitem>Remove Panel</guimenuitem>.
</para>

<para>
The style of the extensions can be configured in the <xref
linkend="panel-extensions"/> section of &kicker;'s preferences.
</para>


<sect1 id="external-taskbar-extension">
<title>The External Taskbar Panel Extension</title>

<para>
The external taskbar is just the same as the taskbar applet with the
only difference that it provides its own panel. Refer to the <link
linkend="taskbar-applet">taskbar applet section</link> for help about
it.
</para>

</sect1>

<sect1 id="child-panel-extension">
<title>The Child Panel Extension</title>

<para>
This is just a panel like &kicker; itself, where you can add all the
stuff &kicker; is also capable. So you can have as many &kicker;s as you
want. Just add a child panel and add applications and applets to it.
</para>

</sect1>

<sect1 id="kasbar-extension">
<title>The <application>KasBar</application> Extension</title>

<para>
The <application>KasBar</application> is an iconic replacement of the
taskbar. It always shows the icons of all currently running applications
on any desktop, they can be chosen by clicking with the &LMB;. The
active window is highlighted, minimized windows will show a little
triangle pointing downwards instead of the square in the lower right of
the icons. A triangle pointing to the right indicates that the
application is shaded.
</para>
</sect1>

<sect1 id="dock-application-bar-extension">
<title>The Dock Application Bar Extension</title>

<para>
The Dock Application Bar is an external bar which lets WindowMaker
applications be docked. Just run your dockable WindowMaker programs, if
the Dock Application Bar is running, they will be automatically docked.
</para>
</sect1>

</chapter>

<chapter id="commands">
<title>Command Reference</title>

<sect1 id="keybinding">
<title>The Panel</title>

<para>
There is only one standard shortcut available in &kicker;:
</para>

<variablelist>
<varlistentry>
<term><keycombo action="simul">&Alt;<keycap>F1</keycap></keycombo></term>
<listitem>
<para>
Opens the <guimenu>TDE</guimenu> Menu
</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

</chapter>

<chapter id="faq">
<title>Questions and Answers</title>

<qandaset>
<qandaentry>
<question>
<para>
How can I add applications, applets or anything else to the panel?
</para>
</question>
<answer>
<para>
Click the &RMB; on any free space in &kicker; and choose
what you want to add. See in <link linkend="basics">&kicker; Basics</link>
for more about that.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>
Can I have an external Taskbar just like in &tde; 1?
</para>
</question>
<answer>
<para>
Yes, you can just click the &RMB; on any empty space in &kicker; and
then choose <guisubmenu>Add</guisubmenu>,
<guisubmenu>Panel</guisubmenu> and the <guimenuitem>External
Taskbar</guimenuitem>.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>
How can I move &kicker; to another screen border?
</para>
</question>

<answer>
<para>
Simply drag it by holding the &LMB; on any empty space in &kicker; to
any screen border.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>
How can I move extensions to another screen border?
</para>
</question>

<answer>
<para>
Just drag them by holding the &LMB; on the small
<guibutton>handles</guibutton> on the left or the top of the extension.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>
I want the taskbar to show all applications I am running, independent on
which desktop they are. Is that possible?
</para>
</question>
<answer>
<para>
It is. Click the &RMB; on the small <guibutton>handle</guibutton> of the
taskbar, then choose <guimenuitem>Configure Taskbar...</guimenuitem> and check
<guilabel>Show windows from all desktops</guilabel> in the appearing dialog.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>
How can I access the <guimenu>TDE</guimenu> Menu without using the mouse?
</para>
</question>
<answer>
<para>
Simply press <keycombo
action="simul">&Alt;<keycap>F1</keycap></keycombo> and it will appear.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>
Is there a way to add a menu containing all desktop icons to &kicker;?
</para>
</question>
<answer>
<para>
Just start &konqueror;, go to your home folder and drag the
<guiicon>Desktop</guiicon> icon to any free space of &kicker;, then
choose <guimenuitem>Add as Quick Browser</guimenuitem> from the
appearing menu.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>
How can I change the color and style of &kicker;?
</para>
</question>
<answer>
<para>
You can change the colors of the panel with the global color module of
the <application>Control Center</application> or you can style the panel
itself, see in <xref linkend="panel-appearance"/> for more about that.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>
Why is the clock showing the wrong time?
</para>
</question>
<answer>
<para>
On some &RedHat;systems, the clock always shows the time in
&GMT;. This is a bug in the system setup, and not
directly related to &kicker;. However, to solve it, just create this
symbolic link: <userinput><command>ln</command> <option>-s</option>
<filename>/usr/share/zoneinfo</filename>
<filename>/usr/lib/zoneinfo</filename></userinput>.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>
Is it possible to change the <guiicon>T</guiicon> button of the panel to
another picture?
</para>
</question>
<answer>
<para>
Look for <filename>$HOME/.trinity/share/apps/kicker/pics/go.png</filename>
and <filename>$HOME/.trinity/share/apps/kicker/pics/mini/go.png</filename>
and replace them. Do not forget to flatten the replacements to one
layer, or else you will not see anything. Create the folders if
they do not already exist. Then restart &kicker;.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>
Why is my <guisubmenu>Settings</guisubmenu> menu not working?
</para>
</question>
<answer>
<para>
Your menu entries may be mixed up for some reason. Simply run
<command>tdebuildsycoca</command> on a commandline.
</para>
</answer>
</qandaentry>
</qandaset>

&reporting.bugs;
<!-- &updating.documentation; -->

</chapter>

<chapter id="credits">

<title>Credits and License</title>

<para>
&kicker;
</para>

<para>
Program copyright 1999-2000 The &kde; Team <ulink
url="http://www.kde.org"> (www.kde.org)</ulink>.
</para>

<itemizedlist>
<listitem>
<para>&Matthias.Elter; &Matthias.Elter.mail;
</para>
</listitem>

<listitem>
<para>&Matthias.Ettrich; &Matthias.Ettrich.mail;
</para>
</listitem>

<listitem>
<para>&Wilco.Greven; &Wilco.Greven.mail;
</para>
</listitem>

<listitem>
<para>&Rik.Hemsley; &Rik.Hemsley.mail;
</para>
</listitem>

<listitem>
<para>&Daniel.M.Duley; &Daniel.M.Duley.mail;
</para>
</listitem>

<listitem>
<para>&Preston.Brown; &Preston.Brown.mail;
</para>
</listitem>

</itemizedlist>

<para>Original documentation copyright 2001, 2002 &Dirk.Doerflinger;
&Dirk.Doerflinger.mail;</para>
<para>Portions copyright 2004 &Orville.Bennett;
<email>&Orville.Bennett.mail;</email></para>
<para>Portions copyright 2005 Titus Laska
<email>titus.laska@gmx.de</email></para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

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

</chapter>

&documentation.index;

</book>