summaryrefslogtreecommitdiffstats
path: root/tde-i18n-en_GB/docs/tdebase/kicker/index.docbook
blob: 9cf5f095c42c6d37fa1e70e70fd7a82865f5823c (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
<?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 % British-English "INCLUDE">
]>

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

<book lang="&language;">

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

<authorgroup>
<author>&Dirk.Doerflinger; &Dirk.Doerflinger.mail;</author>
<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> 
</authorgroup>

<copyright>
<year>2001</year><year>2002</year>
<holder>&Dirk.Doerflinger;</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2002-03-01</date>
<releaseinfo>3.00.00</releaseinfo>

<abstract>
<para>&kicker; is the &kde; 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>KDE</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 K Desktop Environment. Besides the <guimenu>K</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. Please report any problems or feature requests to the &kde; mailing lists. </para>

</chapter>

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

<para>This is what you see on a freshly installed &kde;, assuming that you skipped <application>KPersonaliser</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's 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>Here's a screenshot of the left side of &kicker; </para>
</caption>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo>And here's the right side</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="screenshot_right.png" format="PNG"/></imageobject>
<textobject>
<phrase>Screenshot Right</phrase>
</textobject>
<caption>
<para>And here's the right side </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 &kde; 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>K</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>K</guimenu> Menu</term>
<listitem>
<para>It is used for launching applications and some other useful things. Refer to <link linkend="k-menu">The <guimenu>K</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 Dialogue</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. As always, more information in <link linkend="applets">Applets</link>. </para>
</listitem>

</varlistentry>
<varlistentry>
<term>Lock/Logout</term>
<listitem>
<para>This applet contains two small buttons. The one with the luggage lock on it locks your session if you ever leave your &kde; unattended and don't want anybody else to have access to it; the other one shuts down &kde; and the X-Server. </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;. There are also more useful apps for the system tray. You can click the applications either with the <mousebutton>left</mousebutton> or the <mousebutton>right</mousebutton> mousebutton and see what's happening. </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</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</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 <guimenu>context menu</guimenu> or from <guisubmenu>Configure Panel</guisubmenu> in the <guimenu>K</guimenu> Menu. </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. This works also from the <guimenu>K</guimenu> Menu with any entry. You can change the attributes like optional command line parameters or the icon by clicking it with the <mousebutton>right</mousebutton> mouse button and choosing <guimenuitem>Preferences</guimenuitem> from the <guimenu>context menu</guimenu>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>Using the context menu to add a &kde; application</term>
<listitem>
<para>Click the <mousebutton>right</mousebutton> mousebutton on any free space in &kicker; and choose <guisubmenu>Add</guisubmenu> and then <guisubmenu>Button </guisubmenu>. There you can choose an application which will be added in the place you clicked. </para>
</listitem>
</varlistentry>

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

<para>Click the <mousebutton>right</mousebutton> mousebutton on any free space in &kicker; and choose <guisubmenu>Add</guisubmenu>, <guisubmenu>Special Button</guisubmenu> and then <guimenuitem>Non-KDE Application </guimenuitem>. Choose the application you want to add. In the newly appearing window, you can append an <guilabel>optional command line</guilabel>, 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</guimenuitem> or <guimenuitem>Remove</guimenuitem>. You can also move an icon by clicking &MMB; if you have one. Another way to remove an application is by clicking the &RMB; on any free space and then choosing <guisubmenu>Remove</guisubmenu>, <guisubmenu>Button</guisubmenu> and then the application you want to be removed. </para>

<!-- NOTE: Lauri: I'd say it would confuse users if I'd mention Non-KDE-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 <guimenu>context menu</guimenu> or the <guimenu>K</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. Omitting this menu, it will be added as a file manager <acronym>URL</acronym>. </para>

<variablelist>
<varlistentry>
<term>Add as file manager &URL;</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>Add as Quick Browser</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 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 Dialogue</link>. Quick Browsers can also be added from the <guimenu>context menu</guimenu> of &kicker; and then choosing <guisubmenu>Add</guisubmenu> and <guisubmenu>Special Button</guisubmenu>. </para>
</listitem>
</varlistentry>

</variablelist>

