summaryrefslogtreecommitdiffstats
path: root/doc/kicker
diff options
context:
space:
mode:
Diffstat (limited to 'doc/kicker')
-rw-r--r--doc/kicker/CMakeLists.txt12
-rw-r--r--doc/kicker/Makefile.am5
-rw-r--r--doc/kicker/bookmarks_icon.pngbin0 -> 2272 bytes
-rw-r--r--doc/kicker/desktop_icon.pngbin0 -> 6881 bytes
-rw-r--r--doc/kicker/index.docbook2734
-rw-r--r--doc/kicker/k_menu_icon.pngbin0 -> 3321 bytes
-rw-r--r--doc/kicker/man-appletproxy.1.docbook101
-rw-r--r--doc/kicker/man-kicker.1.docbook88
-rw-r--r--doc/kicker/printsys_icon.pngbin0 -> 2588 bytes
-rw-r--r--doc/kicker/quickbrowser_icon.pngbin0 -> 3482 bytes
-rw-r--r--doc/kicker/recent_docs_icon.pngbin0 -> 3271 bytes
-rw-r--r--doc/kicker/screenshot_left.pngbin0 -> 18674 bytes
-rw-r--r--doc/kicker/screenshot_right.pngbin0 -> 11764 bytes
-rw-r--r--doc/kicker/taskbar_group.pngbin0 -> 4496 bytes
-rw-r--r--doc/kicker/terminals_icon.pngbin0 -> 2009 bytes
-rw-r--r--doc/kicker/windowlist_icon.pngbin0 -> 2801 bytes
16 files changed, 2940 insertions, 0 deletions
diff --git a/doc/kicker/CMakeLists.txt b/doc/kicker/CMakeLists.txt
new file mode 100644
index 000000000..30b2b313d
--- /dev/null
+++ b/doc/kicker/CMakeLists.txt
@@ -0,0 +1,12 @@
+#################################################
+#
+# (C) 2010-2011 Serghei Amelian
+# serghei (DOT) amelian (AT) gmail.com
+#
+# Improvements and feedback are welcome
+#
+# This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION kicker )
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
Binary files differ
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
Binary files differ
diff --git a/doc/kicker/index.docbook b/doc/kicker/index.docbook
new file mode 100644
index 000000000..1692f8d8d
--- /dev/null
+++ b/doc/kicker/index.docbook
@@ -0,0 +1,2734 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+ <!ENTITY package "tdebase">
+ <!ENTITY kappname "&kicker;">
+ <!ENTITY % addindex "IGNORE">
+ <!ENTITY % English "INCLUDE">
+]>
+
+<!-- The language must NOT be changed here. -->
+
+<book lang="&language;">
+
+<bookinfo>
+<title>The &kicker; Handbook</title>
+
+<authorgroup>
+<author>&Orville.Bennett; &Orville.Bennett.mail;</author>
+<author>&Dirk.Doerflinger; &Dirk.Doerflinger.mail;</author>
+<author>&tde-authors;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>Reviewed: &tde-release-date;</date>
+<releaseinfo>&tde-release-version;</releaseinfo>
+
+<copyright>
+<year>2001</year><year>2002</year>
+<holder>&Dirk.Doerflinger;</holder>
+</copyright>
+<copyright>
+<year>2004</year>
+<holder>&Orville.Bennett;</holder>
+</copyright>
+<copyright>
+<year>2005</year>
+<holder>Titus Laska</holder>
+</copyright>
+<copyright>
+<year>&tde-copyright-date;</year>
+<holder>&tde-team;</holder>
+</copyright>
+
+<legalnotice>&FDLNotice;</legalnotice>
+
+<abstract>
+<para>
+&kicker; is the &tde; application starter panel and is also capable of
+some useful applets and extensions. It usually resides on the bottom of
+the desktop.
+</para>
+</abstract>
+
+<keywordset>
+<keyword>TDE</keyword>
+<keyword>Kicker</keyword>
+<keyword>tdebase</keyword>
+<keyword>panel</keyword>
+<keyword>application</keyword>
+<keyword>starter</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="introduction">
+<title>Introduction</title>
+
+<para>
+&kicker; is the application launcher panel of the Trinity Desktop Environment.
+Besides the <guimenu>TDE</guimenu> Menu, where you can start applications,
+&kicker; is also capable of running docked applets like the pager, the
+taskbar or the clock, and extensions, such as child panels.
+</para>
+
+<para>
+&kicker; usually resides on the bottom of the desktop, but it can also
+be moved to any other border.
+</para>
+
+<para>The panel gives you quick access to applications and makes it
+easier for you to organize your desktop. Using the &tde; panel you
+can:</para>
+
+<itemizedlist>
+
+<listitem><para>Launch applications using the <guimenu>TDE</guimenu> menu or
+the application buttons.</para></listitem>
+<listitem><para>Switch desktops using the panel's pager applet.</para>
+</listitem>
+<listitem><para>Switch active windows, and minimize or maximize them.</para>
+</listitem>
+<listitem><para>Browse folder using the browser menu functionality.</para>
+</listitem>
+<listitem><para>Access panel applets that extend the panel's functionality,
+offering for example mixers, clocks or a system monitor.</para> </listitem>
+
+</itemizedlist>
+
+<para>Please report any problems or feature requests to the &tde; mailing lists.</para>
+
+</chapter>
+
+<chapter id="using-kicker">
+<title>Using &kicker;</title>
+
+<para>
+This is what you see on a freshly installed &tde;, assuming that you
+skipped <application>KPersonalizer</application>. If you are using
+lower resolution, some of the icons may not appear immediately. To
+cater for those smaller resolutions, the screenshot below is divided
+in two parts.
+</para>
+
+<screenshot>
+<screeninfo>Here is a screenshot of the left side of &kicker;</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="screenshot_left.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>Screenshot Left</phrase>
+</textobject>
+<caption>
+<para>
+This is a screenshot of the left side of &kicker;
+</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<screenshot>
+<screeninfo>And here is the right side</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="screenshot_right.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>Screenshot Right</phrase>
+</textobject>
+<caption>
+<para>
+This is the right side of &kicker;
+</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>
+Of course, this is only one way &kicker; might appear on the
+screen. There are many more configurations available.
+</para>
+
+<sect1 id="newbie">
+<title>A quick tour for new &tde; users</title>
+
+<para>
+If you are experienced with this kind of application launcher, you can
+ignore this chapter and move on to <link linkend="basics">&kicker;
+basics</link>.
+</para>
+
+<para>
+The main use of &kicker; is starting applications. This is
+done by clicking icons, either from the panel or from the
+<guimenu>TDE</guimenu> Menu. &kicker; shows some more things too, so let's
+see.
+</para>
+
+<para>
+Having a look at the screenshots above, there are from left to right:
+</para>
+
+<variablelist>
+
+<varlistentry>
+<term>The <guimenu>TDE</guimenu> Menu</term>
+<listitem>
+<para>
+It is used for launching applications and some other useful
+things. Refer to <link linkend="tde-menu">The <guimenu>TDE</guimenu> Menu
+</link>for more information.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Application start icons</term>
+<listitem>
+<para>
+Here are some icons of commonly used applications. They can be moved and
+removed and others can be added. Some of them have a special meaning,
+which you can read more about in <link linkend="basics">&kicker;
+basics</link>. Resting the mouse over an icon without clicking shows the
+name and a short description of that application, if you have set that in
+the <link linkend="configuring">Settings Dialog</link>.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The Pager applet</term>
+<listitem>
+<para>
+This displays a small view of the virtual desktops. Clicking one section
+of it will activate that desktop. Please refer to <link
+linkend="applets">Applets</link>.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The Taskbar</term>
+<listitem>
+<para>
+All running applications are displayed as buttons in the
+taskbar. Clicking an application's button will bring this application on
+top. If it was on top before, it will be iconified. More
+information is available in the <link linkend="applets">Applets</link>
+section.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>System Tray</term>
+<listitem>
+<para>
+The system tray is able to swallow some kind of applications like - in
+this case - &klipper; and the &korganizer; Reminder Daemon. There are
+many other applications that dock in the system tray, for example &juk;
+and &kopete;. Clicking the icons with the
+<mousebutton>left</mousebutton> or the <mousebutton>right</mousebutton>
+mousebutton performs specific actions defined for each
+application.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Clock</term>
+<listitem>
+<para>
+The Clock applet is - of course - a small, useful clock. It can have
+various styles, have a look at the <link
+linkend="applets">applets</link> section for more information.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guibutton>Hide panel</guibutton> button</term>
+<listitem>
+<para>
+This button lets you fade out &kicker; for having more space on the
+screen. When &kicker; is faded out, only the <guibutton>Hide panel</guibutton> button
+will remain in order to fade in &kicker; again.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>
+This was only the description of &kicker; on its initial launch. It can
+be configured in many ways and styles and more applets can be
+added. There are even some extensions like the external taskbar you can
+add. See <link linkend="basics">&kicker; basics</link>, <link
+linkend="applets">Applets </link> and <link
+linkend="extensions">Extensions </link>for more information.
+</para>
+
+</sect1>
+
+</chapter>
+
+<chapter id="basics">
+
+<title>&kicker; basics</title>
+
+<sect1 id="general-usage">
+<title>General usage</title>
+
+<para>
+As mentioned before, there are a lot of things that can be added to
+&kicker;. This section will tell you everything about application
+starting, folder browsing and adding some kinds of applets and
+extensions. Lots of things can be done from the context
+menu with <guimenuitem>Configure Panel...</guimenuitem> or via the &kcontrolcenter;'s
+ section <menuchoice><guimenu>Desktop</guimenu> <guisubmenu>Panels</guisubmenu></menuchoice>.
+</para>
+
+<sect2 id="adding-apps">
+<title>Adding applications</title>
+
+<para>
+There are three different ways to add an application to &kicker;:
+</para>
+
+<variablelist>
+<varlistentry>
+<term>Drag and Drop</term>
+<listitem>
+<para>
+Simply drag any file from &konqueror; into &kicker; and it's there. Dragging
+also works from the <guimenu>TDE</guimenu> Menu with any entry. You can
+change the attributes like optional command line parameters or the icon
+by clicking it with the &RMB; and choosing <guimenuitem>Configure
+<replaceable>applicationname</replaceable> Button...</guimenuitem> from the
+context menu.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Using the context menu to add a &tde; application</term>
+<listitem>
+<para>
+Click the &RMB; on any free space
+in &kicker; and choose <guisubmenu>Add Application to Panel</guisubmenu>.
+There you can choose an application
+which will then be added to &kicker;.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Using the context menu to add a
+non-&tde;-application</term>
+<listitem>
+<para>
+Non-&tde;-applications &eg;
+<application>xosview</application> or <application>xemacs</application>.
+</para>
+
+<para>
+Click the &RMB; on any free space
+in &kicker; and choose <guisubmenu>Add Application to
+Panel</guisubmenu> and then <guimenuitem>Add Non-TDE
+Application</guimenuitem>. In the newly appearing window, enter <guilabel>Button title</guilabel>
+and a <guilabel>Description</guilabel> of the application in the first two text boxes. Then fill
+in the command of the application you
+wish to add in the <guilabel>Executable:</guilabel> text box. You can
+also append command line arguments, have
+the application start from a terminal, and choose the icon which will
+appear in &kicker; by clicking the <guiicon>gear</guiicon>. If you don't
+choose an icon, the application will use the gear as a default.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>
+Applications can be moved or removed by &RMB; click and choosing
+<guimenuitem>Move <replaceable>application name</replaceable> Button</guimenuitem> or
+<guimenuitem>Remove <replaceable>application name</replaceable> Button</guimenuitem>.
+You can also move icons using the &MMB; if you have one. To do this click on an icon using
+ the &MMB;, hold for a second and then drag the icon to its new position.
+Another way to remove an application is by clicking the &RMB; on any free space
+and then choosing <menuchoice><guimenu>Remove from Panel</guimenu>
+<guisubmenu>Application</guisubmenu></menuchoice> and then the application you want to be
+removed.
+</para>
+
+<!-- NOTE: Lauri: I'd say it would confuse users if I'd mention Non-TDE-Apps -->
+<!-- explicitly here. Please add them if you think there's a need. -->
+
+</sect2>
+
+<sect2 id="adding-folders">
+<title>Adding Folders</title>
+
+<para>
+Folders can be added by simply dragging a folder to any free space of
+&kicker;. Quick Browsers can also be added from the context
+menu or the <guimenu>TDE</guimenu> Menu.
+</para>
+
+<para>
+There are two different ways to have a folder in &kicker;, you can
+choose between them in the menu appearing after dropping.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guimenuitem>Add as File Manager &URL;</guimenuitem></term>
+<listitem>
+<para>Choosing this will add a link to the selected folder. Clicking
+this <guiicon>folder</guiicon> icon will open &konqueror; displaying the
+contents of this folder.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Add as Quick Browser</guimenuitem></term>
+<listitem>
+<para>If you add a folder this way, it will be displayed as a submenu of
+&kicker;. This submenu contains <guimenuitem>Open in File
+Manager</guimenuitem>, which does the same as a file manager &URL;, and
+<guimenuitem>Open in Terminal</guimenuitem>, which opens a terminal with
+this folder as the working path. Also, this submenu contains the contents of
+that folder. Sub-folders are displayed as new submenus like the Quick
+Browser itself. The maximum number of displayed elements can be set in
+the <link linkend="configuring">Settings Dialog</link>.
+Quick Browsers can also be added from the context menu of
+&kicker; and then choosing <guimenuitem>Add Applet to Panel...</guimenuitem> and
+then <guilabel>Special Buttons</guilabel> on the right top of the
+<guilabel>Add Applet</guilabel> dialog.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+<para>
+Both kinds of folders can be moved or removed by &RMB; click and
+choosing <guimenuitem>Move <replaceable>application name</replaceable> Button</guimenuitem> or
+<guimenuitem>Remove <replaceable>application name</replaceable> Button</guimenuitem>.
+You can also move icons using the &MMB; if you have one. To do this click on an icon using
+ the &MMB;, hold for a second and then drag the icon to its new position.
+Another way to remove a folder is by clicking the &RMB; on any free space
+and then choosing <menuchoice><guimenu>Remove from Panel</guimenu>
+<guisubmenu>Applet</guisubmenu></menuchoice> and then the applet you want to be
+removed.
+</para>
+
+<para>
+File manager &URL;s can also be configured from the
+context menu, just like any other folder anywhere in
+&tde;.
+</para>
+
+</sect2>
+
+<sect2 id="adding-special-icons">
+<title>Special Icons</title>
+
+<para>
+Some icons in &kicker; have a special meaning. They are added by
+choosing <guimenuitem>Add Applet to Panel...</guimenuitem> and
+then <guilabel>Special Buttons</guilabel> on the right top of the
+<guilabel>Add Applet</guilabel> dialog.
+</para>
+
+<variablelist>
+<varlistentry>
+<term>The <guilabel>TDE Menu</guilabel> Icon</term>
+<listitem>
+<para>
+<guiicon><inlinemediaobject><imageobject><imagedata
+fileref="k_menu_icon.png"
+format="PNG"/></imageobject></inlinemediaobject></guiicon> The
+<guiicon>TDE Menu icon</guiicon> is one of the most necessary icons in
+&kicker;. As you might guess, it opens the <guimenu>TDE</guimenu> Menu,
+which you can learn more about in <link linkend="tde-menu">The K
+Menu</link>.
+</para>
+</listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term>The <guilabel>Window List Menu</guilabel></term>
+<listitem>
+<para>
+<guiicon><inlinemediaobject><imageobject><imagedata
+fileref="windowlist_icon.png"
+format="PNG"/></imageobject></inlinemediaobject></guiicon> Clicking this
+<guiicon>icon</guiicon> will show the <guimenu>Window
+list</guimenu>. Its first entry, <guimenuitem>Unclutter
+Windows</guimenuitem>, tries to move the windows on your active desktop
+in a way to see as many as possible.
+</para>
+
+<para>
+<guimenuitem>Cascade Windows</guimenuitem> puts all windows on the
+active desktop over each others, the most recently on top and the others
+sorted by the time they where last used.</para> <para>Below those
+entries is a list of all currently running applications, grouped by the
+desktops on which they are running. Clicking on an application will activate it.
+</para>
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guilabel>Bookmarks Menu</guilabel></term>
+<listitem>
+<para>
+<guiicon><inlinemediaobject><imageobject><imagedata
+fileref="bookmarks_icon.png"
+format="PNG"/></imageobject></inlinemediaobject></guiicon> The
+<guiicon>Bookmarks</guiicon> icon provides fast access to your
+bookmarks. They appear in the same way as if you click the
+<guimenu>Bookmarks</guimenu> menu in &konqueror;. Clicking a bookmark in
+the menu will launch &konqueror; with the &URL; which
+is behind that bookmark.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guilabel>Recent Documents</guilabel> Icon</term>
+<listitem>
+<para>
+<guiicon><inlinemediaobject><imageobject><imagedata
+fileref="recent_docs_icon.png"
+format="PNG"/></imageobject></inlinemediaobject></guiicon>
+This menu shows the most recently used documents. Clicking the element
+<guimenuitem>Clear History</guimenuitem> will remove those entries,
+which may be useful for privacy reasons.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guilabel>Show Access</guilabel> Icon</term>
+<listitem>
+<para>
+<guiicon><inlinemediaobject><imageobject><imagedata
+fileref="desktop_icon.png"
+format="PNG"/></imageobject></inlinemediaobject></guiicon> The
+<guiicon>Show desktop</guiicon> icon lets you have quick access to all
+the things you have on your desktop by minimizing all currently open
+applications. Clicking it once will toggle it to show the desktop. The
+icon will remain pressed until you either click it
+again, which will restore your minimized apps, or reactivate an
+application from the taskbar.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guilabel>Quick File Browser</guilabel> Item</term>
+<listitem>
+<para>
+<guiicon><inlinemediaobject><imageobject><imagedata
+fileref="quickbrowser_icon.png"
+format="PNG"/></imageobject></inlinemediaobject></guiicon>Adding a
+<guiicon>Browse</guiicon> icon will open a dialog which will
+let you choose a path and an icon, which will appear as a
+<guimenu>Quick File Browser</guimenu> menu. Refer to the <link
+linkend="adding-folders">Adding Folders</link> section for more information
+about quick browsers.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guilabel>Non-&tde; Application Launcher</guilabel></term>
+<listitem>
+<para>
+<!-- <guiicon><inlinemediaobject><imageobject><imagedata -->
+<!-- fileref="nontdeapp_icon.png" format="PNG"/></imageobject> -->
+<!-- </inlinemediaobject></guiicon> -->
+The <guilabel>Non-&tde; Application Launcher</guilabel> lets you add an
+application which doesn't appear in the <guimenu>TDE</guimenu> menu to &kicker;.
+Refer to <link linkend="adding-apps">Adding Applications</link> for more
+information about Non-&tde; Applications.
+</para>
+</listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term>The <guilabel>Terminal Sessions</guilabel> Icon</term>
+<listitem>
+<para>
+<guiicon><inlinemediaobject><imageobject><imagedata
+fileref="terminals_icon.png"
+format="PNG"/></imageobject></inlinemediaobject></guiicon> This icon
+provides a menu of the available Terminal sessions, just as &konsole; does
+when you click and hold its <guiicon>New Session</guiicon> button.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guilabel>Print System</guilabel> Icon</term>
+<listitem>
+<para>
+<guiicon><inlinemediaobject><imageobject><imagedata
+fileref="printsys_icon.png"
+format="PNG"/></imageobject></inlinemediaobject></guiicon>This icon gives
+direct access to &tde;'s printing system. &tde; is able to utilize various printing
+systems according to users' wishes. The options shown below will vary depending
+on the printing system in use. Clicking the &LMB; on the icon opens
+a menu which gives the following options:
+
+<itemizedlist>
+<listitem><para>
+<guimenuitem>Add Printer...</guimenuitem> This will start &tde;'s Add Printer
+Wizard which allows you to simply add a new printer to your system.</para>
+</listitem>
+<listitem><para>
+<guimenuitem>&tde; Print Settings</guimenuitem> This item will open the &tde; Print
+Configuration dialog.</para>
+</listitem>
+
+<listitem>
+<para><guimenuitem>Configure Server</guimenuitem> This item allows configuration
+of a &CUPS; Server. An authorization dialog, requiring validation, will be presented
+to you before allowing any changes.
+</para>
+</listitem>
+
+<listitem><para>
+<guimenuitem>Print Manager</guimenuitem> This item starts the Printing Manager,
+&tde;'s main printing control center.</para>
+</listitem>
+
+<listitem><para>
+<guimenuitem>Print Browser (&konqueror;)</guimenuitem> This item will
+start &konqueror; with the <literal>print:/</literal> io-slave to
+browse all kinds of printers.</para>
+</listitem>
+
+<listitem><para>
+<guimenuitem>Print File...</guimenuitem> This item opens a dialog which lets
+you easily print one or more files.</para>
+</listitem>
+
+<listitem><para>
+The next items with the names of all your printers open the KJobviewer window for each printer.</para>
+</listitem>
+
+</itemizedlist>
+
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="removing-icons">
+<title>Removing all kinds of icons</title>
+
+<para>
+Clicking the &RMB; on any icon, whether it's an application,
+folder or special icon and then choosing
+<guimenuitem>Remove <replaceable>name</replaceable></guimenuitem> from the appearing context
+menu will remove the icon from &kicker;.
+</para>
+<para>
+Another way of removing icons is clicking the &RMB; on any free space in
+&kicker; and choosing <guimenuitem>Remove From Panel</guimenuitem> and then
+<guimenuitem>Applet</guimenuitem>, <guimenuitem>Application</guimenuitem> or
+<guimenuitem>All</guimenuitem>. You can then choose the button you want to remove in
+the submenu.</para>
+
+<note>
+<para>
+Please note that removing an icon from &kicker; won't remove the
+application on the disk!
+</para>
+</note>
+
+</sect2>
+
+<sect2 id="adding-applets">
+<title>Adding Applets</title>
+
+<para>
+&kicker; comes with a set of applets like the taskbar or the
+mini-pager. They can be added by choosing <guisubmenu>Add
+Applet to Panel...</guisubmenu> from the context menu,
+which can be opened by
+clicking the &RMB; on any free space in &kicker;. In the upcoming
+dialog, choose an applet to add and click the <guibutton>Add to
+Panel</guibutton> button.
+</para>
+
+<para>
+Applets can be moved by dragging them on their handle with holding the
+&LMB;, or the &MMB;, or by choosing
+<guimenuitem>Move</guimenuitem> from the context menu.
+</para>
+
+<para>
+You can learn more about the applets in the section <link
+linkend="applets">Applets</link>.
+</para>
+
+</sect2>
+<sect2 id="removing-applets">
+<title>Removing Applets</title>
+<para>
+Applets can be removed by choosing the
+<guimenuitem>Remove <replaceable>applet name</replaceable></guimenuitem> option from the
+context menu, which appears when the &RMB; is clicked on the applet's handle (left or top
+side of the applet) or on the icon itself.
+</para>
+
+
+</sect2>
+
+<sect2 id="adding-extensions">
+<title>Adding Extensions</title>
+
+<para>
+There is also the possibility to add external extensions to &kicker;,
+like the <guimenuitem>External Taskbar</guimenuitem>, the <guimenuitem>Dock
+Application Bar</guimenuitem> for WindowMaker
+dock-applications, <guimenuitem>Kasbar</guimenuitem>, an iconic kind of
+taskbar, an <guimenuitem>Universal Sidebar</guimenuitem> and even child
+<guimenuitem>Panel</guimenuitem>s which behave like new instances of
+&kicker;.
+</para>
+
+<para>
+Extensions can be added by selecting them from the
+submenu <guisubmenu>Add New Panel</guisubmenu> in the context
+menu of &kicker;.
+Most of the extensions can be moved to any border of the screen by
+dragging them with the &LMB; on a free space. If that does not work,
+open the context menu on any free space in &kicker;,
+choose <guimenuitem>Configure Panel...</guimenuitem> and set up the panel
+positions in the appearing dialog.
+</para>
+
+<para>
+More about extensions can be read in the <link
+linkend="extensions">extensions</link> section.
+</para>
+
+</sect2>
+
+<sect2 id="removing-extensions">
+<title>Removing Extensions</title>
+
+<para>
+You can remove extensions by clicking <guimenuitem>Remove</guimenuitem>
+in their context menu, usually located in the
+fade-out handles or by selecting them from the <guisubmenu>Remove
+Panel</guisubmenu> submenu of the &kicker; context
+menu.
+</para>
+</sect2>
+
+</sect1>
+
+<sect1 id="configuring-apps">
+<title>Configuring Application Buttons</title>
+
+<para>
+Every <guiicon>application starter</guiicon> has some preferences you
+can set from their context menu with <guimenuitem>Configure <replaceable>application name</replaceable>
+Button...</guimenuitem>. Usually applications
+and folders have the same preferences as in &konqueror;. Only the
+applications which are located in the <guimenu>TDE</guimenu> Menu (for
+experienced users: those which have a <literal
+role="extension">.desktop</literal> extension in the <filename
+class="directory">applnk</filename> folder) have a special kind of config
+dialog.
+</para>
+
+<sect2 id="general-tab">
+<title>The <guilabel>General</guilabel> Tab</title>
+
+<para>
+Here you can see some information about the application link. You can also
+choose an icon by clicking on the <guibutton>icon button</guibutton>
+<!-- and change the filename of the link file -->.
+This may be useful if you want the icon on the panel behave different
+to the analog one in the <guimenu>TDE</guimenu> Menu.
+</para>
+<!-- Note: illogic-al: Modification not possible from Kicker's Properties menu
+as root usually owns these .desktop files-->
+
+</sect2>
+
+<sect2 id="permissions-tab">
+<title>The <guilabel>Permissions</guilabel> Tab</title>
+
+<para>
+Here you can see the permissions of the link file. Please refer to the
+manuals or handbooks of your operating system for more about
+permissions.
+</para>
+
+</sect2>
+
+<sect2 id="application-tab">
+<title>The <guilabel>Application</guilabel> Tab</title>
+
+<para>
+You can set the behavior of the application when it's executed on this page.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Name</guilabel></term>
+<listitem>
+<para>
+Here you can set the name of the application which will be shown in the tooltip.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Description</guilabel></term>
+<listitem>
+<para>
+Here you can set an informative title which will be shown in the tooltip.
+</para>
+
+<note>
+<para>
+Once the <guilabel>Description</guilabel> is set however, it alone will be
+shown in the tooltip.
+</para>
+</note>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Comment</guilabel></term>
+<listitem>
+<para>
+See <guilabel>Description</guilabel>.
+</para>
+
+<note>
+<para>
+If you set a <guilabel>Name</guilabel> and a <guilabel>Comment</guilabel>, they will
+be shown as tooltips of the start icons in the style <quote>Name - Comment</quote>.
+</para>
+</note>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Command</guilabel></term>
+<listitem>
+<para>
+Usually, there is only the name of the binary that has to be started
+when clicking on the icon. You can search for another application to be
+started by clicking the <guibutton>Browse...</guibutton> button and/or add
+special command line parameters to the application.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Work path</guilabel></term>
+<listitem>
+<para>
+Not yet written
+</para>
+</listitem>
+</varlistentry>
+
+<!--<varlistentry>
+<term><guilabel>Panel Embedding</guilabel></term>
+<listitem>
+<para>
+This feature is not implemented yet.
+</para>
+</listitem>
+<listitem><para>&kicker; has the possibility to swallow some applications
+like <abbrev>e.g.</abbrev> <application>XOSView</application>. This means that
+the application will show up directly in the panel. Therefore you have to
+insert the exact title of the application window in the <guilabel>Window
+Title</guilabel> Textfield. You can also specify an application that will be
+executed when clicking on the swallowed application by typing it's name in the
+<guilabel>Execute on click</guilabel> field.</para></listitem>
+</varlistentry>-->
+
+<varlistentry>
+<term><guilabel>Supported file types:</guilabel></term>
+<listitem>
+<para>
+In this section you can choose what kinds of filetypes are handled by
+this application. Please refer to &konqueror; handbook for more about this.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Advanced Options</guilabel></term>
+<listitem>
+<para>
+This button allows for further configuration of the application to be run.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Run in terminal</guilabel></term>
+<listitem>
+<para>
+If this box is checked, the application will be executed in a terminal
+window. You can also add special Terminal options.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Run as different user</guilabel></term>
+<listitem>
+<para>
+Checking this option will let the application start with the permission
+of the user you typed in the field <guilabel>Username</guilabel>. You
+will be prompted for the user's password on application start. This
+option may be very useful if you want to start some applications as
+superuser.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Enable launch feedback</guilabel></term>
+<listitem>
+<para>
+If this box is checked, this will display feedback when an application icon is clicked
+with the &LMB;.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Place in system tray</guilabel></term>
+<listitem>
+<para>
+When checked, the application's icon will show up in the panel system tray.
+You will then be able to hide or show the application by clicking on the system
+tray icon. Clicking on it using the &RMB; will allow also you to undock, or quit the
+application.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>DCOP registration</guilabel></term>
+<listitem>
+<para>
+Not yet written
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+</sect1>
+
+</chapter>
+
+<chapter id="configuring">
+<title>Configuring &kicker;</title>
+
+<para>
+This section describes the ways &kicker; can be configured. It's only
+about the basic &kicker; settings. Configuration of applets are
+described in another <link linkend="applets">section</link>.
+</para>
+
+<para>
+You can change the settings by either clicking
+<guimenuitem>Configure Panel...</guimenuitem> in the context
+menu of &kicker;, or in &kcontrolcenter; by
+going to <guilabel>Desktop</guilabel> and then selecting the
+<guilabel>Panels</guilabel> or the <guilabel>Taskbar</guilabel> module.
+</para>
+
+<sect1 id="panel">
+<title>The Panel Section</title>
+
+<sect2 id="panel-extensions">
+<title>Extensions</title>
+<para>
+Panels and panel <link linkend="extensions">extensions</link> are configured
+on the same page. Simply choose one of your extensions (&eg;
+Child Panel) from the <guilabel>Settings for:</guilabel> listbox. You will then
+be adjust its settings rather than that of the Main Panel.
+</para>
+
+</sect2>
+
+<sect2 id="panel-arrangement">
+<title><guilabel>Arrangement</guilabel></title>
+
+<para>
+In the <guilabel>Arrangement</guilabel> tab you can configure some basic
+functionality of the &tde; panel (&ie; functionality you'd find in other
+panel applications as well; later we'll come to the more interesting
+features).
+</para>
+
+<para>If you have more than one panel on screen, you can select at the
+top of the window which panel you wish to configure.</para>
+
+<para>
+In the <guilabel>Position</guilabel> section you can choose which
+screen border the panel should be attached. If you
+want to play around with different settings you can change the panel's
+position even easier by dragging the panel from one border to the other.
+</para>
+
+<para>In the section labeled <guilabel>Position</guilabel> is a set of
+12 buttons arranged in a square. Each button corresponds to a
+location for the panel. Click on a button and notice where the panel
+is located on the preview monitor to the right.</para>
+
+<tip><para>Generally, the available space in kicker is used more
+efficiently when the panel is aligned horizontally, &ie; attached to the
+top or bottom screen border.</para></tip>
+
+<para>
+The <guilabel>Length</guilabel> section lets you define how much space a panel
+will occupy on the side of the screen which it resides. By default this is on the
+bottom so changing this value will affect a panel's width. The value can be anywhere
+from 1% to 100%. Use the combo box and slider to adjust the <emphasis>minimum</emphasis>
+length of the panel. Checking the check box <guilabel>Expand as required to fit
+contents</guilabel> makes sure that a panel is at least as big as needed to show
+every icon and applet. The panel will become longer if more space is needed. When
+less space is required on the panel, the panel will shrink down to the minimum size.
+If there is no mark in the checkbox, then the panel is fixed to the
+length specified in this section.
+</para>
+
+<para>The final section of this table is labeled
+<guilabel>Size</guilabel>, and refers to the
+<emphasis>height</emphasis> of the panel. The panel's size can be
+<guilabel>Tiny</guilabel>, <guilabel>Small</guilabel>,
+<guilabel>Medium</guilabel>, <guilabel>Large</guilabel> or
+<guilabel>Custom</guilabel>. If you choose
+<guilabel>Custom</guilabel> mode, you can resize &kicker; by
+specifying a height in the combobox.</para>
+
+<para>If you have multiple monitors, you can configure the panel for
+each screen entirely independently. If you are not sure which screen
+is which, Press the <guibutton>Identify</guibutton> and a number will
+appear centred on each screen.</para>
+<!-- TODO: It's not centered on dual head non-xinerama, they both
+appear on the primary head, file a bug -->
+
+<para>Then simply choose the screen you wish to configure from the
+drop down box labelled <guilabel>Xinerama screen</guilabel>, or choose
+<guilabel>All Screens</guilabel> to have identical configurations on
+each.
+</para>
+
+</sect2>
+
+<sect2 id="panel-hiding">
+<title><guilabel>Hiding</guilabel></title>
+
+<para>
+Depending on your screen resolution you may find that the panel
+takes away too much of your precious screen real estate. To save
+screen space, the panel offers manual hiding of the panel, an auto
+hide feature, and the ability to allow other windows to lay on top of
+the panel. These features are selected in the section entitled
+<guilabel>Hide Mode</guilabel>.</para>
+
+<para>When the <guilabel>Hide Mode</guilabel> feature is enabled, the
+panel will hide when the mouse cursor has not been moved over it for the
+configured time. If you move the mouse to the panel's screen
+border it will show up again.</para>
+
+<para>The <guilabel>Hide Mode</guilabel> section has three options:</para>
+<variablelist>
+<varlistentry>
+<term><guilabel>Only hide when panel-hiding button is clicked</guilabel></term>
+<listitem><para>When this option is selected, the panel will remain visible at
+the location you defined unless you click on the button at the far right (for horizontally
+oriented) or bottom (for vertically oriented) button. This button has an arrow on it pointed
+to the edge of the screen.</para>
+
+<para>Once clicked, the panel will disappear. If the button is clicked again, the panel will re-appear
+at the same location.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Hide automatically</guilabel></term>
+<listitem><para>If this option is selected, then the panel will automatically disappear after
+the number of seconds specified in the combo box below the option. To make the panel reappear,
+simply move the mouse pointer to the edge of the screen where the panel is located, and the
+panel will reappear immediately.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Allow other windows to cover the panel</guilabel></term>
+<listitem><para>As this option's label implies, the panel is always on the desktop when
+this option is selected. It is now possible, however, for application windows to lay
+on top of the panel.</para>
+
+<para>Once the panel has moved back on top of the application window, it will stay there
+until an application window becomes active again.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>If you place a mark in the checkbox labeled <guilabel>Show panel when switching
+desktops</guilabel>, the panel will automatically reappear when you switch desktops. (The panel
+will disappear again after the specified number of seconds.) Otherwise, if there are too many
+applets and icons on &kicker;, two small scroll buttons will be displayed to scroll the whole
+panel.</para>
+
+<para>To restore the panel, simply move the mouse cursor to the screen
+location specified in the drop box labeled <guilabel>Raise when the pointer touches
+the screen's:</guilabel>. You can change this value by selecting one of the choices
+provided in the drop down box.</para>
+
+<para>
+When the panel's hide buttons are enabled you'll see buttons on both
+sides of the panel, with arrows showing to the screen border. If you
+click on one of these buttons, the panel will slide away in that
+direction. After that, you'll see a remaining show button in that
+corner, which will make the panel show again. Check the appropriate
+checkbox if you want the hide buttons to show up on any side of
+&kicker;. Using the slider you can change the width of the buttons.
+</para>
+
+<para>The next section down is labeled <guilabel>Panel-Hiding Buttons</guilabel>. It
+consists of two check boxes: <guilabel>Show left panel-hiding button</guilabel> and
+<guilabel>Show left panel-hiding button</guilabel>. Use these checkboxes to show and
+hide the left and right manual panel hiding buttons.</para>
+
+<para>
+The <guilabel>Panel Animation</guilabel> frame allows you to choose
+whether the panel will softly slide away or just disappear.
+Checking the <guilabel>Animate panel hiding</guilabel> will allow you
+to configure the speed of the animation using the sliders. Unchecking,
+naturally, disables the panel animations.
+</para>
+
+</sect2>
+
+<sect2 id="panel-menus">
+<title>Menus</title>
+
+<para>
+In the <guilabel>Menus</guilabel> tab you can configure the panel menu
+behavior. This affects the <guimenu>TDE</guimenu> menu you will often use
+to launch applications, the browser menus you can use to access
+folders and other menus like the recent documents menu.
+</para>
+
+<para> The first option is the menu style. &tde; supports two menu styles:
+a classic menu familiar to many desktops and operating systems and a Kickoff style.</para>
+
+<para>The <guilabel>TDE Menu</guilabel> section provides many options to
+configure the <guimenu>TDE</guimenu> menu functionality.</para>
+
+<para>The <guilabel>Menu item format</guilabel> section allows you to adjust the
+details of the <guimenu>TDE</guimenu> menu entries. There are four
+buttons. Each button option determines how the application <emphasis>Name</emphasis>
+(&ie; &konqueror;, &kword;, &etc;) and the <emphasis>Description</emphasis> (&ie; Web
+Browser, Word Processor, &etc;) are displayed on the &kmenu;. The <guilabel>Name only</guilabel>
+option simply shows the application's name in the menu.
+The <guilabel>Name (Description)</guilabel> option will show a small description
+besides the name of the application.
+The <guilabel>Description (Name)</guilabel> and <guilabel>Name
+(Description)</guilabel> options will show both name and description in
+the &kmenu;.
+</para>
+
+<para>Below the <guilabel>Menu item format</guilabel> section is a button to
+<guilabel>Edit TDE Menu</guilabel>. Then menu editor is a tool to customize the
+menu layout and add or delete menu items.</para>
+
+<para>The <guilabel>Optional Menus</guilabel> checkboxes allow
+you to determine which special menu items appear in the &kmenu;.</para>
+
+<itemizedlist>
+
+<listitem>
+<para>The <guilabel>Bookmarks</guilabel>
+menu allows you to quickly select from the same bookmarks that are available in &konqueror;.</para>
+</listitem>
+
+<listitem>
+<para>The <guilabel>Find</guilabel> menu offers access to the &kfind; application to search for
+local files, and a quick link to a search engine to search for things on the Internet.</para>
+</listitem>
+
+<listitem>
+<para>The <guilabel>Kate Session Menu</guilabel> allows you to
+open any of your Kate sessions.</para>
+</listitem>
+
+<listitem>
+<para>The <guilabel>Konqueror Profiles</guilabel> menu allows you to
+launch &konqueror; with any of your configured profiles.</para>
+</listitem>
+
+<listitem>
+<para>The <guilabel>Network Folders</guilabel> menu can launch a
+&konqueror; file manager window displaying any of your configured
+network folders.</para>
+</listitem>
+
+<listitem>
+<para>The <guilabel>Print System</guilabel> menu provides several menu entries to help manage
+the printer(s) attached to your system.</para>
+</listitem>
+
+<listitem>
+<para>The <guilabel>Quick Browser</guilabel> menu gives you quick links to locations on your
+hard drive.</para>
+</listitem>
+
+<listitem>
+<para>The <guilabel>Recent Documents</guilabel> menu lists the most recently edited documents
+and will automatically launch the application to edit or view this document.</para>
+</listitem>
+
+<listitem>
+<para>The <guilabel>Settings</guilabel> menu allows you to launch each &kcontrol; module
+directly from the TDE menu.</para>
+</listitem>
+
+<listitem>
+<para>The <guilabel>System Menu</guilabel> allows you quick access to
+some commonly visited places, including your Home folder, and the
+Trash. You may find this useful instead of having a separate entry for
+each of these in the &kmenu;</para>
+</listitem>
+
+<listitem>
+<para>The <guilabel>Terminal Sessions</guilabel> menu provides menu items to launch several
+different types of
+terminal programs (command line interfaces).</para>
+</listitem>
+</itemizedlist>
+
+<para>Other options in the <guilabel>Menu item format</guilabel> section include:</para>
+
+<para><guilabel>Open menu on mouse hover</guilabel>: This option affects only the Kickoff
+menu style. When enabled, hovering the mouse pointer over the menu buttons will atuomatically
+open that menu without clicking the mouse button.</para>
+
+<para><guilabel>Show Tooltip</guilabel>: When enabled a tooltip appears when hovering the mouse
+pointer over menu items. Using this option requires that tooltips ar enabled in Panels Appearance.</para>
+
+<para><guilabel>Show side image</guilabel>: Enabling this option displays a nice
+image on the left side of the <guimenu>TDE</guimenu> menu.</para>
+
+<para><guilabel>Display text in menu button</guilabel>: When enabled the text enter into the
+associated text box will be displayed in the menu button.</para>
+
+<para><guilabel>Font</guilabel>: This option allows you to select the font and size for all items
+in the menu.</para>
+
+<para><guilabel>Change TDE Menu icon</guilabel>: This option allows you to change the menu icon.</para>
+
+<para>In the <guilabel>QuickBrowser Menus</guilabel> section you can configure
+whether the panel's browser menus will show hidden files or not (hidden
+files on &UNIX; systems are those whose filenames begin with a dot) as
+well as how many files at most will be shown in a quick browser menu. The
+latter option might be useful when you have a rather small screen
+resolution, because the browser menus would otherwise quickly fill up your screen
+when you browse folders containing many files.</para>
+
+<para>The <guilabel>QuickStart Menu Items</guilabel> section provides quick
+access to programs you have used often or recently. You
+can choose whether to show the most recently programs or the most
+frequently used programs. Use the option <guilabel>Maximum number of
+entries</guilabel> to configure how many programs the quick start section will remember.
+</para>
+
+<para>The <guilabel>Recent Documents Menu</guilabel> section includes an option to enable a
+submenu showing the most recent documents opened using &tde; applications. This option does
+not show recent documents opened with non &tde; applications.</para>
+
+<para>The <guilabel>TDE Menu Search</guilabel> section includes an option to show a search box
+in the menu to help find items in the menu.</para>
+
+</sect2>
+
+<sect2 id="panel-appearance">
+<title><guilabel>Appearance</guilabel></title>
+
+<para>
+Using the <guilabel>Appearance</guilabel> tab you can configure the
+panel's overall appearance.
+</para>
+
+<sect3 id="panel-appearance-general">
+<title><guilabel>General</guilabel></title>
+
+<para>
+The check box <guilabel>Enable icon mouseover effects</guilabel>
+toggles the large animated tooltips of &kicker;. They show name and
+description of the icons and applets the mousepointer is positioned on.
+</para>
+
+<para>When <guilabel>Enable icon activation effects</guilabel> is enabled,
+the icons in the panel (not the taskbar) activate or "blink" when selected.</para>
+
+<para>
+If <guilabel>Show tooltips</guilabel> is checked, the classical small
+tooltips with descriptions of the icons and applets will be shown if the
+mousepointer rests over an icon for some seconds. Note that this
+has no effect as long as the option to <guilabel>Enable icon mouseover
+effects</guilabel> is enabled.
+</para>
+
+</sect3>
+
+<sect3 id="panel-appearance-button-backgrounds">
+<title><guilabel>Button Backgrounds</guilabel></title>
+
+<para>The &tde; panel supports so-called <guilabel>Button
+Backgrounds</guilabel>. This means that the buttons shown on the panel
+will be drawn using configurable images. To enable button backgrounds,
+simply choose the button type from the list, and change the drop down
+box to the color image you would like to use. Choose
+<guilabel>Default</guilabel> to return to an unstyled button. If you
+choose <guilabel>Custom color</guilabel>, the color button next to the
+drop down list will be enabled. Click on it to select a custom color
+to use.</para>
+
+<para>
+For every kind of panel button there is a combo box offering a custom
+color option and tiled images. When the value is changed from &quot;Default&quot;,
+tiles are enabled for this kind of button. You can also see a preview of a tile
+before use via the combo box.
+</para>
+
+<para>
+The different kinds of buttons are:
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>TDE Menu</guilabel> tiles</term>
+<listitem>
+<para>
+The icon for the <guiicon>TDE Menu</guiicon> will be displayed as a tile
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Applications</guilabel> tiles</term>
+<listitem>
+<para>
+The icons which start applications will be displayed as tiles
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Desktop access</guilabel> tiles</term>
+<listitem>
+<para>
+The <guiicon>Desktop Access</guiicon> icon will be displayed as a tile
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>QuickBrowser menus</guilabel> Tiles</term>
+<listitem>
+<para>
+The icons for <guiicon>Quickbrowsers</guiicon> will be displayed as
+tiles
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Window list</guilabel> Tiles</term>
+<listitem>
+<para>
+The <guiicon>Window List</guiicon> icon will be displayed as a tile
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect3>
+
+<sect3 id="panel-appearance-background">
+<title><guilabel>Panel Background</guilabel></title>
+
+<para>
+The <guilabel>Enable transparency</guilabel> option, when checked, allows the
+panel to appear transparent.
+</para>
+
+<para>
+The background image is a picture that will be used
+to draw the panel's background, just like you can use a picture for the
+desktop background. Check the <guilabel>Enable background
+image</guilabel> option to enable this feature. You can specify an image
+file in the edit box below or choose one by clicking on the
+<guiicon>Open file dialog</guiicon> button. You may also check the
+<guilabel>Colorize to match the desktop color scheme</guilabel> box to
+modify the background image's colors. You'll see a preview of the selected
+picture on the right.
+</para>
+
+</sect3>
+
+<sect3 id="panel-appearance-advanced">
+<title><guilabel>Advanced Options</guilabel></title>
+
+<para>The <guilabel>Hide button size:</guilabel> option allows you to
+choose a width in pixels for the hide buttons, if they are
+visible.</para>
+
+<para>The panel itself has several default sizes set, which you can
+switch between by simply dragging the edge of it, or by &RMB; clicking
+on an empty space in the panel, choosing <guisubmenu>Size</guisubmenu>
+and selecting the desired size from the submenu. If you enable
+<guilabel>Allow Drag and Drop resizing of panels</guilabel> then by
+choosing <guimenuitem>Custom</guimenuitem> in the panel menu, you can
+drag the panel edge to any size you like.</para>
+
+<para>Applet handles are normally visible beside each applet on the panel,
+so that it is clear where to click to configure them, or to get to the panel menu.
+ You can instead have them <guilabel>Fade out</guilabel>, or hide unless you hover
+the mouse over them, or you can choose to <guilabel>Hide</guilabel> them completely.</para>
+
+<para>Finally, if the panel is transparent, you can tint it with a
+color of your choice. The slider allows you to choose how opaque the
+tint is. At the lowest end, there is no tint visible, while at the
+highest, the panel is not transparent at all.</para>
+
+</sect3>
+
+</sect2>
+
+<!-- This section seems deprecated...
+
+<sect2 id="panel-applets">
+<title>Applets</title>
+
+<para>
+Applets are small plugins that extend the panel's functionality. &tde;
+comes with some applets but they may be provided by third parties as
+well.</para>
+
+<para>
+Panel applets can be started using two different ways: internally or
+externally. While <quote>internal</quote> is the preferred way to load
+applets, this can raise stability or security problems when you are
+using poorly programmed third-party applets. To address these problems,
+applets can be marked <quote>trusted</quote>. You might want to
+configure the panel to treat trusted applets different from untrusted
+ones. Your options are:
+</para>
+
+<itemizedlist>
+<listitem>
+<para>
+<guilabel>Load only trusted applets internal</guilabel>: All applets but
+the ones marked <quote>trusted</quote> will be loaded using an external
+wrapper application.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<guilabel>Load startup config applets internal</guilabel>: The applets
+shown on &tde; startup will be loaded internally, others will be loaded
+using an external wrapper application.</para></listitem>
+<listitem><para><guilabel>Load all applets internal</guilabel>: will
+load all applets internally, regardless of whether they are trusted or
+not.
+</para>
+</listitem>
+</itemizedlist>
+
+<para>
+For stability and security reasons, we recommend using one of the first
+two options and that you mark only those applets as 'trusted' that come
+with the &tde; base packages.
+</para>
+
+<para>
+To mark applets <quote>trusted</quote> or <quote>untrusted</quote> you
+can move them from one of the shown listboxes to the other. Just try
+selecting an applet in the list of trusted applets and click the
+<guibutton>&gt;&gt;</guibutton> button. This will move the selected
+applet to the other list, while clicking the
+<guibutton>&lt;&lt;</guibutton> button will move the selected applet of
+the list of available applets to the list of trusted ones.
+</para>
+
+</sect2>
+-->
+
+</sect1>
+
+<sect1 id="taskbar-settings">
+<title>The <guilabel>Taskbar</guilabel></title>
+
+<sect2>
+<title><guilabel>Taskbar</guilabel></title>
+
+<para>
+This section changes the settings of the taskbar. Changes affect the
+external taskbar and also taskbar applets on &kicker; or child-panels.
+The taskbar can be located in the panel (default), or outside the panel
+on the desktop.</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Show windows from all desktops</guilabel></term>
+<listitem>
+<para>
+This option determines whether all open windows are included in the taskbar or not. By default,
+the taskbar only shows the open windows <emphasis>on the current
+desktop</emphasis>. If this option is enabled, the taskbar will show
+all open windows <emphasis>on all desktops</emphasis>.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Sort windows by desktop</guilabel></term>
+<listitem>
+<para>
+This option changes the sort order of the icons on the taskbar, so that windows on virtual
+desktop 1 are shown first (to the left, or at the top of the taskbar),
+followed by windows on virtual desktop 2, and so on.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Sort alphabetically by application name</guilabel></term>
+<listitem>
+<para>This options shows the icons in an alphabetical sort order on the taskbar.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Allow taskbar items to be rearranged using drag and drop</guilabel></term>
+<listitem>
+<para>
+When selected the order of the taskbar buttons can be rearranged simply by selecting
+the button with the mouse pointer and dragging to the desired location.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Cycle through windows with mouse wheel</guilabel></term>
+<listitem>
+<para>This option allows cycling or switching through all apps in the taskbar by
+moving the mouse scrool wheel while the mouse pointer hovers over the taskbar.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Show only minimized windows</guilabel></term>
+<listitem>
+<para>
+If this box is checked, only windows which have been minimized will be
+shown in the taskbar. If <guilabel>Show windows from all desktops</guilabel>
+has been checked then all minimized windows will be shown. Otherwise, only the
+minimized windows of the current virtual desktop will be shown.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Show window list button</guilabel></term>
+<listitem>
+<para>Checking this box will show the small <guibutton>window list
+button</guibutton> at the fat left of the taskbar. This button opens a popup menu listing
+all applications in the taskbar.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Display</guilabel></term>
+<listitem>
+<para>This option affects how taskbar buttons are displayed. The drop-down list button supports
+three options: Icons and Text, Text only, and Icons only.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Group similar tasks</guilabel></term>
+<listitem>
+<para>
+<inlinemediaobject><imageobject><imagedata fileref="taskbar_group.png"
+format="PNG"/></imageobject></inlinemediaobject>
+</para>
+
+<para>
+This is option helps you if you often lack space in your
+taskbar. If it is set to <guilabel>Always</guilabel>, several
+instances of the same application are grouped together in one taskbar
+button. Select <guilabel>When Taskbar Full</guilabel> to make &kicker;
+only group similar tasks if there is not much space left in the taskbar.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Appearance</guilabel></term>
+<listitem>
+<para>This option allows you to set the taskbar appearance to
+<guilabel>Elegant</guilabel>, <guilabel>Classic</guilabel> or
+<guilabel>For Transparency</guilabel>.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Use custom colors</guilabel></term>
+<listitem>
+<para>This option allows you to choose different colors for the taskbar buttons.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title><guilabel>Actions</guilabel></title>
+
+<para>The next set of options allow you to customize the actions
+performed with different mouse clicks on taskbar icons.</para>
+
+<para>You can select any action from the list for the <guilabel>Left button</guilabel>,
+the <guilabel>Middle button</guilabel> and the <guilabel>Right button</guilabel>.</para>
+
+<note><para>Some of these settings have effect only when a taskbar button contains
+more than one application.
+</para></note>
+
+<variablelist>
+
+<varlistentry>
+<term>
+<guilabel>Show Task List</guilabel>
+</term>
+<listitem><para>Clicking with the
+mouse button will open a menu displaying all
+tasks in that group. If you click an entry of that menu with any mouse
+button, the corresponding application will become active.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Show Operations Menu</guilabel></term>
+<listitem>
+<para>Clicking with the mousebutton will open a menu with all
+applications of that group, where every application has its window
+menu as a submenu and there are some group specific entries like
+<guimenuitem>Close All</guimenuitem> which closes all applications of
+that group, <guisubmenu>All to Desktop</guisubmenu> which lets you
+define on which desktop the whole group appears and
+<guimenuitem>Maximize All</guimenuitem>, <guimenuitem>Minimize
+All</guimenuitem> and <guimenuitem>Restore All</guimenuitem> which
+appends those actions to all applications of that group.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Activate, Raise or Minimize Task</guilabel></term>
+<listitem>
+<para>When a task is minimized, this option activates and raises the task to focus. When open
+in the background but not visibile, this option raises the task to focus.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Activate Task</guilabel></term>
+<listitem>
+<para>
+Clicking with the mousebutton will activate
+the first application in that group without opening the group menu.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Raise Task</guilabel></term>
+<listitem>
+<para>The first application of that group will be
+put in the foreground without giving focus to it.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Lower Task</guilabel></term>
+<listitem>
+<para>
+The first application of that group will be
+put in the background. It won't lose the focus.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Minimize Task</guilabel></term>
+<listitem>
+<para>The first application of that group will be
+minimized. If it is already minimized, it will be restored again.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Move To Current Desktop</guilabel></term>
+<listitem>
+<para>When the taskbar is configured to show all apps from all desktops, this options will move the
+selected app from a different desktop to the current desktop.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Close Task</guilabel></term>
+<listitem>
+<para>This option closes or terminates the task.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+</sect1>
+
+</chapter>
+
+<chapter id="tde-menu">
+<title>The <guimenu>TDE</guimenu> Menu</title>
+
+<para>
+The <guimenu>TDE</guimenu> Menu is one of the central elements of
+&kicker;.
+</para>
+
+<para>
+There are five main groups in the <guimenu>TDE</guimenu> Menu which will
+be described now from bottom to top.
+</para>
+
+<sect1 id="tde-group">
+<title>The &tde; Group</title>
+
+<para>
+This group is for the common &tde; things in the <guimenu>TDE</guimenu>
+Menu.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guimenuitem>Log Out...</guimenuitem></term>
+<listitem>
+<para>
+This entry is used to finish the &tde; session. It also shuts down the
+&X-Window; session.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Lock Session</guimenuitem></term>
+<listitem>
+<para>
+With this entry you can lock your session if you don't want anybody else
+to access your desktop. If you have set a screensaver, it will appear when
+locked, otherwise the screen will turn black. If you hit any key, you
+will be prompted for your user password. This is independent from the
+screensaver's password settings.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Special Configuration</term>
+<listitem>
+<para>
+Clicking with the &RMB; on the <guimenu>TDE</guimenu> Menu, will produce a
+special submenu. In this submenu is the <guisubmenu>Panel Menu</guisubmenu>.
+Here you can change the settings of &kicker;, described in the
+<link linkend="configuring">Configuring &kicker;</link> section, add
+things to &kicker; (see in <link linkend="basics">&kicker; Basics</link>
+for more), or reach the <guisubmenu>Help</guisubmenu> Menu, but as you are
+reading this, you probably found it yourself.
+You can also start the <application>Menu Editor</application> via this submenu.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="run-command">
+<title><guilabel>Run Command...</guilabel></title>
+
+<para>
+This will bring up a small but powerful application start dialog.
+</para>
+
+<para>
+In the standard case, you just type in a command and press
+<keycap>Enter</keycap> or click <guibutton>Run</guibutton>. But there
+is also an <guibutton>Options &gt;&gt;</guibutton> button which will bring up
+some starting options to the command window.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Run in terminal window</guilabel></term>
+<listitem>
+<para>
+Checking this box will let the application start in a terminal which means that
+you will be able to see any command-line messages the application may give.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Run as a different user</guilabel></term>
+<listitem>
+<para>
+If this box is checked, you can specify a user with whose permission the
+application should run in the <guilabel>Username</guilabel> textfield.
+If you specify another user, you will have to give a password at the box
+below.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Run with different priority</guilabel></term>
+<listitem>
+<para>
+Check this option to run with a different priority. A higher priority
+will tell the operating system to give more processing time to the
+applications. You can use the slider to change the priority. If you
+want to give your app a higher priority than the default one (middle
+position), you will need to enter the root password below.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Run with realtime scheduling</guilabel></term>
+<listitem>
+<para>
+The Scheduler is the part of the operating system which processes will
+run and which have to wait. Usually, an application will run with normal
+schedule, which means it can use the processing time it gets from the
+operating system, but you can also set it to
+realtime. This means that the application has all
+the process time until it gives it away. You will need to enter the root
+password to use <guilabel>Run with realtime scheduling</guilabel>.
+</para>
+
+<warning>
+<para>
+This can be dangerous. If the application hangs and cannot give up the
+processor, the complete system might hang.
+</para>
+</warning>
+
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+
+<sect1 id="actions">
+<title>The Actions Group</title>
+
+<para>
+This group contains some very useful dynamic menus as described in the
+<link linkend="panel-menus">Menus</link> section of &kicker;'s settings.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guisubmenu>Quick Browser</guisubmenu></term>
+<listitem>
+<para>
+This submenu contains quick browsers for three very useful folders:
+home, root, and system configuration.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guisubmenu>Recent Documents</guisubmenu></term>
+<listitem>
+<para>
+This menu shows the most recently used documents (works only with &tde;
+applications for the moment). Clicking the element <guimenuitem>Clear
+History</guimenuitem> will remove those entries, what may be useful for
+privacy reasons.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guisubmenu>Bookmarks</guisubmenu></term>
+<listitem>
+<para>
+This submenu shows your personal bookmarks just like &konqueror;
+does. Refer to the &konqueror; Handbook for more help on this.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="application-group">
+<title>The All Applications Group</title>
+
+<para>
+The submenus for application starting are located in this group. You can
+use &kmenuedit; to add, remove or move the entries. Applications will have a
+short description if either the <guilabel>Name (Description)</guilabel> or
+<guilabel>Description (Name)</guilabel> option is enabled in the settings.
+</para>
+</sect1>
+
+<sect1 id="most-recently-group">
+<title>The Most Used Applications Group</title>
+
+<para>
+This group holds either the most recently or the most frequently used
+applications. See the <link linkend="panel-menus">Menus
+Configuration</link> section for more about that.
+</para>
+</sect1>
+
+</chapter>
+
+<chapter id="applets">
+<title>Applets</title>
+
+<para>
+Applets are small applications running inside of &kicker;. Almost
+everything besides the <guiicon>application starter buttons</guiicon>
+are applets. They can be added from the context menu
+by choosing<guisubmenu>Add Applet to Panel</guisubmenu>. Every
+applet contains a small arrow in its handle. Clicking it will bring up a menu
+which lets you move or remove it, set the Preferences, if there are any and set
+the preferences of &kicker;.
+</para>
+
+<sect1 id="taskbar-applet">
+<title>The Taskbar Applet</title>
+
+<para>
+The taskbar applet shows buttons for the running applications. The
+application, which has the focus, is shown as a pressed button. If an
+application is minimized, the title displayed in the taskbar will fade
+to gray.
+</para>
+
+<tip>
+<para>
+If you click on the button of the active application, it will be
+minimized. This means also that if you click twice on an inactive
+application, it will also be minimized.
+</para>
+</tip>
+
+<para>
+A click with the &RMB; on a button will show the standard application
+menu. Only the entry <guimenuitem>To Current Desktop</guimenuitem>
+differs: if you have set the taskbar to show the applications of all
+desktops, you can move this app to the current desktop.
+</para>
+
+<para>
+There is also a small icon on the left or top side of the taskbar, which
+opens a menu. This is called the <guibutton>windows list
+icon</guibutton>. The menu's first entry, <guimenuitem>Unclutter
+Windows</guimenuitem>, tries to move the windows on your active desktop
+in a way to see as many as possible. <guimenuitem>Cascade
+Windows</guimenuitem> puts all windows on the active desktop over each
+others, the most recently on top and the others sorted by the time they
+where last used.
+</para>
+
+<para>
+Below those entries is a list of all currently running applications,
+grouped by the desktops on which they are running. Clicking on the name
+of a desktop will switch to that one, clicking an application will also
+activate it. You can specify the mouse behavior. Please refer to <link
+linkend="taskbar-settings">Taskbar</link> settings for more about that.
+</para>
+
+
+<sect2 id="configure-taskbar-applet">
+<title>Configuring the Taskbar Applet</title>
+
+<para>
+You can configure the taskbar by clicking the &RMB; on the small move
+handle.
+</para>
+<para>
+Please refer to <xref linkend="taskbar-settings"/> for details about the
+preferences of the taskbar.
+</para>
+
+</sect2>
+
+</sect1>
+
+<sect1 id="pager-applet">
+<title>The Mini-Pager Applet</title>
+
+<para>
+This little applet shows a preview of the virtual desktops, lets you
+switch between virtual desktops and gives you the ability to move windows
+from one desktop to another by dragging them.
+</para>
+
+<para>
+There is also a very useful context menu used to
+configure this applet:
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guimenuitem>Configure Desktops...</guimenuitem></term>
+<listitem>
+<para>
+This opens the configuration dialog for virtual desktops. There you can
+specify how many desktops you want to have and give them names.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guisubmenu>Pager Options</guisubmenu></term>
+<listitem>
+<para>
+In this submenu you can configure the appearance of the Mini-Pager. It
+provides the following functionality:
+</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guimenuitem>Pager Layout</guimenuitem></term>
+<listitem>
+<para>
+In this section you can choose in how many <guimenuitem>Rows</guimenuitem>
+or <guimenuitem>Columns</guimenuitem> the desktop previews are arranged,
+if you want to see which windows are currently visible on the desktops
+and if icons should indicate the applications running on the different
+vitual desktops.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Text Label</guimenuitem></term>
+<listitem>
+<para>
+Here you can choose if the desktop previews should be labeled by their
+numbers, their names or if you you don't want them to be labeled at all.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Background</guimenuitem></term>
+<listitem>
+<para>
+You can set the background of the pager to
+<guimenuitem>Elegant</guimenuitem>, <guimenuitem>Transparent</guimenuitem>
+or equivalent to the <guimenuitem>Desktop Wallpaper</guimenuitem>.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Launch Pager</guimenuitem></term>
+<listitem>
+<para>
+This launches the application &kpager;, which provides functions similar
+to those offered by the Mini-Pager applet.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="clock-applet">
+<title>The Clock Applet</title>
+
+<para>
+As you might already guess, the clock applet is a small clock which
+resides in &kicker;.
+</para>
+
+<para>
+A click with the &LMB; on the clock will show a small calendar. You can
+use the <guibutton>single arrows</guibutton> to switch the months or the
+<guibutton>double arrows</guibutton> for switching years. This won't
+have any effect of your date settings, it's just for your information.
+</para>
+
+<para>
+There are some things you can do with the clock applet. This can be done
+from the context menu.
+</para>
+
+<sect2 id="clock-type">
+<title><guisubmenu>Type</guisubmenu></title>
+
+<para>
+There are four ways the clock can appear:
+</para>
+
+<variablelist>
+<varlistentry>
+<term>Plain</term>
+<listitem>
+<para>
+This lets the clock appear as a simple text that shows the time in plain text.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Digital</term>
+<listitem>
+<para>
+This lets the clock appear as a digital clock showing the time in the
+well known seven segment style.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Analog</term>
+<listitem>
+<para>
+If this is set, the clock will be displayed as an old styled analog
+clock.
+</para>
+<note>
+<para>This may only be useful if you set &kicker; to normal or large
+size.
+</para>
+</note>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Fuzzy</term>
+<listitem>
+<para>
+This is a very unorthodox style of time display. Try it out, it is
+really funny!
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2 id="show-timezone">
+<title><guimenuitem>Show Timezone</guimenuitem></title>
+
+<para>
+Select available timezones or open the <guilabel>Timezones</guilabel>
+tab of <guilabel>Configure</guilabel> dialog of the clock applet with
+<guimenuitem>Configure Timezones...</guimenuitem>.</para>
+
+</sect2>
+
+<sect2 id="adjust-time">
+<title><guimenuitem>Adjust Date &amp; Time</guimenuitem></title>
+
+<para>
+This option starts the <guilabel>Date &amp; Time</guilabel>
+configuration module in the section <guilabel>System Administration</guilabel> of the
+&kcontrolcenter;.</para>
+
+<note>
+<para>
+You will need the super user password for adjusting date and time.
+</para>
+</note>
+
+</sect2>
+
+<sect2 id="date-format">
+<title><guimenuitem>Date &amp; Time Format</guimenuitem></title>
+
+<para>
+This will open the <guilabel>Country/Region &amp; Language</guilabel> module in the section
+<guilabel>Regional &amp; Accessibility</guilabel> of the &kcontrolcenter;
+where you can set your formats on the page <guilabel>Times &amp; Dates</guilabel>. There aren't
+any special permissions needed for that.
+</para>
+
+</sect2>
+
+<sect2 id="copy-date">
+<title><guisubmenu>Copy to Clipboard</guisubmenu></title>
+
+<para>
+If you need to paste the actual date and/or time in another application
+(&eg; in a text editor), you can copy it to the clipboard with this
+function. After selecting one of the available formats, the actual date
+and/or time is placed in the clipboard using the appropriate format.
+</para>
+
+</sect2>
+
+<sect2 id="clock-preferences">
+<title><guimenuitem>Configure Clock...</guimenuitem></title>
+
+<para>
+Here you can set some general preferences of the clock applet.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Appearence</guilabel></term>
+<listitem>
+<para>
+In the <guilabel>Clock Type</guilabel> settings you can choose between
+the clock styles like in the context menu.
+</para>
+
+<!--para>
+The <guilabel>Date</guilabel> group lets you pick font and color of the
+date, which is shown when activated for the specific clock type.
+</para>-->
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guilabel>Plain Clock</guilabel> options</term>
+<listitem>
+<para>In the <guilabel>Display</guilabel> section you can check if you
+want to have the date and/or the seconds shown. In
+<guilabel>Time</guilabel> you can choose if you want the common &tde;
+look or your own custom colors and font.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guilabel>Digital Clock</guilabel> options</term>
+<listitem>
+<para>In the <guilabel>Display</guilabel> section you can check if you
+want to have the date, the seconds and/or blinking dots shown. In
+<guilabel>Time</guilabel> you can choose if you want the common
+<acronym>LCD</acronym>-Look or your own custom colors.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guilabel>Analog Clock</guilabel> options</term>
+<listitem>
+<para>
+In the <guilabel>Display</guilabel> section you can check if you want to
+have the date and/or seconds shown. In <guilabel>Time</guilabel> you
+can choose if you want the common <acronym>LCD</acronym>-Look or your
+own custom colors.
+You can also set the level of antialiasing, which means that lines will get
+blurred a little bit to prevent steps in the drawing. High quality antialiasing
+may catch some system load on low-end systems.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>The <guilabel>Fuzzy Clock</guilabel> options</term>
+<listitem>
+<para>
+In the <guilabel>Display</guilabel> section you can check if you want to
+have the date shown. In <guilabel>Time</guilabel>
+you can choose the colors and the font of the fuzzy clock. There is also a slider to set the
+<guilabel>Fuzziness</guilabel>. This cannot be described in the
+documents, just do your own experiments.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+</sect1>
+
+<sect1 id="launcher-applet">
+<title>The Quick Launcher Applet</title>
+
+<para>
+This is a compressed application launcher. It is very useful especially
+if the panel is set to normal or large size. You can add applications by
+drag and drop or from the context menu. The
+context menu is also used to remove an application.
+</para>
+</sect1>
+
+<sect1 id="systemtray-applet">
+<title>The System Tray Applet</title>
+
+<para>
+The System Tray is used to dock some special applications &eg;
+&klipper; or &juk;. The applications shown in the system tray all
+provide individual funtionality. If you need help concerning these
+options, please refer to the application handbooks.
+</para>
+
+<para>
+The System Tray's context menu provides the option
+<guimenuitem>Configure System Tray...</guimenuitem> . If you click on it,
+a dialog pops up which lets you choose applications that should not be
+permanently visible in the System Tray. Hidden icons can be made visible
+by clicking on the small arrow appearing on the left or top side of the
+applet.
+</para>
+</sect1>
+
+<sect1 id="lockout-applet">
+<title>Lock/Logout Applet</title>
+<para>
+This little applet contains two buttons.
+The <guibutton>Lock the session</guibutton> is used to lock the session if you
+ever want to leave your &tde; unattended and don't want anybody to access it.
+The <guibutton>Log out</guibutton> is used to close your &tde; session.
+</para>
+</sect1>
+
+<sect1 id="run-applet">
+<title>The Application Launcher Applet</title>
+
+<para>
+This applet provides a simple command line embedded in &kicker;. Nothing
+more, nothing less.
+</para>
+
+</sect1>
+
+<sect1 id="naughty-applet">
+<title>The Runaway Process Catcher Applet</title>
+
+<para>
+This applet shows a smiley which will get angry when any process catches
+up too much system resources. If an application uses too much, a
+messagebox will appear and ask you how to handle that application.
+</para>
+
+<para>
+Clicking it with the &LMB; will show a configuration dialog. Here you
+can set the <guilabel>Update interval</guilabel>, which is set in
+seconds, and the <guilabel>CPU load threshold</guilabel>. At the
+moment, there is no real advice for setting this up, you will have to do
+some experimenting. These settings will probably change in a future
+release. There is also a section <guilabel>Programs to ignore</guilabel>
+where you can add applications that use many resources naturally,
+&eg; compilers or 3D renderers.
+</para>
+
+</sect1>
+
+<sect1 id="klipper-applet">
+<title>&klipper; Applet</title>
+
+<para>
+This applet does exactly the same like the &klipper; residing in the system
+tray. It has the advantage, that it consumes a little bit less system
+resources, which only matters on really slow systems, but has the
+disadvantage, that it uses more space than &klipper; in the system
+tray. You can read more about that in the manual for
+<ulink url="help:/klipper/index.html">&klipper;</ulink>.
+</para>
+</sect1>
+
+</chapter>
+
+<chapter id="extensions">
+<title>Panel Extensions</title>
+
+<para>
+There are also some features that run outside of &kicker;, the
+extensions. They are added from the
+context menu by choosing <guisubmenu>Add New Panel</guisubmenu>. You can move them to any
+screenborder by dragging them at the small applet
+handle on their side and remove it by right clicking on an empty space and choose
+<guimenuitem>Remove Panel</guimenuitem>.
+</para>
+
+<para>
+The style of the extensions can be configured in the <xref
+linkend="panel-extensions"/> section of &kicker;'s preferences.
+</para>
+
+
+<sect1 id="external-taskbar-extension">
+<title>The External Taskbar Panel Extension</title>
+
+<para>
+The external taskbar is just the same as the taskbar applet with the
+only difference that it provides its own panel. Refer to the <link
+linkend="taskbar-applet">taskbar applet section</link> for help about
+it.
+</para>
+
+</sect1>
+
+<sect1 id="child-panel-extension">
+<title>The Child Panel Extension</title>
+
+<para>
+This is just a panel like &kicker; itself, where you can add all the
+stuff &kicker; is also capable. So you can have as many &kicker;s as you
+want. Just add a child panel and add applications and applets to it.
+</para>
+
+</sect1>
+
+<sect1 id="kasbar-extension">
+<title>The <application>KasBar</application> Extension</title>
+
+<para>
+The <application>KasBar</application> is an iconic replacement of the
+taskbar. It always shows the icons of all currently running applications
+on any desktop, they can be chosen by clicking with the &LMB;. The
+active window is highlighted, minimized windows will show a little
+triangle pointing downwards instead of the square in the lower right of
+the icons. A triangle pointing to the right indicates that the
+application is shaded.
+</para>
+</sect1>
+
+<sect1 id="dock-application-bar-extension">
+<title>The Dock Application Bar Extension</title>
+
+<para>
+The Dock Application Bar is an external bar which lets WindowMaker
+applications be docked. Just run your dockable WindowMaker programs, if
+the Dock Application Bar is running, they will be automatically docked.
+</para>
+</sect1>
+
+</chapter>
+
+<chapter id="commands">
+<title>Command Reference</title>
+
+<sect1 id="keybinding">
+<title>The Panel</title>
+
+<para>
+There is only one standard shortcut available in &kicker;:
+</para>
+
+<variablelist>
+<varlistentry>
+<term><keycombo action="simul">&Alt;<keycap>F1</keycap></keycombo></term>
+<listitem>
+<para>
+Opens the <guimenu>TDE</guimenu> Menu
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+</chapter>
+
+<chapter id="faq">
+<title>Questions and Answers</title>
+
+<qandaset>
+<qandaentry>
+<question>
+<para>
+How can I add applications, applets or anything else to the panel?
+</para>
+</question>
+<answer>
+<para>
+Click the &RMB; on any free space in &kicker; and choose
+what you want to add. See in <link linkend="basics">&kicker; Basics</link>
+for more about that.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+Can I have an external Taskbar just like in &tde; 1?
+</para>
+</question>
+<answer>
+<para>
+Yes, you can just click the &RMB; on any empty space in &kicker; and
+then choose <guisubmenu>Add</guisubmenu>,
+<guisubmenu>Panel</guisubmenu> and the <guimenuitem>External
+Taskbar</guimenuitem>.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+How can I move &kicker; to another screen border?
+</para>
+</question>
+
+<answer>
+<para>
+Simply drag it by holding the &LMB; on any empty space in &kicker; to
+any screen border.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+How can I move extensions to another screen border?
+</para>
+</question>
+
+<answer>
+<para>
+Just drag them by holding the &LMB; on the small
+<guibutton>handles</guibutton> on the left or the top of the extension.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+I want the taskbar to show all applications I am running, independent on
+which desktop they are. Is that possible?
+</para>
+</question>
+<answer>
+<para>
+It is. Click the &RMB; on the small <guibutton>handle</guibutton> of the
+taskbar, then choose <guimenuitem>Configure Taskbar...</guimenuitem> and check
+<guilabel>Show windows from all desktops</guilabel> in the appearing dialog.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+How can I access the <guimenu>TDE</guimenu> Menu without using the mouse?
+</para>
+</question>
+<answer>
+<para>
+Simply press <keycombo
+action="simul">&Alt;<keycap>F1</keycap></keycombo> and it will appear.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+Is there a way to add a menu containing all desktop icons to &kicker;?
+</para>
+</question>
+<answer>
+<para>
+Just start &konqueror;, go to your home folder and drag the
+<guiicon>Desktop</guiicon> icon to any free space of &kicker;, then
+choose <guimenuitem>Add as Quick Browser</guimenuitem> from the
+appearing menu.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+How can I change the color and style of &kicker;?
+</para>
+</question>
+<answer>
+<para>
+You can change the colors of the panel with the global color module of
+the <application>Control Center</application> or you can style the panel
+itself, see in <xref linkend="panel-appearance"/> for more about that.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+Why is the clock showing the wrong time?
+</para>
+</question>
+<answer>
+<para>
+On some &RedHat;systems, the clock always shows the time in
+&GMT;. This is a bug in the system setup, and not
+directly related to &kicker;. However, to solve it, just create this
+symbolic link: <userinput><command>ln</command> <option>-s</option>
+<filename>/usr/share/zoneinfo</filename>
+<filename>/usr/lib/zoneinfo</filename></userinput>.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+Is it possible to change the <guiicon>T</guiicon> button of the panel to
+another picture?
+</para>
+</question>
+<answer>
+<para>
+Look for <filename>$HOME/.trinity/share/apps/kicker/pics/go.png</filename>
+and <filename>$HOME/.trinity/share/apps/kicker/pics/mini/go.png</filename>
+and replace them. Do not forget to flatten the replacements to one
+layer, or else you will not see anything. Create the folders if
+they do not already exist. Then restart &kicker;.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+Why is my <guisubmenu>Settings</guisubmenu> menu not working?
+</para>
+</question>
+<answer>
+<para>
+Your menu entries may be mixed up for some reason. Simply run
+<command>tdebuildsycoca</command> on a commandline.
+</para>
+</answer>
+</qandaentry>
+</qandaset>
+
+&reporting.bugs;
+<!-- &updating.documentation; -->
+
+</chapter>
+
+<chapter id="credits">
+
+<title>Credits and License</title>
+
+<para>
+&kicker;
+</para>
+
+<para>
+Program copyright 1999-2000 The &kde; Team <ulink
+url="http://www.kde.org"> (www.kde.org)</ulink>.
+</para>
+
+<itemizedlist>
+<listitem>
+<para>&Matthias.Elter; &Matthias.Elter.mail;
+</para>
+</listitem>
+
+<listitem>
+<para>&Matthias.Ettrich; &Matthias.Ettrich.mail;
+</para>
+</listitem>
+
+<listitem>
+<para>&Wilco.Greven; &Wilco.Greven.mail;
+</para>
+</listitem>
+
+<listitem>
+<para>&Rik.Hemsley; &Rik.Hemsley.mail;
+</para>
+</listitem>
+
+<listitem>
+<para>&Daniel.M.Duley; &Daniel.M.Duley.mail;
+</para>
+</listitem>
+
+<listitem>
+<para>&Preston.Brown; &Preston.Brown.mail;
+</para>
+</listitem>
+
+</itemizedlist>
+
+<para>Original documentation copyright 2001, 2002 &Dirk.Doerflinger;
+&Dirk.Doerflinger.mail;</para>
+<para>Portions copyright 2004 &Orville.Bennett;
+<email>&Orville.Bennett.mail;</email></para>
+<para>Portions copyright 2005 Titus Laska
+<email>[email protected]</email></para>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL; <!-- FDL: do not remove -->
+&underBSDLicense; <!-- BSD License -->
+
+</chapter>
+
+&documentation.index;
+
+</book>
diff --git a/doc/kicker/k_menu_icon.png b/doc/kicker/k_menu_icon.png
new file mode 100644
index 000000000..17535f876
--- /dev/null
+++ b/doc/kicker/k_menu_icon.png
Binary files differ
diff --git a/doc/kicker/man-appletproxy.1.docbook b/doc/kicker/man-appletproxy.1.docbook
new file mode 100644
index 000000000..bb9c40723
--- /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>Trinity Desktop Environment</productname>
+</refentryinfo>
+
+<refmeta>
+<refentrytitle><command>appletproxy</command></refentrytitle>
+<manvolnum>1</manvolnum>
+</refmeta>
+
+<refnamediv>
+<refname><command>appletproxy</command></refname>
+<refpurpose>&tde; 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; (&tde; 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 &tde; 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..ef36705f4
--- /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>Trinity Desktop Environment</productname>
+</refentryinfo>
+
+<refmeta>
+<refentrytitle><command>kicker</command></refentrytitle>
+<manvolnum>1</manvolnum>
+</refmeta>
+
+<refnamediv>
+<refname><command>kicker</command></refname>
+<refpurpose>&kicker; is the &tde; 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 &tde; 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>TDEHOME</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 &tde; 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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