From 631172e074ee702ff468b81e3a5c956515a2061a Mon Sep 17 00:00:00 2001
From: Mavridis Philippe <mavridisf@gmail.com>
Date: Wed, 28 Jun 2023 12:44:04 +0300
Subject: kcmtwin: Move Active Borders options into a new tab

Signed-off-by: Mavridis Philippe <mavridisf@gmail.com>
---
 doc/kcontrol/windowbehavior/index.docbook | 77 +++++++++++++++++--------------
 1 file changed, 43 insertions(+), 34 deletions(-)

(limited to 'doc/kcontrol')

diff --git a/doc/kcontrol/windowbehavior/index.docbook b/doc/kcontrol/windowbehavior/index.docbook
index b503636c7..310c6b021 100644
--- a/doc/kcontrol/windowbehavior/index.docbook
+++ b/doc/kcontrol/windowbehavior/index.docbook
@@ -714,45 +714,14 @@ less.</para>
 
 </sect2>
 
-<sect2 id="advanced">
-<title>Advanced</title>
-
-<para>
-In the <guilabel>Advanced</guilabel> panel you can do more advanced fine
-tuning to the window behavior.
-</para>
-
-<variablelist>
-<title>Shading</title>
-
-<varlistentry>
-<term><guilabel>Animate</guilabel></term>
-<listitem>
-<para>When this option is enabled,  shading, or rolling up a window until just
-the title bar is shown, will be animated.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>Enable hover</guilabel></term>
-<listitem>
-<para>
-When this option is enabled, a shaded window will un-shade automatically
-when the mouse pointer has been over the titlebar for the configured delay.
-Use the slider widget to configure the delay.
-</para>
-</listitem>
-</varlistentry>
-
-</variablelist>
-
-<variablelist id="active-borders">
+<sect2 id="active-borders">
 <title>Active Borders</title>
 
-<para>Active Borders is a feature which allows you to quickly perform window management actions by moving your mouse into a desktop border.</para>
+<para><guilabel>Active Borders</guilabel> is a feature which allows you to quickly perform window management actions by moving your mouse into a desktop border.</para>
 
 <para>The corresponding section allows you to configure the function that will be performed when pushing your mouse cursor against a border or moving a window into it:</para>
 
+<variablelist>
 <varlistentry>
 <term><guilabel>Disabled</guilabel></term>
 <listitem>
@@ -783,6 +752,46 @@ Use the slider widget to configure the delay.
 This option controls the delay before the designated active border function is performed. A higher value can prevent accidental activations of this feature.
 </para>
 
+<para>
+<guilabel>Border activation distance</guilabel>.
+This option controls how far from a desktop edge the mouse cursor should be in order to be able to activate the corresponding function. The default value is low,
+meaning that you have to be very close to the border or corner to trigger it, preventing accidental activations. A higher value means easier activation without
+having to actually push against the borders and corners.
+</para>
+</sect2>
+
+<sect2 id="advanced">
+<title>Advanced</title>
+
+<para>
+In the <guilabel>Advanced</guilabel> panel you can do more advanced fine
+tuning to the window behavior.
+</para>
+
+<variablelist>
+<title>Shading</title>
+
+<varlistentry>
+<term><guilabel>Animate</guilabel></term>
+<listitem>
+<para>When this option is enabled,  shading, or rolling up a window until just
+the title bar is shown, will be animated.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Enable hover</guilabel></term>
+<listitem>
+<para>
+When this option is enabled, a shaded window will un-shade automatically
+when the mouse pointer has been over the titlebar for the configured delay.
+Use the slider widget to configure the delay.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
 <sect3>
 <title>Other</title>
 
-- 
cgit v1.2.1