<para>Both kinds of folders can be moved or removed by &RMB; click and choosing <guimenuitem>Move</guimenuitem> or <guimenuitem>Remove</guimenuitem>. You can also move an icon by clicking &MMB; if you have one. Another way to remove a folder is by clicking the &RMB; on any free space and then choosing <guisubmenu>Remove</guisubmenu>, <guisubmenu>Button</guisubmenu> and then the folder you want to be removed. </para>

<para>File manager &URL;s can also be configured from the <guimenu>context-menu</guimenu>, just like any other folder anywhere in &kde; </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 <guisubmenu>Add</guisubmenu> and then <guisubmenu>Special Button</guisubmenu> of the <guimenu>context-menu</guimenu>. </para>

<variablelist>
<varlistentry>
<term>The <guimenu>K</guimenu> Menu 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>K</guimenu> Menu, which you can learn more about in <link linkend="k-menu">The TDE Menu</link>. </para>
</listitem>
</varlistentry>


<varlistentry>
<term>The Window List</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 the name of a desktop will switch to that one, clicking an application will also activate it. </para>

</listitem>
</varlistentry>

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

<varlistentry>
<term>The Recent Documents 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 (works only with &kde; 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>The Desktop Access Icon</term>
<listitem>
<para><guiicon><inlinemediaobject><imageobject><imagedata fileref="desktop_icon.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> The <guiicon>Desktop Access icon</guiicon> lets you have quick access to all the things you have on your desktop by minimising all currently open applications. Clicking it once will toggle it to show the desktop. The <guiicon>icon</guiicon> will remain pressed until you either click it again, what will restore your minimised apps, or reactivate an application from the taskbar. </para>
</listitem>
</varlistentry>

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

<varlistentry>
<term>The Non-KDE Application Item</term>
<listitem>
<para>The <guimenuitem>Add Non-KDE Application</guimenuitem> lets you add an application which doesn't appear in the <guimenu>K</guimenu> menu to &kicker;. Refer to <link linkend="adding-apps">Adding Applications</link> for more information about Non-&kde; Applications. </para>
</listitem>
</varlistentry>


<varlistentry>
<term>The Terminal Sessions 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 Printing System Icon</term>
<listitem>
<para><guiicon><inlinemediaobject><imageobject><imagedata fileref="printsys_icon.png" format="PNG"/></imageobject></inlinemediaobject></guiicon>This icon gives you direct access to &kde;'s printing system. Clicking the &LMB; on the icon opens a menu which gives you the following options: <itemizedlist>
<listitem><para><guimenuitem>Add Printer...</guimenuitem>:This will start &kde;'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 dialogue.</para>
</listitem>

<listitem>
<para><guimenuitem>Configure Server</guimenuitem></para>

</listitem>

<listitem><para><guimenuitem>Print Manager</guimenuitem>This item starts the Printing Manager, &kde;'s main printing control centre.</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 a file...</guimenuitem>This item opens a dialogue which lets you easily print one or more files.</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, no means if it's for an application, a folder or a special icon, or clicking the small arrow on the handle, and then choosing <guimenuitem>Remove</guimenuitem> from the appearing <guimenu>context menu</guimenu> 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</guimenuitem> and then <guimenuitem>Button</guimenuitem> or <guimenuitem>Special Button</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. Those can be added either from the submenu <guisubmenu>Configure Panel</guisubmenu> of the <guimenu>K</guimenu> Menu or from the <guimenu>context menu</guimenu> by choosing <guisubmenu>Add</guisubmenu> and then <guisubmenu>Applet</guisubmenu>. </para>

<para>Applets can be moved by dragging them on their handle with holding the &LMB; mouse button, or the &MMB; mouse button, or by choosing <guimenuitem>Move</guimenuitem> from the <guimenu>context menu</guimenu>. </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 <guimenuitem>Remove</guimenuitem> from the <guimenu>context menu</guimenu>, which appears when the &RMB; is clicked on the applet's handle (left or top side of the applet) or in some applets allover the applet. The same <guimenu>menu</guimenu> appears when clicking the small arrow on the applet's handle. </para>


</sect2>

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

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

<para>All extensions can be moved to any border of the screen by dragging them with the &LMB; on the small fade-out handles on the left or top side of the extensions. These fade-out handles can also be used for fading out the extension. The child panel can also be dragged by clicking with the &LMB; on any empty space on it. </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 <guimenu>context menu</guimenu>, usually located in the fade-out handles. </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 <guimenu>context menu</guimenu>. Usually applications and folders have the same preferences as in &konqueror;. Only the applications which are located in the <guimenu>K</guimenu> Menu (for experienced users: those which have a <literal role="extension">*.desktop</literal> in the <filename class="directory">applnk</filename> dir) have a special kind of config dialogue. </para>

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

<para>Here you can see some stats 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 analogue one in the <guimenu>K</guimenu> Menu. </para>

</sect2>

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

<para>Here you can set 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="execute-tab">
<title>The <guilabel>Execute</guilabel> Tab</title>

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

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

</sect2>

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

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

<para>In the <guilabel>File Types</guilabel> section you can choose what kinds of filetypes are handled by this application. Please refer to &konqueror; handbook for more about this. </para>

</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 the applets are described in their <link linkend="applets">sections</link> </para>

<para>You can change the settings by either clicking <guimenuitem>Settings</guimenuitem> in the <guimenu>context menu</guimenu> or the submenu <guisubmenu>Configure Panel</guisubmenu> of the <guimenu>K</guimenu> Menu or in the &kcontrol; in the module <guilabel>Look &amp; Feel</guilabel>. </para>

<note>
<para>Please note that the settings in the <guilabel>General</guilabel> and the <guilabel>Look &amp; Feel</guilabel> tabs only affect to the main panel while the behaviour of extensions is set in the <guilabel>Extensions</guilabel> tab. </para>
</note>


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

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

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

<para>In the <guilabel>Panel Location</guilabel> frame you can choose which screen border the panel should be attached to. Please note that usually the available space is used more efficiently if the panel is aligned horizontally, &ie; attached to the top or bottom screen border. 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>The <guilabel>Alignment</guilabel> group lets you define, where &kicker; is located when the size is set to less than 100%. This can also be done by dragging &kicker; with the &LMB; to the place you want to have it. </para>

<para>The panel's style can be tiny, small, medium or large. Depending on which applets you use you may find that some applets work better at different panel sizes. You can also change the size by moving the mousepointer over the upper border of &kicker; (assuming &kicker; is at the bottom of your screen) and dragging it while holding the &LMB;. When you do that, the style settings will switch to <guilabel>Custom</guilabel> </para>

<note>
<para>Please note, that switching manually to <guilabel>Custom</guilabel> doesn't have any effect and otherwise that you don't need to switch to custom to be able to resize &kicker; manually. </para>
</note>

<para>Some people may not want to have &kicker; take the whole width or height of their screen. The slider <guilabel>Percentage of desktop width/height to be used</guilabel> changes this behaviour. If you decrease the percentage, &kicker; will either appear aligned left or top of the screen, depending on its location. Checking the checkbox <guilabel>Expand to fit required size</guilabel> makes sure that &kicker; is at least as big as needed to show every icon and applet. </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 an auto hide feature. When this feature is enabled, the panel will hide when the mouse cursor has not been moved over it for a configurable amount of time. If you move the mouse to the panel's screen border it will show up again. Check the <guilabel>Enable automatic hide</guilabel> option in the <guilabel>Automatic Hide</guilabel> frame to enable this feature. Using the <guilabel>Delay in seconds</guilabel> slider you can configure the amount of time the panel will wait before it hides. The checkbox <guilabel>Show panel when switching desktop</guilabel> makes sure that the panel will be shown on the new chosen desktop. 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>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>Using the <guilabel>Manual Hide Animation</guilabel> (for the hide buttons) and <guilabel>Auto Hide Animation</guilabel> (for the auto hide functionality) options you can configure whether the panel will softly slide away or just disappear. You can enable or disable both animations using the <guilabel>Enable</guilabel> options and you can change the speed of the animation using the sliders. </para>

</sect2>

<sect2 id="panel-looknfeel">
<title><guilabel>Look &amp; Feel</guilabel></title>

<para>Using the <guilabel>Look &amp; Feel</guilabel> tab you can configure the panel's overall appearance. </para>

<para>The &kde; panel supports so-called <quote>tiled buttons</quote>. This means that the buttons shown on the panel will be drawn using configurable images. To enable button tiling, check the <guilabel>Enable background tiles</guilabel> option in the <guilabel>Look &amp; Feel</guilabel> tab. Then you can configure tiles for certain kinds of buttons. </para>

<para>For every kind of panel button there is a frame offering an <guilabel>Enabled</guilabel> option to enable or disable tiled images. If tiles are enabled for this kind of button, you can choose a tile in the combo box below and the box on the right will show a preview of this tile. </para>

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

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

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

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

<varlistentry>
<term>
<guilabel>Legacy Application Tiles</guilabel>
</term>
<listitem>
<para>The icons for legacy applications will be displayed as tiles </para>
</listitem>
</varlistentry>

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

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

<para>Enabling the switch <guilabel>Enable icon zooming</guilabel> will give you the effect that &kicker;'s icons will grow bigger when hovering with the mouse. This effect will not appear when the size of &kicker; is set bigger than <guilabel>medium</guilabel>. </para>

<para>If <guilabel>Show tooltips</guilabel> is checked, small descriptions of the icons or applets will be shown when the mousepointer rests over an icon for some seconds. </para>

<para>The <guilabel>Background Image</guilabel> 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 line edit box below or choose one by clicking on the <guibutton>Browse</guibutton> button. You'll see a preview of the selected picture on the right. </para>



</sect2>

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

<para>In the <guilabel>Menus</guilabel> tab you can configure the panel menu's behaviour. This affects the <guimenu>K</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 <guilabel>TDE Menu Layout</guilabel> frame offers you some options to configure the <guimenu>K</guimenu> menu's functionality. The <guilabel>Show &quot;Bookmarks&quot; submenu</guilabel> and <guilabel>Show &quot;Recent Documents&quot; submenu</guilabel> options will enable submenus showing your <application>konqueror</application> bookmarks and the last documents you've opened using &kde; applications respectively. The <guilabel>Show &quot;Quick Browser&quot; submenu</guilabel> option will enable a browser menu. Enabling the <guilabel>Show side image</guilabel> checkbox will display a neat image on the left side of the <guimenu>K</guimenu> menu. If the option <guilabel>Detailed menu entries</guilabel> is set, th <guimenu>K</guimenu> menu will show a small description besides the name of the application. </para>
<para>Within the <guilabel>TDE Menu Layout</guilabel> you can also define which dynamic menus should be displayed in the <guimenu>K</guimenu> menu by moving them from <guilabel>Available Menus</guilabel> to <guilabel>Selected Menus</guilabel> using the <guibutton>&lt;&lt;</guibutton>. They can be removed the same way by using the <guibutton>&gt;&gt;</guibutton>. </para>

<para>In the <guilabel>Browser Menus</guilabel> frame 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 browser menu; the latter option may be especially useful if you have a rather small screen resolution, as the browser menus would otherwise quickly fill up your screen when you browse folders containing many files. </para>

<para>The quick start section in the <guimenu>K</guimenu> menu offers quick access to programs you have used often or recently. In the <guilabel>&quot;Quick Start&quot; section contains</guilabel> frame you can choose whether this section will show the most recently or the most frequently used programs. Using the option <guilabel>Max number of &quot;Quick Start&quot; entries</guilabel> you can configure how many programs the quick start section will remember. </para>

</sect2>


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

<para>Applets are small plugins that extend the panel's functionality. &kde; 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 &kde; 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're 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 &kde; 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>

<sect2 id="panel-extensions">
<title>Extensions</title>
<para>In this section you can change the behaviour of the <xref linkend="extensions"/>. Simply choose one of your extensions (&eg; Child Panel) from the listbox on the left side and adjust its settings. Those are very similar to the settings on the <xref linkend="panel-general"/> and the <xref linkend="panel-looknfeel"/> tabs. </para>

<para>The <guilabel>Panel Location</guilabel> group sets the location of the chosen extension. If the option <guilabel>Enable automatic hide</guilabel> is checked, the extension will be faded out automatically after the time in seconds set with the slider <guilabel>Delay in seconds</guilabel>. Marking the checkbox <guilabel>Show panel when switching desktop</guilabel> lets the extension show up after a desktop change. </para>

<para>You can toggle which hide buttons the chosen extension should have with the checkboxes in the group <guilabel>Hide Buttons</guilabel>. The slider <guilabel> Hide Button Size</guilabel> sets the size of the appearing hide buttons. </para>

</sect2>

</sect1>

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

<para>This section changes the settings of the taskbar. Changes affect the external taskbar and also taskbar applets on &kicker; or child-panels. </para>


<variablelist>
<varlistentry>
<term>Show all windows</term>
<listitem>
<para>If this box is checked, the taskbar will show all running apps of every desktop. Otherwise, only the applications of the current desktop are shown. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>Show windows list button</term>
<listitem>
<para>Checking this box will show the small <guibutton>window list button</guibutton>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>Group similar tasks</term>
<listitem>
<para>
<inlinemediaobject><imageobject><imagedata fileref="taskbar_group.png"
format="PNG"/></imageobject></inlinemediaobject> This is a feature introduced in &kde; version 2.2. If the option <guilabel>Group similar tasks</guilabel> is set, several instances of the same application are grouped together in one taskbar button. </para>

<para>You can define the mouse actions of the taskbar buttons with the settings in the <guilabel>Actions</guilabel>. Each action can be one of the following:</para>

<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>Maximise All</guimenuitem>, <guimenuitem>Minimise All</guimenuitem> and <guimenuitem>Restore All</guimenuitem> which appends those actions to all applications of that group. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Cycle Through Windows</guilabel></term>
<listitem><para>If this action is chosen, each click with the mousebutton on the <guibutton>taskbar button</guibutton> will activate one of that group's applications, one after each others.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Activate Task</guilabel></term>
<listitem>
<para><guilabel>Activate Task</guilabel>: 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>Minimise Task</guilabel></term>
<listitem>
<para>The first application of that group will be minimised. If it is already minimised, it will be restored again.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Please note that some of these settings only have effect if a taskbar button contains more than one application. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>Sort tasks by virtual desktop</term>
<listitem>
<para>Checking this box will sort all <guibutton>taskbar buttons</guibutton> in a group for each desktop, otherwise they are sorted by the order they are started. This will not affect grouped tasks if they are spread over more than one desktop. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>Show application icons</term>
<listitem>
<para>If this box is checked, every <guibutton>taskbar button</guibutton> will have the icon of the running application beside its title. </para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

</chapter>

<chapter id="k-menu">
<title>The <guimenu>K</guimenu> Menu</title>

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

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

<sect1 id="kde-group">
<title>The <acronym>KDE</acronym> Group</title>

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

<variablelist>
<varlistentry>
<term><guimenuitem>Logout</guimenuitem></term>
<listitem>
<para>This entry is used to finish the &kde; 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><guisubmenu>Configure Panel</guisubmenu></term>
<listitem>
<para>In this submenu 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) and start the <application>Menu Editor</application>. You can also reach the <guisubmenu>Help</guisubmenu> Menu, but as you are reading this, you probably found it yourself. </para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

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

