seat_cmd_cursor: utilize mouse button helpers

This modifies `seat_cmd_cursor` to utilize `get_mouse_button` when
parsing mouse buttons for the `press` and `release` operations. All x11
buttons, button event names, and button event codes are supported.
For x11 axis buttons, `dispatch_cursor_axis` is used instead of
`dispatch_cursor_button`. However the `press`/`release` state is ignored
and the either axis event is processed. This also removes support for
`left` and `right` in favor of `BTN_LEFT` and `BTN_RIGHT`.

1 files changed, 13 insertions, 0 deletions

diff --git a/sway/sway-input.5.scd b/sway/sway-input.5.scd
index 820194a9..044057f2 100644
--- a/sway/sway-input.5.scd
+++ b/sway/sway-input.5.scd
@@ -141,6 +141,19 @@ in their own "seat").
         Attach an input device to this seat by its input identifier. A special
         value of "\*" will attach all devices to the seat.
 
+*seat* <seat> cursor move|set <x> <y>
+        Move specified seat's cursor relative to current position or wrap to
+        absolute coordinates (with respect to the global coordinate space).
+        Specifying either value as 0 will not update that coordinate.
+
+*seat* <seat> cursor press|release button[1-9]|<event-name-or-code>
+        Simulate pressing (or releasing) the specified mouse button on the
+        specified seat. The button can either be provided as a button event name or
+        event code, which can be obtained from `libinput debug-events`, or as an x11
+        mouse button (button[1-9]). If using button[4-7], which map to axes, an axis
+        event will be simulated, however _press_ and _release_ will be ignored and
+        both will occur.
+
 *seat* <name> fallback true|false
         Set this seat as the fallback seat. A fallback seat will attach any device
         not explicitly attached to another seat (similar to a "default" seat).