From e26ec472b22b26afc2c1ec563208592c58fa8449 Mon Sep 17 00:00:00 2001
From: Jens Peters <jp7677@gmail.com>
Date: Mon, 8 Jul 2024 20:21:49 +0200
Subject: [PATCH] docs: add tablet tool section

---
 docs/labwc-config.5.scd | 18 ++++++++++++++++++
 docs/rc.xml.all         | 10 ++++++++++
 2 files changed, 28 insertions(+)

diff --git a/docs/labwc-config.5.scd b/docs/labwc-config.5.scd
index 1a5e3742..70f705c6 100644
--- a/docs/labwc-config.5.scd
+++ b/docs/labwc-config.5.scd
@@ -730,6 +730,24 @@ extending outward from the snapped edge.
 
 	See mouse section above for all supported mouse buttons.
 
+## TABLET TOOL
+
+```
+<tabletTool motion="absolute" relativeMotionSensitivity="1" />
+```
+
+*<tabletTool motion="">* [absolute|relative]
+	All tablet tools, except of type mouse and lens, use "absolute"
+	positioning by default. The *motion* attribute allows to set tools
+	to relative motion instead. Positioning for a tablet mouse or
+	tablet lens cannot be changed, those tools always use relative mode.
+
+*<tabletTool relativeMotionSensitivity="">*
+	When using relative motion, *relativeMotionSensitivity* controls
+	the speed of the cursor. Using a value lower than 1.0 decreases the
+	speed, using a value greater than 1.0 increases the speed of the
+	cursor. The default is "1.0".
+
 ## LIBINPUT
 
 ```
diff --git a/docs/rc.xml.all b/docs/rc.xml.all
index 1f4a0f69..f481c091 100644
--- a/docs/rc.xml.all
+++ b/docs/rc.xml.all
@@ -521,6 +521,16 @@
     <map button="Stylus2" to="Middle" />
   </tablet>
 
+  <!--
+    All tablet tools, except of type mouse and lens, use absolute
+    positioning by default. The *motion* attribute allows to set tools
+    to relative motion instead. When using relative motion,
+    *relativeMotionSensitivity* controls the speed of the cursor. Using
+    a value lower than 1.0 decreases the speed, using a value greater than
+    1.0 increases the speed of the cursor.
+  -->
+  <tabletTool motion="absolute" relativeMotionSensitivity="1.0" />
+
   <!--
     The *category* attribute is optional and can be set to touch, touchpad,
     non-touch, default or the name of a device. You can obtain device names by
-- 
2.52.0