input_cmd_events: implement toggle

Implements toggling input events during runtime. This will not attempt
to toggle to a mode that is not supported by the device.

When toggling the wildcard input, the device specific input configs are
altered. Each device will cycle one supported mode.

1 files changed, 6 insertions, 3 deletions

diff --git a/sway/sway-input.5.scd b/sway/sway-input.5.scd
index 820194a9..c54babaa 100644
--- a/sway/sway-input.5.scd
+++ b/sway/sway-input.5.scd
@@ -82,9 +82,12 @@ The following commands may only be used in the configuration file.
 *input* <identifier> dwt enabled|disabled
         Enables or disables disable-while-typing for the specified input device.
 
-*input* <identifier> events enabled|disabled|disabled\_on\_external\_mouse
-        Enables or disables send\_events for specified input device. (Disabling
-        send\_events disables the input device)
+*input* <identifier> events enabled|disabled|disabled\_on\_external\_mouse|toggle
+        Enables or disables send\_events for specified input device. Disabling
+        send\_events disables the input device. The _toggle_ option cannot be used
+        in the config. The order is enabled, disabled\_on\_external\_mouse,
+        disabled, (loop back to enabled). Any mode which is not supported by the
+        device will be skipped during the toggle.
 
 *input* <identifier> left\_handed enabled|disabled
         Enables or disables left handed mode for specified input device.