From 920e94626382b9e4eedf0d6dcf15cff3dc87742a Mon Sep 17 00:00:00 2001
From: Jens Peters <jp7677@gmail.com>
Date: Tue, 9 Jan 2024 06:58:42 +0100
Subject: [PATCH] docs: extend tablet section

Also change order to be in line with the xml elements.
---
 docs/labwc-config.5.scd | 17 +++++++++++------
 docs/rc.xml.all         | 14 +++++++++-----
 2 files changed, 20 insertions(+), 11 deletions(-)

diff --git a/docs/labwc-config.5.scd b/docs/labwc-config.5.scd
index fcf028fe..82296458 100644
--- a/docs/labwc-config.5.scd
+++ b/docs/labwc-config.5.scd
@@ -441,7 +441,7 @@ windows using the mouse.
 ## TABLET
 
 ```
-<tablet rotate="0">
+<tablet mapToOutput="" 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" />
@@ -449,6 +449,16 @@ windows using the mouse.
 </tablet>
 ```
 
+*<tablet mapToOutput="" />*
+	The tablet cursor movement can be restricted to a single output.
+	If the output name is left empty or the output does not exists, the
+	tablet will span all outputs.
+
+*<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><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
@@ -468,11 +478,6 @@ windows using the mouse.
 	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)
diff --git a/docs/rc.xml.all b/docs/rc.xml.all
index 42429990..988cdba6 100644
--- a/docs/rc.xml.all
+++ b/docs/rc.xml.all
@@ -394,20 +394,24 @@
   </mouse>
 
   <!--
-    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.
+    The tablet cursor movement can be restricted to a single output.
+    If output is left empty or the output does not exists, the tablet
+    will span all outputs.
 
     The tablet orientation can be changed in 90 degree steps, thus
     *rotate* can be set to [0|90|180|270]. Rotation will be applied
     after applying tablet area transformation.
 
+    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.
+
     Tablet buttons emulate regular mouse buttons. The tablet *button* can
     be set to any of [Tip|Stylus|Stylus2|Stylus3|Pad|Pad2|Pad3|..|Pad9].
     Valid *to* mouse buttons are [Left|Right|Middle].
   -->
-  <tablet rotate="0">
+  <tablet mapToOutput="" rotate="0">
     <!-- Active area dimensions are in mm -->
     <area top="0.0" left="0.0" width="0.0" height="0.0">
     <map button="Tip" to="Left" />