docs: add tablet section

diff --git a/docs/labwc-config.5.scd b/docs/labwc-config.5.scd
index 94b13239289b65d66c2ad2bdc8fc0600310a3f3f..1e2c018a10184f543b644231b728e490935f269b 100644 (file)
--- 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
 
 ```