From c4d6695bf1c45151fd78b4d8572aa06616e69a00 Mon Sep 17 00:00:00 2001
From: Jens Peters <jp7677@gmail.com>
Date: Sat, 6 Jan 2024 10:58:57 +0100
Subject: [PATCH] docs: add tablet section

---
 docs/labwc-config.5.scd | 51 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/docs/labwc-config.5.scd b/docs/labwc-config.5.scd
index 94b13239..1e2c018a 100644
--- a/docs/labwc-config.5.scd
+++ b/docs/labwc-config.5.scd
@@ -433,6 +433,57 @@ windows using the mouse.
 	<mouse><mousebind> entries exist, the same default mousebinds will be
 	loaded even if the <default /> element is not provided.
 
+## TABLET
+
+```
+<tablet rotate="0">
+  <area top="0.0" left="0.0" width="0.0" height="0.0">
+  <map button="Tip" to="Left" />
+  <map button="Stylus" to="Right" />
+  <map button="Stylus2" to="Middle" />
+</tablet>
+```
+
+*<tablet><area top="mm" left="mm" width="mm" height="mm" />*
+	By default the complete tablet area is mapped to the full output.
+	The *area* element can be used to truncate the active area of the
+	tablet surface. By truncating the active area, it is e.g. possible
+	to maintain the same aspect ratio between output and tablet.
+
+	The active tablet area can be specified by setting the *top*/*left*
+	coordinate (in mm) and/or *width*/*height* (in mm). If width or
+	height are omitted or default (0.0), width/height will be set to
+	the remaining width/height seen from top/left.
+
+	Aspect ratio example:
+	The dimensions of the tablet are 215mm x 115mm and the output has
+	a resolution of 3440x1440. When setting height to "90", because 
+	215 x 1440 / 3440 = 90, the responsive tablet area height will be
+	truncated to match the 21:9 aspect ratio of the output. By
+	additionally setting top to "12.5", the active area is centered
+	vertically on the tablet surface.
+
+*<tablet rotate="" />* [0|90|180|270]
+	The tablet orientation can be changed in 90 degree steps. Default is
+	no rotation (0). Rotation will be applied after applying tablet area
+	transformation.
+
+*<tablet><map button="" to="" />*
+	Tablet buttons emulate regular mouse buttons. If not specified otherwise,
+	the tip (Tip) is mapped to left mouse click, the first pen button (Stylus)
+	is mapped to right mouse button click and the second pen button (Stylus2)
+	emulates a middle mouse button click.
+
+	Supported map *buttons* are:
+	- Tip
+	- Stylus
+	- Stylus2
+	- Stylus3
+	- Pad
+	- Pad2..Pad9
+
+	See mouse section above for all supported *to* mouse buttons.
+
 ## LIBINPUT
 
 ```
-- 
2.52.0