<para>This will bring up a small but powerful application start dialogue. </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</guibutton> button which will bring up some starting options to the command window. </para>

<variablelist>
<varlistentry>
<term><guilabel>Run in terminal</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>Scheduler</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 <guilabel>Realtime</guilabel>. 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>Realtime</guilabel>. </para>

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

</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="browsers">
<title>Browsers</title>

<para>This group contains some very useful browsers. It can also contain 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 &kde; 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 Application 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 the option <guilabel>Detailed menu entries</guilabel> is enabled in the settings. </para>
</sect1>

<sect1 id="most-recently-group">
<title>The most recently used applications</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 <guimenu>context menu</guimenu> or from the submenu <guisubmenu>Configure Panel</guisubmenu> by choosing <guisubmenu>Add</guisubmenu> and the <guisubmenu>Applet</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 minimised, the title displayed in the taskbar will fade to grey. </para>

<tip>
<para>If you click on the button of the active application, it will be minimised. This means also that if you click twice on an inactive application, it will also be minimised. </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 behaviour. 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 desktops and lets you also choose by a click with the &LMB; which desktop you want to use. </para>

<para>There is also a very useful <guimenu>context menu</guimenu>: </para>

<variablelist>
<varlistentry>
<term><guimenuitem>Preview</guimenuitem></term>
<listitem>
<para>This option lets the mini pager appear as a tiny preview of the desktops with symbolic rectangles for the running applications. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Number</guimenuitem></term>
<listitem>
<para>If this option is chosen, the pager will show the numbers of the desktops </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Name</guimenuitem></term>
<listitem>
<para>This will let the pager show the names of the desktops, which can be set in the preferences or from <application>Control Centre</application>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Enable Desktop Preview</guimenuitem></term>
<listitem>
<para>If this option is checked, a small button will be shown which shows a bigger preview of the running desktops. If you click an application in that preview, it will be activated. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Preferences</guimenuitem></term>
<listitem>
<para>Here you can set the number of desktops you want to have and the names of them. </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 <guimenu>context menu</guimenu>. </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>Analogue</term>
<listitem>
<para>If this is set, the clock will be displayed as an old styled analogue 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="clock-preferences">
<title><guimenuitem>Preferences</guimenuitem></title>

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

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

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

