add more spacing
[personal-kdebase.git] / runtime / doc / faq / panel.docbook
blobcf20fd13a3b990b9f188655aac87fafb1a73dc79
1 <!--
2 <?xml version="1.0" ?>
3 <!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
4  "dtd/kdex.dtd">
5 -->
8 <chapter id="panel">
9 <title>The panel</title>
12 <qandaset>
13 <qandaentry>
14 <question>
15 <para>How do I add applications to the &kde; panel (&kicker;)?</para>
16 </question>
17 <answer>
18 <para>There are several ways to add an application to the panel, of
19 which the easiest is to right-click on the panel, and from the context
20 menu which appears, select <menuchoice><guimenu>Panel
21 Menu</guimenu><guisubmenu>Add to
22 Panel</guisubmenu><guisubmenu>Application
23 Button</guisubmenu></menuchoice> and then the application for which
24 you want to add a link.</para> <para>For more ways of adding buttons
25 to the panel, refer to the &kicker; Handbook.</para>
27 </answer>
28 </qandaentry>
31 <qandaentry>
32 <question>
33 <para>Is it possible to change the <guibutton>K</guibutton> button of
34 the panel to another picture?</para>
35 </question>
36 <answer>
37 <para>The simplest way is to download a new icon theme with a &kmenu; icon
38 you prefer from 
39 <ulink url="http://www.kde-look.org">http://www.kde-look.org</ulink> and 
40 install it using the &kcontrolcenter;.</para>
41 <para>In order to change only the &kmenu; icon you can overwrite the
42 <filename>kmenu.png</filename> image for every size in an icon theme set.
43 So, for &kde; default icons this would be <filename>$<envar>KDEDIR</envar>/share/icons/default.kde/<replaceable>size</replaceable>/apps/kmenu.png</filename>,
44 where <replaceable>size</replaceable> is one of the sizes included in the
45 &kde; icon theme. To see your new icon, either log out of &kde; and back in again, or run the command <command>dcop</command><option>kicker kicker restart</option> to restart the panel.
46 </para>
47 </answer>
48 </qandaentry>
50 <qandaentry>
51 <question>
52 <para>
53 After an upgrade my &kmenu; appears to be empty! How can I get my menu back?
54 </para>
55 </question>
56 <answer>
57 <para>
58 In &kde; 3.2 and later local modifications to the &kmenu; are stored
60 <filename>$<envar>HOME</envar>/.config/menus/applications-kmenuedit.menu
61 </filename>. Try moving this file out of the way and then issuing the
62 command <userinput><command>kbuildsycoca4</command>
63 <option>--noincremental</option></userinput>. This should restore you to the
64 default system menus.
65 </para>
66 </answer>
67 </qandaentry>
69 <qandaentry>
70 <question><para>My desktop panel has disappeared. How can I get it
71 back?</para>
72 </question>
74 <answer>
76 <para>The panel disappearing is usually due to it crashing. This is
77 most often caused by loading an applet that has a fatal bug or due to
78 a bad installation of &kde; and/or the panel.</para>
80 <para>The easiest way to get the panel back is to launch the
81 <guilabel>Run Command</guilabel> window by pressing <keycombo
82 action="simul">&Alt;<keycap>F2</keycap> </keycombo> and entering
83 <userinput><command>kicker</command></userinput> and then pressing the
84 <guibutton>OK</guibutton> button.</para>
86 <para>If the panel continues to disappear, you may wish to either
87 remove or edit by hand your
88 <filename>$<envar>KDEHOME</envar>/share/config/kickerrc</filename>
89 file, where <filename
90 class="directory">$<envar>KDEHOME</envar></filename> is usually
91 <filename class="directory">~/.kde</filename>. If you choose to edit
92 it by hand, start by removing the applet entry groups.</para>
94 </answer>
95 </qandaentry>
97 <qandaentry><question>
98 <para>Where did the Icon Zooming option that used to be in &kicker; go?
99 </para></question>
100 <answer><para>
101 Icon zooming was not actively maintained and had caused severe bugs and usability issues. It was replaced in &kde; 3.4 by the new mouse over effects, which combine esthetics with useful information.
102 </para></answer>
104 </qandaentry>
106 <qandaentry>
107 <question><para>How can I start an application minimized to the system
108 tray?</para>
109 </question>
110 <answer>
111 <para>Use <command>ksystraycmd</command>. For example, to start a &konsole; hidden
112 in the system tray, run <userinput><command>ksystraycmd </command>
113 <option>--hidden</option> <command>konsole</command></userinput>. For
114 more information about <command>ksystraycmd</command>, see the section
115 <quote>Advanced Window Management</quote> in the &kde;
116 User Guide.</para>
117 </answer>
118 </qandaentry>
120 <qandaentry>
121 <question><para>How do I use the &Windows; key to open the &kmenu;?</para>
122 </question>
124 <answer><para>Previous versions of &kde; provided a trick to allow you to
125 use the &Windows; key both as a modifier (so you could have shortcuts
126 like <keycombo action="simul"><keysym>Win</keysym><keycap>R</keycap>
127 </keycombo>), and as a regular key (so that pressing
128 <keysym>Win</keysym> on its own could open the &kmenu;). This feature
129 was removed for reasons of usability and accessibility, as well as
130 keeping the code clean. For current versions of &kde;, you have two
131 options: either use a different shortcut to open the &kmenu; (the
132 default is <keycombo action="simul">&Alt;<keycap>F1</keycap>
133 </keycombo>), or remap the <keysym>Win</keysym> key to be a regular
134 key, rather than a modifier.</para>
136 <para>If you choose to do the second, here's one way:
138 <orderedlist>
139 <listitem><para>Find the keycode for your <keysym>Win</keysym> key
140 using <command>xev</command>: Run the command
141 <userinput><command>xev</command></userinput> in a &konsole;, and
142 press the <keysym>Win</keysym> key. Look in the output of
143 <command>xev</command> for
144 <computeroutput>keycode <replaceable>n</replaceable></computeroutput>,
145 where <replaceable>n</replaceable> is the keycode of the
146 <keysym>Win</keysym> key.</para>
147 </listitem>
149 <listitem><para>Use <command>xmodmap</command> to remap the
150 <keysym>Win</keysym> key. An appropriate command is <userinput><command>xmodmap
151 <option>-e</option> 'keycode
152 <replaceable>n</replaceable>=Menu'</command></userinput>.</para>
153 </listitem>
155 <listitem><para>In the &kcontrolcenter;, go to
156 <menuchoice><guimenu>Regional &amp;
157 Accessibility</guimenu><guimenuitem>Keyboard Shortcuts</guimenuitem>
158 </menuchoice> and set the shortcut for <guilabel>Popup Launch
159 Menu</guilabel> to the <keysym>Win</keysym> key. You should now be
160 able to popup the &kmenu; by pressing the <keysym>Win</keysym> key.</para>
161 </listitem>
163 <listitem><para>One more step is required to save the changes across
164 settings: Create a file <filename>~/.kde/env/win-key.sh</filename>
165 (create the directory if it doesn't exist), and add the
166 <command>xmodmap</command> command you used previously to it. The
167 change should now be applied every time you start &kde;.</para>
168 </listitem>
169 </orderedlist>
170 </para>
171 </answer>
172 </qandaentry>
174 </qandaset>
175 </chapter>
177 <!-- Keep this comment at the end of the file
178 Local variables:
179 mode: xml
180 sgml-omittag:nil
181 sgml-shorttag:nil
182 sgml-namecase-general:nil
183 sgml-general-insert-case:lower
184 sgml-minimize-attributes:nil
185 sgml-always-quote-attributes:t
186 sgml-indent-step:0
187 sgml-indent-data:true
188 sgml-parent-document:("index.docbook" "book" "chapter")
189 sgml-exposed-tags:nil
190 sgml-local-catalogs:nil
191 sgml-local-ecat-files:nil
192 End: