15 files changed, 2628 insertions, 0 deletions

diff --git a/doc/kicker/Makefile.am b/doc/kicker/Makefile.am
new file mode 100644
index 000000000..3f20a1e1b
--- /dev/null
+++ b/doc/kicker/Makefile.am
@@ -0,0 +1,5 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
+KDE_MANS = AUTO
diff --git a/doc/kicker/bookmarks_icon.png b/doc/kicker/bookmarks_icon.png
new file mode 100644
index 000000000..aa335b286
--- /dev/null
+++ b/doc/kicker/bookmarks_icon.png
diff --git a/doc/kicker/desktop_icon.png b/doc/kicker/desktop_icon.png
new file mode 100644
index 000000000..5055c7df8
--- /dev/null
+++ b/doc/kicker/desktop_icon.png
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 &eg;
+<application>xosview</application> or <application>xemacs</application>.
+</para>
+
+<para>
+Click the &RMB; on any free space
+in &kicker; and choose <guisubmenu>Add Application to
+Panel</guisubmenu> and then <guimenuitem>Add Non-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 (&eg;
+Child Panel) from the <guilabel>Settings for:</guilabel> listbox. You will then
+be adjust its settings rather than that of the Main Panel.
+</para>
+
+</sect2>
+
+<sect2 id="panel-arrangement">
+<title><guilabel>Arrangement</guilabel></title>
+
+<para>
+In the <guilabel>Arrangement</guilabel> tab you can configure some basic
+functionality of the &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 &quot;Default&quot;,
+tiles are enabled for this kind of button. You can also see a preview of a tile
+before use via the combo box.
+</para>
+
+<para>
+The different kinds of buttons are:
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>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>&gt;&gt;</guibutton> button. This will move the selected
+applet to the other list, while clicking the
+<guibutton>&lt;&lt;</guibutton> button will move the selected applet of
+the list of available applets to the list of trusted ones.
+</para>
+
+</sect2>
+-->
+
+</sect1>
+
+<sect1 id="taskbar-settings">
+<title>The <guilabel>Taskbar</guilabel> 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 &gt;&gt;</guibutton> button which will bring up
+some starting options to the command window.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Run in terminal window</guilabel></term>
+<listitem>
+<para>
+Checking this box will let the application start in a terminal which means that
+you will be able to see any command-line messages the application may give.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Run as a different user</guilabel></term>
+<listitem>
+<para>
+If this box is checked, you can specify a user with whose permission the
+application should run in the <guilabel>Username</guilabel> textfield.
+If you specify another user, you will have to give a password at the box
+below.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Run with different priority</guilabel></term>
+<listitem>
+<para>
+Check this option to run with a different priority. A higher priority
+will tell the operating system to give more processing time to the
+applications.  You can use the slider to change the priority. If you
+want to give your app a higher priority than the default one (middle
+position), you will need to enter the root password below.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Run with realtime scheduling</guilabel></term>
+<listitem>
+<para>
+The Scheduler is the part of the operating system which processes will
+run and which have to wait. Usually, an application will run with normal
+schedule, which means it can use the processing time it gets from the
+operating system, but you can also set it to
+realtime. This means that the application has all
+the process time until it gives it away. You will need to enter the root
+password to use <guilabel>Run with realtime scheduling</guilabel>.
+</para>
+
+<warning>
+<para>
+This can be dangerous. If the application hangs and cannot give up the
+processor, the complete system might hang.
+</para>
+</warning>
+
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+
+<sect1 id="actions">
+<title>The Actions Group</title>
+
+<para>
+This group contains some very useful dynamic menus as described in the
+<link linkend="panel-menus">Menus</link> section of &kicker;'s settings.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guisubmenu>Quick Browser</guisubmenu></term>
+<listitem>
+<para>
+This submenu contains quick browsers for three very useful folders:
+home, root, and system configuration.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guisubmenu>Recent Documents</guisubmenu></term>
+<listitem>
+<para>
+This menu shows the most recently used documents (works only with &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 &amp; Time</guimenuitem></title>
+
+<para>
+This option starts the <guilabel>Date &amp; Time</guilabel>
+configuration module in the section <guilabel>System Administration</guilabel> of the &kcontrolcenter;.</para>
+
+<note>
+<para>
+You will need the super user password for adjusting date and time.
+</para>
+</note>
+
+</sect2>
+
+<sect2 id="date-format">
+<title><guimenuitem>Date &amp; Time Format</guimenuitem></title>
+
+<para>
+This will open the <guilabel>Country/Region &amp; Language</guilabel> module in the section <guilabel>Regional &amp; Accessibility</guilabel> of the &kcontrolcenter; 
+where you can set your formats on the page <guilabel>Times &amp; Dates</guilabel>. There aren't any special permissions needed for that.
+</para>
+
+</sect2>
+
+<sect2 id="copy-date">
+<title><guisubmenu>Copy to Clipboard</guisubmenu></title>
+
+<para>
+If you need to paste the actual date and/or time in another application
+(&eg; in a text editor), you can copy it to the clipboard with this
+function. After selecting one of the available formats, the actual date
+and/or time is placed in the clipboard using the appropriate format.
+</para>
+
+</sect2>
+
+<sect2 id="clock-preferences">
+<title><guimenuitem>Configure Clock...</guimenuitem></title>
+
+<para>
+Here you can set some general preferences of the clock applet.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Appearence</guilabel></term>
+<listitem>
+<para>
+In the <guilabel>Clock Type</guilabel> settings you can choose between
+the clock styles like in the context menu.
+</para>
+
+<!--para>
+The <guilabel>Date</guilabel> group lets you pick font and color of the
+date, which is shown when activated for the specific clock type.
+</para>-->
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guilabel>Plain Clock</guilabel> options</term>
+<listitem>
+<para>In the <guilabel>Display</guilabel> section you can check if you
+want to have the date and/or the seconds shown. In
+<guilabel>Time</guilabel> you can choose if you want the common &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 &eg;
+&klipper; or &juk;. The applications shown in the system tray all
+provide individual funtionality. If you need help concerning these
+options, please refer to the application handbooks.
+</para>
+
+<para>
+The System Tray's context menu provides the option
+<guimenuitem>Configure System Tray...</guimenuitem> . If you click on it,
+a dialog pops up which lets you choose applications that should not be
+permanently visible in the System Tray. Hidden icons can be made visible
+by clicking on the small arrow appearing on the left or top side of the
+applet.
+</para>
+</sect1>
+
+<sect1 id="lockout-applet">
+<title>Lock/Logout Applet</title>
+<para>
+This little applet contains two buttons.
+The <guibutton>Lock the session</guibutton> is used to lock the session if you
+ever want to leave your &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,
+&eg; compilers or 3D renderers.
+</para>
+
+</sect1>
+
+<sect1 id="klipper-applet">
+<title>&klipper; Applet</title>
+
+<para>
+This applet does exactly the same like the &klipper; residing in the system
+tray. It has the advantage, that it consumes a little bit less system
+resources, which only matters on really slow systems, but has the
+disadvantage, that it uses more space than &klipper; in the system
+tray. You can read more about that in the manual for
+<ulink url="help:/klipper/index.html">&klipper;</ulink>.
+</para>
+</sect1>
+
+</chapter>
+
+<chapter id="extensions">
+<title>Panel Extensions</title>
+
+<para>
+There are also some features that run outside of &kicker;, the
+extensions. They are added from the
+context menu by choosing <guisubmenu>Add New Panel</guisubmenu>. You can move them to any
+screenborder by dragging them at the small applet
+handle on their side and remove it by right clicking on an empty space and choose <guimenuitem>Remove Panel</guimenuitem>.
+</para>
+
+<para>
+The style of the extensions can be configured in the <xref
+linkend="panel-extensions"/> section of &kicker;'s preferences.
+</para>
+
+
+<sect1 id="external-taskbar-extension">
+<title>The External Taskbar Panel Extension</title>
+
+<para>
+The external taskbar is just the same as the taskbar applet with the
+only difference that it provides its own panel. Refer to the <link
+linkend="taskbar-applet">taskbar applet section</link> for help about
+it.
+</para>
+
+</sect1>
+
+<sect1 id="child-panel-extension">
+<title>The Child Panel Extension</title>
+
+<para>
+This is just a panel like &kicker; itself, where you can add all the
+stuff &kicker; is also capable. So you can have as many &kicker;s as you
+want. Just add a child panel and add applications and applets to it.
+</para>
+
+</sect1>
+
+<sect1 id="kasbar-extension">
+<title>The <application>KasBar</application> Extension</title>
+
+<para>
+The <application>KasBar</application> is an iconic replacement of the
+taskbar. It always shows the icons of all currently running applications
+on any desktop, they can be chosen by clicking with the &LMB;. The
+active window is highlighted, minimized windows will show a little
+triangle pointing downwards instead of the square in the lower right of
+the icons. A triangle pointing to the right indicates that the
+application is shaded.
+</para>
+</sect1>
+
+<sect1 id="dock-application-bar-extension">
+<title>The Dock Application Bar Extension</title>
+
+<para>
+The Dock Application Bar is an external bar which lets WindowMaker
+applications be docked. Just run your dockable WindowMaker programs, if
+the Dock Application Bar is running, they will be automatically docked.
+</para>
+</sect1>
+
+</chapter>
+
+<chapter id="commands">
+<title>Command Reference</title>
+
+<sect1 id="keybinding">
+<title>The Panel</title>
+
+<para>
+There is only one standard shortcut available in &kicker;:
+</para>
+
+<variablelist>
+<varlistentry>
+<term><keycombo action="simul">&Alt;<keycap>F1</keycap></keycombo></term>
+<listitem>
+<para>
+Opens the <guimenu>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>[email protected]</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:
+-->
+
+
diff --git a/doc/kicker/k_menu_icon.png b/doc/kicker/k_menu_icon.png
new file mode 100644
index 000000000..b3ca6b647
--- /dev/null
+++ b/doc/kicker/k_menu_icon.png
diff --git a/doc/kicker/man-appletproxy.1.docbook b/doc/kicker/man-appletproxy.1.docbook
new file mode 100644
index 000000000..4081f6c19
--- /dev/null
+++ b/doc/kicker/man-appletproxy.1.docbook
@@ -0,0 +1,101 @@
+<?xml version="1.0" ?>
+<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+<!ENTITY % English "INCLUDE">
+]>
+
+<refentry lang="&language;">
+<refentryinfo>
+<title>KDE User's Manual</title>
+<author><personname>
+<firstname>Lauri</firstname>
+<surname>Watts</surname>
+</personname>
+&Lauri.Watts.mail;</author>
+<date>Feb 25, 2005</date>
+<productname>K Desktop Environment</productname>
+</refentryinfo>
+
+<refmeta>
+<refentrytitle><command>appletproxy</command></refentrytitle>
+<manvolnum>1</manvolnum>
+</refmeta>
+
+<refnamediv>
+<refname><command>appletproxy</command></refname>
+<refpurpose>&kde; panel applet proxy</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>appletproxy</command>
+<arg choice="req">desktopfile</arg>
+<arg choice="opt">--configfile <replaceable>file</replaceable></arg>
+<arg choice="opt">--callbackid <replaceable>id</replaceable></arg>
+<arg choice="opt">KDE Generic Options</arg>
+<arg choice="opt">Qt Generic Options</arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+<title>Description</title>
+<para><application>appletproxy</application> is a small application that
+allows you to run a &kicker; (&kde; panel) applet outside of &kicker;
+itself.  The applet will appear in it's own window, making this a convenient
+way to debug panel applets.</para>
+</refsect1>
+
+<refsect1>
+<title>Options</title>
+
+<variablelist>
+<varlistentry>
+<term><option>desktopfile</option></term>
+<listitem><para>The applet's desktop file</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><option>--configfile
+<replaceable>file</replaceable></option></term>
+<listitem><para>The config file to be used</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><option>--callback <replaceable>id</replaceable></option></term>
+<listitem>
+<para>&DCOP; callback id of the applet container.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</refsect1>
+
+
+<refsect1>
+<title>See Also</title>
+
+<para>kicker(1)</para>
+
+</refsect1>
+
+<refsect1>
+<title>Examples</title>
+
+<variablelist>
+<varlistentry>
+<term><userinput><command>appletproxy</command> <parameter>knewsticker</parameter></userinput></term>
+<listitem>
+<para>Run &knewsticker; in a standalone window.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</refsect1>
+
+<refsect1>
+<title>Authors</title>
+<para>&kappname; was written by &Matthias.Elter; and &Matthias.Ettrich; and
+is maintained by &Aaron.J.Seigo; &Aaron.J.Seigo.mail;</para>
+
+<para>This man page was written for &kde; 3.4 by &Lauri.Watts;
+&Lauri.Watts.mail;</para>
+</refsect1>
+
+</refentry>
diff --git a/doc/kicker/man-kicker.1.docbook b/doc/kicker/man-kicker.1.docbook
new file mode 100644
index 000000000..99f984670
--- /dev/null
+++ b/doc/kicker/man-kicker.1.docbook
@@ -0,0 +1,88 @@
+<?xml version="1.0" ?>
+<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+ <!ENTITY % English "INCLUDE">
+ <!ENTITY kappname "&kicker;">
+]>
+
+<refentry lang="&language;">
+<refentryinfo>
+<title>KDE User's Manual</title>
+<author>&Lauri.Watts;&Lauri.Watts.mail;</author>
+<date>February 27, 2005</date>
+<productname>K Desktop Environment</productname>
+</refentryinfo>
+
+<refmeta>
+<refentrytitle><command>kicker</command></refentrytitle>
+<manvolnum>1</manvolnum>
+</refmeta>
+
+<refnamediv>
+<refname><command>kicker</command></refname>
+<refpurpose>&kicker; is the &kde; panel</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>kicker</command>
+<arg choice="opt">KDE Generic Options</arg>
+<arg choice="opt">Qt Generic Options</arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+<title>Description</title>
+<para>&kicker; is the &kde; panel. It normally contains application
+starters, applets, and a clock.</para> 
+<!-- FIXME: Well that's a pretty lame description. -->
+</refsect1>
+
+<refsect1>
+<title>Files</title>
+
+<variablelist>
+<varlistentry>
+<term><filename>$<envar>KDEHOME</envar>/share/apps/kickerrc</filename></term>
+<listitem>
+<para>User specific configuration file.  This file is not normally intended
+to be edited directly; Most configuration items can be controlled from
+&kcontrol;. 
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><filename>$<envar>PREFIX</envar>/share/apps/kickerrc</filename></term>
+<listitem>
+<para>Global configuration file.  This file is not normally intended to be
+edited directly; Most configuration items can be controlled from &kcontrol;.
+Global settings may be configured by the system administrator to either set
+defaults, or lock down options that may not be altered by the users of the
+system.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1>
+<title>See Also</title>
+
+<para>More detailed user documentation is available from <ulink
+url="help:/kicker">help:/kicker</ulink>
+(either enter this <acronym>URL</acronym> into &konqueror;, or run
+<userinput><command>khelpcenter</command>
+<parameter>help:/kicker</parameter></userinput>).</para>
+
+</refsect1>
+
+<refsect1>
+<title>Authors</title>
+<para>&kappname; was written by &Matthias.Elter; and &Matthias.Ettrich; and
+is maintained by &Aaron.J.Seigo; &Aaron.J.Seigo.mail;</para>
+
+<para>This man page was written for &kde; 3.4 by &Lauri.Watts;
+&Lauri.Watts.mail;</para>
+
+</refsect1>
+
+</refentry>
diff --git a/doc/kicker/printsys_icon.png b/doc/kicker/printsys_icon.png
new file mode 100644
index 000000000..13adbd006
--- /dev/null
+++ b/doc/kicker/printsys_icon.png
diff --git a/doc/kicker/quickbrowser_icon.png b/doc/kicker/quickbrowser_icon.png
new file mode 100644
index 000000000..fbc259e95
--- /dev/null
+++ b/doc/kicker/quickbrowser_icon.png
diff --git a/doc/kicker/recent_docs_icon.png b/doc/kicker/recent_docs_icon.png
new file mode 100644
index 000000000..21f079bf4
--- /dev/null
+++ b/doc/kicker/recent_docs_icon.png
diff --git a/doc/kicker/screenshot_left.png b/doc/kicker/screenshot_left.png
new file mode 100644
index 000000000..8b29998ca
--- /dev/null
+++ b/doc/kicker/screenshot_left.png
diff --git a/doc/kicker/screenshot_right.png b/doc/kicker/screenshot_right.png
new file mode 100644
index 000000000..b5bcee61c
--- /dev/null
+++ b/doc/kicker/screenshot_right.png
diff --git a/doc/kicker/taskbar_group.png b/doc/kicker/taskbar_group.png
new file mode 100644
index 000000000..e5484fe96
--- /dev/null
+++ b/doc/kicker/taskbar_group.png
diff --git a/doc/kicker/terminals_icon.png b/doc/kicker/terminals_icon.png
new file mode 100644
index 000000000..de458c184
--- /dev/null
+++ b/doc/kicker/terminals_icon.png
diff --git a/doc/kicker/windowlist_icon.png b/doc/kicker/windowlist_icon.png
new file mode 100644
index 000000000..ca164a12a
--- /dev/null
+++ b/doc/kicker/windowlist_icon.png