<varlistentry>
<term>The <guilabel>Plain Clock</guilabel> Tab</term>
<listitem>
<para>In the <guilabel>Options</guilabel> section you can check if you want to have the date and/or the seconds shown. In <guilabel>Colours</guilabel> you can choose if you want the common &kde; look or your own custom colours and font. </para>
</listitem>
</varlistentry>

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

<varlistentry>
<term>The <guilabel>Analogue Clock</guilabel> Tab</term>
<listitem>
<para>In the <guilabel>Options</guilabel> section you can check if you want to have the date and/or seconds shown. In <guilabel>Colours</guilabel> you can choose if you want the common <acronym>LCD</acronym>-Look or your own custom colours. 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. <guilabel>Draw Frame</guilabel> will display the clock a little bit sunken in the panel. </para>
</listitem>
</varlistentry>

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

</variablelist>

</sect2>

<sect2 id="adjust-time">
<title><guimenuitem>Adjust Date and Time</guimenuitem></title>

<para>This option starts the <guilabel>Country &amp; Language</guilabel> configuration module of the &kcontrol;.</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 and Time Format</guimenuitem></title>

<para>This will open the Date and Time module of &kcontrol; where you can set your formats. There aren't any special permissions needed for that. </para>

</sect2>

<sect2 id="copy-date">
<title><guisubmenu>Copy</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>

