aboutsummaryrefslogtreecommitdiff
path: root/sway/sway-input.5.scd
diff options
context:
space:
mode:
authorBrian Ashworth <bosrsf04@gmail.com>2019-11-03 14:20:05 -0500
committerDrew DeVault <sir@cmpwn.com>2019-11-21 10:42:10 -0500
commit5d882cb5fc2d9d9fd68439021e48a90aa2e50e79 (patch)
treec519449aebb2fa15406407eee5af3cd4164e1b62 /sway/sway-input.5.scd
parent2f858a1adaef17241ca6fda973f2b867b25e1971 (diff)
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.
Diffstat (limited to 'sway/sway-input.5.scd')
-rw-r--r--sway/sway-input.5.scd10
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