Merge kcontrol/panel help handbooks into kicker help handbook, delete

duplicate kcontrol/panel handbooks, and update respective *.desktop files.

9 files changed, 0 insertions, 551 deletions

diff --git a/doc/kcontrol/kcmtaskbar/CMakeLists.txt b/doc/kcontrol/kcmtaskbar/CMakeLists.txt
deleted file mode 100644
index 7f441092d..000000000
--- a/doc/kcontrol/kcmtaskbar/CMakeLists.txt
+++ /dev/null
@@ -1,12 +0,0 @@
-#################################################
-#
-#  (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 kcontrol/kcmtaskbar )
diff --git a/doc/kcontrol/kcmtaskbar/Makefile.am b/doc/kcontrol/kcmtaskbar/Makefile.am
deleted file mode 100644
index 756585015..000000000
--- a/doc/kcontrol/kcmtaskbar/Makefile.am
+++ /dev/null
@@ -1,2 +0,0 @@
-KDE_LANG = en
-KDE_DOCS = kcontrol/kcmtaskbar
diff --git a/doc/kcontrol/kcmtaskbar/index.docbook b/doc/kcontrol/kcmtaskbar/index.docbook
deleted file mode 100644
index 3f73691a3..000000000
--- a/doc/kcontrol/kcmtaskbar/index.docbook
+++ /dev/null
@@ -1,142 +0,0 @@
-<?xml version="1.0" ?>
-<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
-"dtd/kdex.dtd" [
-<!ENTITY % addindex "IGNORE">
-<!ENTITY % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-<articleinfo>
-
-<authorgroup>
-<author>&Mike.McBride; &Mike.McBride.mail;</author>
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2006-06-24</date>
-<releaseinfo>3.5.2</releaseinfo>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>KControl</keyword>
-<keyword>taskbar</keyword>
-<keyword>configure</keyword>
-</keywordset>
-</articleinfo>
-
-<sect1 id="taskbar">
-<title>Taskbar</title>
-
-<sect2>
-<title><guilabel>Taskbar</guilabel></title>
-
-<para>The taskbar is a quick way to switch between applications.  The taskbar
-can be located in the panel (default), or outside the panel on the
-desktop.</para>
-
-<para>This module has options to control how the taskbar operates:</para>
-
-<para><guilabel>Show windows from all desktops</guilabel>, determines
-if 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>.
-<guilabel>Sort windows by desktop</guilabel> 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>
-
-<para><guilabel>Sort alphabetically by application name</guilabel> shows
-the icons in an alphabetical sort order on the taskbar.</para>
-
-<para>You can have the taskbar <guilabel>Show only minimized
-windows</guilabel>.  In this case, when you minimize a window, it will
-show up on the taskbar, and when you open it again, its taskbar entry
-will disappear.</para>
-
-<para>You can disable <guilabel>Show application icons</guilabel>, and show just the
-text.  You might want to do this to save space on your taskbar, for
-example.</para>
-
-<para>Using the <guilabel>Show window list button</guilabel> option,
-you can enable a little button to be shown in the taskbar: this button
-will open a popup menu offering access to applications on other desktops
-as well as some useful actions, like <guilabel>Unclutter
-Windows</guilabel> or <guilabel>Cascade Windows</guilabel>.</para>
-
-<para><guilabel>Group similar tasks</guilabel> allows
-you to save some space on your taskbar, by only showing one icon for
-each running application, no matter how many windows are shown.  You can
-click on the icon to display a menu of all the windows that are
-available.  This is most useful when you have enabled <guilabel>Show windows
-from all desktops</guilabel>.</para>
-
-<para>The next option allows you to set the <guilabel>Appearance</guilabel> to <guilabel>Elegant</guilabel>, <guilabel>Classic</guilabel> or <guilabel>For Transparency</guilabel>.</para>
-
-</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>
-
-<para>The options available are:</para>
-
-<variablelist>
-<varlistentry>
-<term><guilabel>Show Task List</guilabel></term>
-<listitem>
-<para>Show the list of tasks grouped under the icon you have clicked
-on.  If there is only one task or window for that icon, it will become
-the active window.</para>
-<para>This is the default action for the &LMB;.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>Cycle Through Windows</guilabel></term>
-<listitem>
-<para>If there is more than one task grouped under the icon, switch
-from one to the next, until you release the button (&ie; when you have
-reached the window you are looking for). If there is only one task or
-window for that icon, it will become the active window.</para> 
-
-<para>This is the default action for the &MMB; if window grouping is
-enabled.</para>
-
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>Show Operations Menu</guilabel></term>
-<listitem>
-<para>Show the operations menu for the application.  This allows you
-to minimize, maximize, &etc;, move windows between desktops, and close
-windows. You can perform these actions on all windows grouped under
-that icon, or on any single window, by choosing it from the
-submenu.</para>
-<para>This is the default action for the &RMB;.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>Raise Task</guilabel>, <guilabel>Lower
-Task</guilabel>, <guilabel>Minimize Task</guilabel></term>
-<listitem>
-<para>These three options make sense only if window grouping is
-disabled.  They are fairly self-explanatory.  Raise means to make
-active, bring to the front, and give focus.  Lower means, send to the
-back, and give focus to whichever window is now on top.</para>
-</listitem>
-</varlistentry>
-</variablelist>
-
-</sect2>
-
-</sect1>
-
-</article>
\ No newline at end of file
diff --git a/doc/kcontrol/panel/CMakeLists.txt b/doc/kcontrol/panel/CMakeLists.txt
deleted file mode 100644
index cdb63d917..000000000
--- a/doc/kcontrol/panel/CMakeLists.txt
+++ /dev/null
@@ -1,12 +0,0 @@
-#################################################
-#
-#  (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 kcontrol/panel )
diff --git a/doc/kcontrol/panel/Makefile.am b/doc/kcontrol/panel/Makefile.am
deleted file mode 100644
index 06524aebe..000000000
--- a/doc/kcontrol/panel/Makefile.am
+++ /dev/null
@@ -1,2 +0,0 @@
-KDE_LANG = en
-KDE_DOCS = kcontrol/panel
diff --git a/doc/kcontrol/panel/index.docbook b/doc/kcontrol/panel/index.docbook
deleted file mode 100644
index 665e69c2f..000000000
--- a/doc/kcontrol/panel/index.docbook
+++ /dev/null
@@ -1,244 +0,0 @@
-<?xml version="1.0" ?>
-<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
-"dtd/kdex.dtd" [
-<!ENTITY % addindex "IGNORE">
-<!ENTITY % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-<articleinfo>
-
-<authorgroup>
-<author>&Mike.McBride; &Mike.McBride.mail;</author>
-<author>&Lauri.Watts; &Lauri.Watts.mail;</author>
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2005-02-20</date>
-<releaseinfo>3.4</releaseinfo>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>KControl</keyword>
-<keyword>panel</keyword>
-</keywordset>
-</articleinfo>
-
-<sect1 id="panel">
-<title>Panel</title>
-
-<para> The &tde; panel (often referred to as &kicker;) is the bar that
-you'll usually find at the bottom of the screen when you start up &tde;
-for the first time. For detailed help on &kicker;'s usage you can type
- <ulink url="help:/kicker">help:/kicker</ulink> in &konqueror; to read
-the user manual.</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>
-
-<sect2 id="panel-position">
-<title><guilabel>Arrangement</guilabel></title>
-
-<para>In the <guilabel>Arrangement</guilabel> tab you can configure the size and
-position of the panel.</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 section labeled <guilabel>Position</guilabel> is a set of
-12 small 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 if the panel is aligned horizontally, &ie; attached to the
-top or bottom screen border.</para></tip>
-
-<para>In the section labeled <guilabel>Length</guilabel>, you can use
-the combo box and slider to adjust the <emphasis>minimum</emphasis>
-length of the panel.  If you place a mark in the checkbox labeled
-<guilabel>Expand as required to fit contents</guilabel>, 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 primarey 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>Hiding</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>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>
-
-<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.)</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>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>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>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>If there is no mark in the checkbox labeled <guilabel>Animate 
-panel hiding</guilabel>, then whenever the toolbar is hidden, is simply disappears.  If there 
-is a mark in the check box, then the panel appears to slide off the edge of the screen.</para>
-
-<para>You can determine how quickly the panel appears to move by adjusting the slider from 
-<guilabel>Fast</guilabel> to <guilabel>Slow</guilabel>.</para>
-</sect2>
-
-<sect2 id="panel-menus">
-<title>Menus</title>
-
-<para>In the <guilabel>Menus</guilabel> tab you can configure the panel
-menu's behavior. This affects the TDE menu you will often use to launch
-applications, the browser menus you can use to access folders and other
-menus like the recent documents menu.</para>
-
-<para>The <guilabel>TDE Menu</guilabel> frame offers you some options to
-configure the <guimenu>TDE</guimenu> menu's functionality. This frame consists 
-of 4 items:</para>
-
-<itemizedlist>
-<listitem><para>The <guilabel>Menu item format:</guilabel> radio
-buttons have three options.  This determines how the application name
-(&ie; &konqueror;, &kword;, &etc;) and the description (&ie; Web
-Browser, Word Processor, &etc;) are displayed on the &kmenu;.
-</para></listitem>
-
-<listitem><para>The <guilabel>Optional Menus</guilabel> checkboxes allow
-you to
-determine which special menu items appear in the &kmenu;.</para>
-<para>The <guilabel>Bookmarks</guilabel> 
-menu allows you to quickly select from the same bookmarks that are available in &konqueror;.</para>
-<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>
-<para>The <guilabel>Konqueror Profiles</guilabel> menu allows you to
-launch &konqueror; with any of your configured profiles.</para>
-<para>The <guilabel>Network Folders</guilabel> menu can launch a
-&konqueror; file manager window displaying any of your configured
-network folders.</para>
-<para>The <guilabel>Preferences</guilabel> menu allows you to launch each &kcontrol; module 
-directly from the TDE menu.</para>
-<para>The <guilabel>Print System</guilabel> menu provides several menu entries to help manage 
-the printer(s) attached to your system.</para>
-<para>The <guilabel>Quick Browser</guilabel> menu gives you quick links to locations on your hard drive.</para>
-<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>
-<para>The <guilabel>System</guilabel> menu 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>
-<para>The <guilabel>Terminal Sessions</guilabel> menu provides menu items to launch several different types of 
-terminal programs (command line interfaces).</para>
-</listitem>
-
-<listitem><para><guilabel>Show side image</guilabel> will add a small
-image to the side of the menu.  This is purely decorative.</para></listitem>
-
-<listitem><para>The <guibutton>Edit TDE Menu</guibutton> button launches the &tde; 
-menu editor.</para></listitem>
-</itemizedlist>
-
-<para> In the <guilabel>QuickBrowser Menus</guilabel> area you can configure
-whether the panel's browser menus will show hidden files or not (hidden
-files on &UNIX; systems are those whose filenames begin with a dot) as
-well as how many files at most will be shown in a browser menu. The
-latter option may be especially useful if you have a rather small screen
-resolution, as then the browser menus will quickly fill up your screen
-when you browse folders containing many files.</para>
-
-<para>The quick start section in the TDE menu offers quick access to
-programs you have used often or recently. In the <guilabel>Quick Start Menu Items</guilabel> 
-frame you can choose whether
-this section will show the most recently or the most frequently used
-programs. Using the option <guilabel>Maximum number of entries</guilabel> 
-combo box, you can configure how many programs the quick start 
-section will remember.</para>
-
-</sect2>
-
-
-
-</sect1>
-
-</article>
diff --git a/doc/kcontrol/panelappearance/CMakeLists.txt b/doc/kcontrol/panelappearance/CMakeLists.txt
deleted file mode 100644
index 171bbdd3a..000000000
--- a/doc/kcontrol/panelappearance/CMakeLists.txt
+++ /dev/null
@@ -1,12 +0,0 @@
-#################################################
-#
-#  (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 kcontrol/panelappearance )
diff --git a/doc/kcontrol/panelappearance/Makefile.am b/doc/kcontrol/panelappearance/Makefile.am
deleted file mode 100644
index 1a92a45e8..000000000
--- a/doc/kcontrol/panelappearance/Makefile.am
+++ /dev/null
@@ -1,3 +0,0 @@
-KDE_LANG = en
-KDE_DOCS = kcontrol/panelappearance
-
diff --git a/doc/kcontrol/panelappearance/index.docbook b/doc/kcontrol/panelappearance/index.docbook
deleted file mode 100644
index 0a1024e19..000000000
--- a/doc/kcontrol/panelappearance/index.docbook
+++ /dev/null
@@ -1,122 +0,0 @@
-<?xml version="1.0" ?>
-<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
-"dtd/kdex.dtd" [
-<!ENTITY % addindex "IGNORE">
-<!ENTITY % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-<articleinfo>
-
-<authorgroup>
-<author>
-<firstname>Mike</firstname>
-<surname>McBride</surname>
-</author>
-<author>
-<firstname>Jost</firstname>
-<surname>Schenck</surname>
-</author>
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2003-10-06</date>
-<releaseinfo>3.2</releaseinfo>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>KControl</keyword>
-<keyword>panel</keyword>
-</keywordset>
-</articleinfo>
-
-<sect1 id="panel">
-<title>Panel</title>
-
-<para>Here you can configure the panel's overall appearance.</para>
-
-<para>You can also have the icons themselves zoom out when the
-mouse is over them, with the <guilabel>Enable icon zooming</guilabel>
-option. You can choose to have tooltips appear when your mouse button is
-over an icon, by enabling the <guilabel>Show tooltips</guilabel>
-option.</para>
-
-<sect2 id="button-backgrounds">
-<title>Button Backgrounds</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>
-
-</sect2>
-
-<sect2 id="panel-background">
-<title><guilabel>Panel Background</guilabel></title>
-
-<para><guilabel>Enable transparency</guilabel> to turn the entire
-panel transparent.  The desktop background will show through instead
-of a background image or color.</para>
-
-<para>There will still be small handles beside each applet, to allow
-you to locate, move, and configure them.  These can be turned off in
-the <guilabel>Advanced Options</guilabel></para>
-
-<para>If you check <guilabel>Enable background image</guilabel> a
-picture will be used to draw the panel's background, just as you
-can use a picture for the desktop background. You can specify an image
-file in the line edit box below or choose one by clicking on the
-<guibutton>Browse</guibutton> button. You'll see a preview of the
-selected picture on the right.</para>
-
-<para>The image can be tinted on-the-fly by enabling the option
-<guilabel>Colorize to match the desktop color scheme</guilabel>.  You
-might use a grayscale texture that is tinted in this manner, to create
-a particular effect.</para>
-</sect2>
-
-<sect2 id="advanced-options">
-<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>
-
-</sect2>
-
-<sect2 id="panel-author">
-<title>Section Author</title>
-<para>This section written by: Jost Schenck <email>jost@schenck.de</email></para>
-<para>Minor update by Mike McBride
-<email>mpmcbride7@yahoo.com</email></para>
-
-<para>Some new options added by Lauri Watts
-<email>lauri@kde.org</email></para>
-
-<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
-
-</sect2>
-
-</sect1>
-
-</article>