</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 <guimenu>context menu</guimenu>. The <guimenu>context menu</guimenu> 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 like &eg; &klipper; or &kteatime;. </para>
</sect1>

<sect1 id="lockout-applet">
<title>Lock/Logout Applet</title>
<para>This little applet contains two buttons. The <guibutton>luggage lock</guibutton> is used to lock the session if you ever want to leave your &kde; unattended and don't want anybody to access it. The <guibutton>off switch</guibutton> is used to close your &kde; 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 dialogue. 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>Extensions</title>

<para>There are also some features that run outside of &kicker;, the extensions. They are added from the submenu <guisubmenu>Configure Panel</guisubmenu> of the <guimenu>K</guimenu> Menu or the <guimenu>context menu</guimenu> by choosing <guisubmenu>Add</guisubmenu> and then <guisubmenu>Extensions</guisubmenu>. You can move them to any screenborder by dragging them at the small <guibutton>fadeout </guibutton> on their side and remove it by right clicking on that button and choose <guimenuitem>Remove</guimenuitem>. Clicking these buttons with the &LMB; fades the extension out or in, just like the main &kicker;. </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 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, minimised 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>K</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 <guisubmenu>Add</guisubmenu>. From appearing submenu you can 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 &kde; 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>Extension</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 it 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'm running, independent on which desktop it is. Is that possible? </para>
</question>
<answer>
<para>Yes, click the &RMB; on the small <guibutton>handle</guibutton> of the taskbar, then choose <guimenuitem>Preferences</guimenuitem> and check <guilabel>Show all windows</guilabel> in the appearing dialogue. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>How can I access the <guimenu>K</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 fire up &konqueror;, go to your home folder and drag the <guiicon>KDesktop</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 colour and style of &kicker;? </para>
</question>
<answer>
<para>You can change the colours of the panel with the global colour module of the <application>Control Centre</application> or you can style the panel itself, see in <xref linkend="panel-looknfeel"/> 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 <acronym>GMT</acronym>. 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>K</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; </chapter>

<chapter id="credits">

<title>Credits and Licence</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>Documentation copyright 2001, 2002 &Dirk.Doerflinger; &Dirk.Doerflinger.mail;</para>
&underFDL; &underBSDLicense; </chapter>

&documentation.index;

</book>