From 60d12b91f2688a379b12de756aed065faa6fb5c3 Mon Sep 17 00:00:00 2001
From: Yuri Chornoivan <yurchor@ukr.net>
Date: Sat, 10 Apr 2021 18:59:20 +0300
Subject: [PATCH] Add touch screen KCM docs

---
 doc/CMakeLists.txt                            |  1 +
 doc/kwintouchscreen/CMakeLists.txt            |  2 +
 doc/kwintouchscreen/index.docbook             | 40 +++++++++++++++++++
 .../kwinscreenedges/kwintouchscreen.desktop   |  1 +
 4 files changed, 44 insertions(+)
 create mode 100644 doc/kwintouchscreen/CMakeLists.txt
 create mode 100644 doc/kwintouchscreen/index.docbook

diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
index 4b9858e596..22bd4a3a6b 100644
--- a/doc/CMakeLists.txt
+++ b/doc/CMakeLists.txt
@@ -2,6 +2,7 @@ ecm_optional_add_subdirectory(desktop)
 ecm_optional_add_subdirectory(kwindecoration)
 ecm_optional_add_subdirectory(kwinscreenedges)
 ecm_optional_add_subdirectory(kwintabbox)
+ecm_optional_add_subdirectory(kwintouchscreen)
 ecm_optional_add_subdirectory(windowbehaviour)
 ecm_optional_add_subdirectory(windowspecific)
 ecm_optional_add_subdirectory(kwineffects)
diff --git a/doc/kwintouchscreen/CMakeLists.txt b/doc/kwintouchscreen/CMakeLists.txt
new file mode 100644
index 0000000000..3c3bb44975
--- /dev/null
+++ b/doc/kwintouchscreen/CMakeLists.txt
@@ -0,0 +1,2 @@
+########### install files ###############
+kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${KDE_INSTALL_DOCBUNDLEDIR}/en SUBDIR kcontrol/kwintouchscreen)
diff --git a/doc/kwintouchscreen/index.docbook b/doc/kwintouchscreen/index.docbook
new file mode 100644
index 0000000000..ca051bcca1
--- /dev/null
+++ b/doc/kwintouchscreen/index.docbook
@@ -0,0 +1,40 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
+"dtd/kdedbx45.dtd" [
+<!ENTITY % addindex "IGNORE">
+<!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<article id="kwinscreenedges" lang="&language;">
+<articleinfo>
+
+<title>Touch Screen</title>
+<authorgroup>
+<author>&Mike.McBride; &Mike.McBride.mail;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2021-04-10</date>
+<releaseinfo>Plasma 5.20</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>Systemsettings</keyword>
+<keyword>touch</keyword>
+<keyword>screen</keyword>
+</keywordset>
+</articleinfo>
+
+<para>Swiping from the screen edge towards the center of the screen allow you to activate effects. Here you can configure which effect will get activated on each edge of the screen.
+</para>
+
+<para>Click with any mouse button onto a square and select an effect 
+in the context menu. Edges with a blue square have already an attached effect, 
+a grey-colored square indicates that no effect is selected for this edge.</para>
+
+<para>The number of accessible items in the context menu depends on the settings in the module
+	<ulink url="help:/kcontrol/kwineffects/index.html">
+<guilabel>Desktop Effects</guilabel></ulink> in the <guilabel>Workspace</guilabel>
+category. Select your favorite effects from the <guilabel>Window Management</guilabel> 
+group. This activates the corresponding items in the context menu.</para>
+</article>
diff --git a/src/kcmkwin/kwinscreenedges/kwintouchscreen.desktop b/src/kcmkwin/kwinscreenedges/kwintouchscreen.desktop
index ee9ceaa977..49e9728b07 100644
--- a/src/kcmkwin/kwinscreenedges/kwintouchscreen.desktop
+++ b/src/kcmkwin/kwinscreenedges/kwintouchscreen.desktop
@@ -2,6 +2,7 @@
 Icon=preferences-desktop-gestures-touch
 Type=Service
 X-KDE-ServiceTypes=KCModule
+X-DocPath=kcontrol/kwintouchscreen/index.html
 
 X-KDE-Library=kcm_kwintouchscreen
 X-KDE-ParentApp=kcontrol