diff options
Diffstat (limited to 'doc/kicker/index.docbook')
| -rw-r--r-- | doc/kicker/index.docbook | 2434 |
1 files changed, 2434 insertions, 0 deletions
diff --git a/doc/kicker/index.docbook b/doc/kicker/index.docbook new file mode 100644 index 000000000..bc7333c72 --- /dev/null +++ b/doc/kicker/index.docbook @@ -0,0 +1,2434 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY package "kdebase"> + <!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> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<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> + +<legalnotice>&FDLNotice;</legalnotice> + +<date>2006-06-15</date> +<releaseinfo>3.5.2</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>kdebase</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>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 &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 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>K</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 &kde; 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-&kde;-application</term> +<listitem> +<para> +Non-&kde;-applications ⪚ +<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-KDE +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-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 context +menu 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. +</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 +&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 <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>K Menu</guilabel> Icon</term> +<listitem> +<para> +<guiicon><inlinemediaobject><imageobject><imagedata +fileref="k_menu_icon.png" +format="PNG"/></imageobject></inlinemediaobject></guiicon> The +<guiicon>K 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 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-&kde; Application Launcher</guilabel></term> +<listitem> +<para> +<!-- <guiicon><inlinemediaobject><imageobject><imagedata --> +<!-- fileref="nonkdeapp_icon.png" format="PNG"/></imageobject> --> +<!-- </inlinemediaobject></guiicon> --> +The <guilabel>Non-&kde; Application Launcher</guilabel> 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 <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 &kde;'s printing system. &kde; 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 &kde;'s Add Printer +Wizard which allows you to simply add a new printer to your system.</para> +</listitem> +<listitem><para> +<guimenuitem>&kde; Print Settings</guimenuitem> This item will open the &kde; 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, +&kde;'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>K</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>K</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 the applets are +described in their <link linkend="applets">sections</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 (⪚ +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 &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>Position</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>Length</guilabel> frame 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%. +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. +</para> + +<para> +The <guilabel>Size</guilabel> frame lets you define how large a panel will be. +The panel's size can be tiny, small, medium, large or custom. 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 clicking the &RMB; on any free space +and choosing a size from the <guimenu>Size</guimenu> menu.--> +</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. Select the <guilabel>Hide automatically</guilabel> +option in the <guilabel>Hide Mode</guilabel> frame to enable this feature. +You can also configure the amount of time the panel will wait before +it hides here. The check box <guilabel>Show panel when switching +desktops</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> +You can toggle which hide buttons the chosen panel should have with +the check boxes in the group <guilabel>Panel-Hiding Buttons</guilabel>. +</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's +behavior. 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>K Menu</guilabel> frame offers you some options to +configure the <guimenu>K</guimenu> menu's functionality. The +<guilabel>Bookmarks</guilabel> and <guilabel>Recent Documents</guilabel> options +will enable submenus showing your <application>konqueror</application> +bookmarks and the last documents you've opened using &kde; applications +respectively. The <guilabel>Quick Browser</guilabel> option will enable a browser menu. +Enabling the <guilabel>Show side image</guilabel> check box will display a neat +image on the left side of the <guimenu>K</guimenu> menu. +The <guilabel>Menu item format</guilabel> entry allows you to set how +detailed the <guimenu>K</guimenu> menu entries will be. +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> +In the <guilabel>QuickBrowser 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>QuickStart Menu Items</guilabel> frame you +can choose whether this section will show the most recently or the most +frequently used programs. Using the option <guilabel>Maximum number of +entries</guilabel> you can configure how many +programs the quick start section will remember. +</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> + +<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> +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> + +<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/colors. +</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 "Default", +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>K Menu</guilabel> tiles</term> +<listitem> +<para> +The icon for the <guiicon>K 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> + +<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> + + + +</sect2> + +<!-- This section seems deprecated... + +<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 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 &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>>></guibutton> button. This will move the selected +applet to the other list, while clicking the +<guibutton><<</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> 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 windows from all desktops</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>Sort windows by 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>Sort alphabetically by window name</term> +<listitem> +<para> +To be written</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>Show only minimized windows</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>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> + +<varlistentry> +<term>Show window 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> +</para> + +<para> +This is an option which 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> + +</variablelist> + +<para> +You can define the mouse actions of the taskbar buttons with the settings in +the <guilabel>Actions</guilabel> frame. 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>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>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>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> +</variablelist> + +<para>Please note that some of these settings only have effect if a +taskbar button contains more than one application. +</para> + +</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 &kde; Group</title> + +<para> +This group is for the common &kde; things in the <guimenu>K</guimenu> +Menu. +</para> + +<variablelist> +<varlistentry> +<term><guimenuitem>Log Out...</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>Special Configuration</term> +<listitem> +<para> +Clicking with the &RMB; on the <guimenu>K</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 >></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 &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 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 & Time</guimenuitem></title> + +<para> +This option starts the <guilabel>Date & 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 & Time Format</guimenuitem></title> + +<para> +This will open the <guilabel>Country/Region & Language</guilabel> module in the section <guilabel>Regional & Accessibility</guilabel> of the &kcontrolcenter; +where you can set your formats on the page <guilabel>Times & 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 +(⪚ 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 &kde; +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 ⪚ +&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 &kde; unattended and don't want anybody to access it. +The <guibutton>Log out</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 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, +⪚ 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>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 +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>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>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 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>K</guiicon> button of the panel to +another picture? +</para> +</question> +<answer> +<para> +Look for <filename>$HOME/.kde/share/apps/kicker/pics/go.png</filename> +and <filename>$HOME/.kde/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>kbuildsycoca</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> + +<!-- +Local Variables: +mode: sgml +sgml-minimize-attributes: nil +sgml-general-insert-case: lower +sgml-intent-step:0 +sgml-indent-data:nil +End: +--> + + |