Add support for wlr_keyboard_group

A wlr_keyboard_group allows for multiple keyboard devices to be
combined into one logical keyboard. This is useful for keyboards that
are split into multiple input devices despite appearing as one physical
keyboard in the user's mind.

This adds support for wlr_keyboard_groups to sway. There are two
keyboard groupings currently supported, which can be set on a per-seat
basis. The first keyboard grouping is none, which disables all grouping
and provides no functional change. The second is keymap, which groups
the keyboard devices in the seat by their keymap. With this grouping,
the effective layout and repeat info is also synced across keyboard
devices in the seat. Device specific bindings will still be executed as
normal, but everything else related to key and modifier events will be
handled by the keyboard group's keyboard.

1 files changed, 10 insertions, 0 deletions

diff --git a/sway/sway-input.5.scd b/sway/sway-input.5.scd
index d0bf648b..5631293c 100644
--- a/sway/sway-input.5.scd
+++ b/sway/sway-input.5.scd
@@ -218,6 +218,16 @@ correct seat.
         disables hiding the cursor. The minimal timeout is 100 and any value less
         than that (aside from 0), will be increased to 100.
 
+*seat* <name> keyboard_grouping none|keymap
+        Set how the keyboards in the seat are grouped together. Currently, there
+        are two options. _none_ will disable all keyboard grouping. This will make
+        it so each keyboard device has its own isolated state. _keymap_ will
+        group the keyboards in the seat by their keymap. This is useful for when
+        the keyboard appears as multiple separate input devices. In this mode,
+        the effective layout and repeat info are also synced between the keyboards
+        in the group. The default is _keymap_. To restore the behavior of older
+        versions of sway, use _none_.
+
 *seat* <name> pointer_constraint enable|disable|escape
         Enables or disables the ability for clients to capture the cursor (enabled
         by default) for the seat. This is primarily useful for video games. The