diff --git a/stable/tablet/tablet-v2.xml b/stable/tablet/tablet-v2.xml
index 0dbbde1..e255043 100644
--- a/stable/tablet/tablet-v2.xml
+++ b/stable/tablet/tablet-v2.xml
@@ -1016,7 +1016,7 @@
Notification that the mode was switched.
- A mode applies to all buttons, rings and strips in a group
+ A mode applies to all buttons, rings, strips and dials in a group
simultaneously, but a client is not required to assign different actions
for each mode. For example, a client may have mode-specific button
mappings but map the ring to vertical scrolling in all modes. Mode
@@ -1037,20 +1037,33 @@
previous mode, the client should immediately issue a
wp_tablet_pad.set_feedback request for each changed button.
- If a ring or strip action in the new mode differs from the action
+ If a ring, strip or dial action in the new mode differs from the action
in the previous mode, the client should immediately issue a
- wp_tablet_ring.set_feedback or wp_tablet_strip.set_feedback request
- for each changed ring or strip.
+ wp_tablet_ring.set_feedback, wp_tablet_strip.set_feedback or
+ wp_tablet_dial.set_feedback request for each changed ring, strip or dial.
+
+
+
+
+
+ Sent on wp_tablet_pad initialization to announce available dials.
+ One event is sent for each dial available on this pad group.
+
+ This event is sent in the initial burst of events before the
+ wp_tablet_pad_group.done event.
+
+
+
-
- A pad device is a set of buttons, rings and strips
+
+ A pad device is a set of buttons, rings, strips and dials
usually physically present on the tablet device itself. Some
exceptions exist where the pad device is physically detached, e.g. the
Wacom ExpressKey Remote.
@@ -1064,7 +1077,7 @@
This initial event sequence is terminated by a wp_tablet_pad.done
event.
- All pad features (buttons, rings and strips) are logically divided into
+ All pad features (buttons, rings, strips and dials) are logically divided into
groups and all pads have at least one group. The available groups are
notified through the wp_tablet_pad.group event; the compositor will
emit one event per group before emitting wp_tablet_pad.done.
@@ -1207,4 +1220,78 @@
+
+
+
+ A rotary control, e.g. a dial or a wheel.
+
+ Events on a dial are logically grouped by the wl_tablet_pad_dial.frame
+ event.
+
+
+
+
+ Requests the compositor to use the provided feedback string
+ associated with this dial. This request should be issued immediately
+ after a wp_tablet_pad_group.mode_switch event from the corresponding
+ group is received, or whenever the dial is mapped to a different
+ action. See wp_tablet_pad_group.mode_switch for more details.
+
+ Clients are encouraged to provide context-aware descriptions for
+ the actions associated with the dial, and compositors may use this
+ information to offer visual feedback about the button layout
+ (eg. on-screen displays).
+
+ The provided string 'description' is a UTF-8 encoded string to be
+ associated with this ring, and is considered user-visible; general
+ internationalization rules apply.
+
+ The serial argument will be that of the last
+ wp_tablet_pad_group.mode_switch event received for the group of this
+ dial. Requests providing other serials than the most recent one will be
+ ignored.
+
+
+
+
+
+
+
+ This destroys the client's resource for this dial object.
+
+
+
+
+
+ Sent whenever the position on a dial changes.
+
+ This event carries the wheel delta as multiples or fractions
+ of 120 with each multiple of 120 representing one logical wheel detent.
+ For example, an axis_value120 of 30 is one quarter of
+ a logical wheel step in the positive direction, a value120 of
+ -240 are two logical wheel steps in the negative direction within the
+ same hardware event. See the wl_pointer.axis_value120 for more details.
+
+ The value120 must not be zero.
+
+
+
+
+
+
+ Indicates the end of a set of events that represent one logical
+ hardware dial event. A client is expected to accumulate the data
+ in all events within the frame before proceeding.
+
+ All wp_tablet_pad_dial events before a wp_tablet_pad_dial.frame event belong
+ logically together.
+
+ A wp_tablet_pad_dial.frame event is sent for every logical event
+ group, even if the group only contains a single wp_tablet_pad_dial
+ event. Specifically, a client may get a sequence: delta, frame,
+ delta, frame, etc.
+
+
+
+