From 112fc37d8042129a26386e454373cccae51fc448 Mon Sep 17 00:00:00 2001
From: Darrell Anderson <humanreadable@yahoo.com>
Date: Tue, 28 Jan 2014 19:26:28 -0600
Subject: [PATCH] Add new kcontrol service manager help handbook.

---
 doc/kcontrol/kcmkded/CMakeLists.txt |  9 ++++
 doc/kcontrol/kcmkded/Makefile.am    |  2 +
 doc/kcontrol/kcmkded/index.docbook  | 79 +++++++++++++++++++++++++++++
 kcontrol/kded/kcmkded.desktop       |  6 +--
 4 files changed, 92 insertions(+), 4 deletions(-)
 create mode 100644 doc/kcontrol/kcmkded/CMakeLists.txt
 create mode 100644 doc/kcontrol/kcmkded/Makefile.am
 create mode 100644 doc/kcontrol/kcmkded/index.docbook

diff --git a/doc/kcontrol/kcmkded/CMakeLists.txt b/doc/kcontrol/kcmkded/CMakeLists.txt
new file mode 100644
index 000000000..dadaba19e
--- /dev/null
+++ b/doc/kcontrol/kcmkded/CMakeLists.txt
@@ -0,0 +1,9 @@
+#################################################
+#
+#  Improvements and feedback are welcome
+#
+#  This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION kcontrol/kcmkded )
diff --git a/doc/kcontrol/kcmkded/Makefile.am b/doc/kcontrol/kcmkded/Makefile.am
new file mode 100644
index 000000000..c7b22c34e
--- /dev/null
+++ b/doc/kcontrol/kcmkded/Makefile.am
@@ -0,0 +1,2 @@
+KDE_LANG = en
+KDE_DOCS = kcontrol/kcmkded
diff --git a/doc/kcontrol/kcmkded/index.docbook b/doc/kcontrol/kcmkded/index.docbook
new file mode 100644
index 000000000..10dc53b76
--- /dev/null
+++ b/doc/kcontrol/kcmkded/index.docbook
@@ -0,0 +1,79 @@
+<?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;">
+<title>Service Manager</title>
+
+<articleinfo>
+
+<authorgroup>
+<author>
+<firstname>Burkhard</firstname><surname>Lück</surname>
+</author>
+<author>&tde-authors;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<copyright>
+<year>2009</year>
+<holder>Burkhard Lück</holder>
+</copyright>
+<copyright>
+<year>&tde-copyright-date;</year>
+<holder>&tde-team;</holder>
+</copyright>
+
+<releaseinfo>&tde-release-version;</releaseinfo>
+<date>Reviewed: &tde-release-date;</date>
+
+<keywordset>
+<keyword>TDE</keyword>
+<keyword>KControl</keyword>
+<keyword>System Settings</keyword>
+<keyword>services</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="service-manager">
+<title>Service Manager</title>
+
+<para>
+The <guilabel>Service Manager</guilabel> module allows you view all
+plugins of the &tde; Daemon, also referred to as &tde; Services. Generally,
+there are two types of services:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Load-on-Demand Services</guilabel></term>
+<listitem><para>
+This is a list of available &tde; services that will be started on demand.
+They are only listed for convenience, as you cannot manipulate these
+services.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Startup Services</guilabel></term>
+<listitem><para>
+This shows all &tde; services that can be loaded on &tde; startup.
+Services checked in the <guilabel>Use</guilabel> column will be launched the next &tde; startup.</para>
+<para>Be careful with deactivating unknown services as some services are vital for &tde;. Basically,
+do not deactivate services when you do not know what you are doing.
+</para>
+<para>Change the <guilabel>Status</guilabel> of a service by selecting the service in the list.
+Use the <guibutton>Start</guibutton> and <guibutton>Stop</guibutton>
+to change the status of a service from <guilabel>Not running</guilabel> to <guilabel>Running</guilabel>
+and vice versa.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+</article>
diff --git a/kcontrol/kded/kcmkded.desktop b/kcontrol/kded/kcmkded.desktop
index a081096a8..559b55ca6 100644
--- a/kcontrol/kded/kcmkded.desktop
+++ b/kcontrol/kded/kcmkded.desktop
@@ -2,11 +2,11 @@
 Exec=tdecmshell kcmkded
 Icon=services
 Type=Application
-
-
+DocPath=kcontrol/kcmkded/index.html
 X-TDE-Library=kded
 X-TDE-Factoryname=kded
 X-TDE-ParentApp=kcontrol
+Categories=Qt;TDE;X-TDE-settings-components;
 
 Name=Service Manager
 Name[af]=Diens Bestuurder
@@ -232,5 +232,3 @@ Keywords[xh]=KDED,Daemon,Iinkonzo
 Keywords[zh_CN]=KDED,Daemon,Services,守护程序,服务
 Keywords[zh_TW]=KDED,Daemon,Services,伺服程式,服務
 Keywords[zu]=KDED,Daemon,Imisebenzi
-
-Categories=Qt;TDE;X-TDE-settings-components;