docs: extend tablet section

Also change order to be in line with the xml elements.

diff --git a/docs/labwc-config.5.scd b/docs/labwc-config.5.scd
index 592958abd0428662e6056cdcbc217e637b9de40c..0d7827d542605076934cc1c4aac13fe0cd2bcffa 100644 (file)
--- a/docs/labwc-config.5.scd
+++ b/docs/labwc-config.5.scd
@@ -448,7 +448,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" />
@@ -456,6 +456,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
@@ -475,11 +485,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 a8937adbae86d42f3dbea4d7771d6ce91ed8a050..b498b953506d63b5586fafa91f02c5f1958e8346 100644 (file)
--- a/docs/rc.xml.all
+++ b/docs/rc.xml.all
@@ -395,20 +395,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" />