From d9a08b7a9df64ba434252d6adfa08aabb4c5c31e Mon Sep 17 00:00:00 2001 From: Drew DeVault <sir@cmpwn.com> Date: Fri, 11 May 2018 21:25:05 -0400 Subject: Add sway-input(5) --- sway/sway-input.5.scd | 120 +++++++++++++++++++++++++++++++++++++++++++++ sway/sway-input.5.txt | 131 -------------------------------------------------- 2 files changed, 120 insertions(+), 131 deletions(-) create mode 100644 sway/sway-input.5.scd delete mode 100644 sway/sway-input.5.txt (limited to 'sway') diff --git a/sway/sway-input.5.scd b/sway/sway-input.5.scd new file mode 100644 index 00000000..c07460b1 --- /dev/null +++ b/sway/sway-input.5.scd @@ -0,0 +1,120 @@ +sway-input(5) + +# NAME + +sway-input - input configuration file and commands + +# DESCRIPTION + +Sway allows for configuration of devices within the sway configuration file. +sway-input commands must be used inside an _input { }_ block in the config. +To obtain a list of available device identifiers, run *swaymsg -t get\_inputs*. + +# INPUT COMMANDS + +## KEYBOARD CONFIGURATION + +For more information on these xkb configuration options, see +*xkeyboard-config*(7). + +*input* <identifier> xkb\_layout <layout\_name> + Sets the layout of the keyboard like _us_ or _de_. + +*input* <identifier> xkb\_model <model\_name> + Sets the model of the keyboard. This has an influence for some extra keys + your keyboard might have. + +*input* <identifier> xkb\_options <options> + Sets extra xkb configuration options for the keyboard. + +*input* <identifier> xkb\_rules <rules> + Sets files of rules to be used for keyboard mapping composition. + +*input* <identifier> xkb\_variant <variant> + Sets the variant of the keyboard like _dvorak_ or _colemak_. + +## MAPPING CONFIGURATION + +*input* <identifier> map\_to\_output <identifier> + Maps inputs from this device to the specified output. Only meaningful if the + device is a pointer, touch, or drawing tablet device. + +*input* <identifier> map\_to\_region <WxH@X,Y> + Maps inputs from this device to the specified region of the global output + layout. Only meaningful if the device is a pointer, touch, or drawing tablet + device. + +*input* <identifier> map\_from\_region <X1xY1> <X2xY2> + Ignores inputs from this device that do not occur within the specified + region. Can be in millimeters (e.g. 10x20mm 20x40mm) or in terms of 0..1 + (e.g. 0.5x0.5 0.7x0.7). Not all devices support millimeters. Only meaningful + if the device is not a keyboard an provides events in absolute terms (such + as a drawing tablet or touch screen - most pointers provide events relative + to the previous frame). + +## LIBINPUT CONFIGURATION + +*input* <identifier> accel\_profile adaptive|flat + Sets the pointer acceleration profile for the specified input device. + +*input* <identifier> click\_method none|button\_areas|clickfinger + Changes the click method for the specified device. + +*input* <identifier> drag\_lock enabled|disabled + Enables or disables drag lock for specified input device. + +*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> left\_handed enabled|disabled + Enables or disables left handed mode for specified input device. + +*input* <identifier> middle\_emulation enabled|disabled + Enables or disables middle click emulation. + +*input* <identifier> natural\_scroll enabled|disabled + Enables or disables natural (inverted) scrolling for the specified input + device. + +*input* <identifier> pointer\_accel [<-1|1>] + Changes the pointer acceleration for the specified input device. + +*input* <identifier> repeat\_delay <milliseconds> + Sets the amount of time a key must be held before it starts repeating. + +*input* <identifier> repeat\_rate <characters per second> + Sets the frequency of key repeats once the repeat\_delay has passed. + +*input* <identifier> scroll\_method none|two\_finger|edge|on\_button\_down + Changes the scroll method for the specified input device. + +*input* <identifier> tap enabled|disabled + Enables or disables tap for specified input device. + +## SEAT CONFIGURATION + +Configure options for multiseat mode. sway-seat commands must be used inside a +_seat { }_ block in the config. + +A *seat* is a collection of input devices that act independently of each other. +Seats are identified by name and the default seat is _seat0_ if no seats are +configured. Each seat has an independent keyboard focus and a separate cursor that +is controlled by the pointer devices of the seat. This is useful for multiple +people using the desktop at the same time with their own devices (each sitting +in their own "seat"). + +*seat* <name> attach <input\_identifier> + Attach an input device to this seat by its input identifier. A special + value of "\*" will attach all devices to the seat. + +*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). + +# SEE ALSO + +*sway*(5) diff --git a/sway/sway-input.5.txt b/sway/sway-input.5.txt deleted file mode 100644 index c7305503..00000000 --- a/sway/sway-input.5.txt +++ /dev/null @@ -1,131 +0,0 @@ -///// -vim:set ft=asciidoc ts=4 sw=4 tw=82 noet: -///// -sway-input (5) -============== - -Name ----- -sway-input - input configuration file and commands - -Description ------------ - -Sway allows for configuration of devices within the sway configuration file. -sway-input commands must be used inside an _input { }_ block in the config. -To obtain a list of available device identifiers, run **swaymsg -t get_inputs**. - -Input Commands --------------- - -Keyboard Configuration -~~~~~~~~~~~~~~~~~~~~~~ - -For more information on these xkb configuration options, see -**xkeyboard-config**(7). - -**input** <identifier> xkb_layout <layout_name>:: - Sets the layout of the keyboard like _us_ or _de_. - -**input** <identifier> xkb_model <model_name>:: - Sets the model of the keyboard. This has an influence for some extra keys your - keyboard might have. - -**input** <identifier> xkb_options <options>:: - Sets extra xkb configuration options for the keyboard. - -**input** <identifier> xkb_rules <rules>:: - Sets files of rules to be used for keyboard mapping composition. - -**input** <identifier> xkb_variant <variant>:: - Sets the variant of the keyboard like _dvorak_ or _colemak_. - -Mapping Configuration ---------------------- - -**input** <identifier> map_to_output <identifier>:: - Maps inputs from this device to the specified output. Only meaningful if the - device is a pointer, touch, or drawing tablet device. - -**input** <identifier> map_to_region <WxH\@X,Y>:: - Maps inputs from this device to the specified region of the global output - layout. Only meaningful if the device is a pointer, touch, or drawing tablet - device. - -**input** <identifier> map_from_region <X1xY1> <X2xY2>:: - Ignores inputs from this device that do not occur within the specified - region. Can be in millimeters (e.g. 10x20mm 20x40mm) or in terms of 0..1 - (e.g. 0.5x0.5 0.7x0.7). Not all devices support millimeters. Only meaningful - if the device is not a keyboard an provides events in absolute terms (such - as a drawing tablet or touch screen - most pointers provide events relative - to the previous frame). - -Libinput Configuration -~~~~~~~~~~~~~~~~~~~~~~ - -**input** <identifier> accel_profile <adaptive|flat>:: - Sets the pointer acceleration profile for the specified input device. - -**input** <identifier> click_method <none|button_areas|clickfinger>:: - Changes the click method for the specified device. - -**input** <identifier> drag_lock <enabled|disabled>:: - Enables or disables drag lock for specified input device. - -**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> left_handed <enabled|disabled>:: - Enables or disables left handed mode for specified input device. - -**input** <identifier> middle_emulation <enabled|disabled>:: - Enables or disables middle click emulation. - -**input** <identifier> natural_scroll <enabled|disabled>:: - Enables or disables natural (inverted) scrolling for the specified input - device. - -**input** <identifier> pointer_accel <[-1,1]>:: - Changes the pointer acceleration for the specified input device. - -**input** <identifier> repeat_delay <milliseconds>:: - Sets the amount of time a key must be held before it starts repeating. - -**input** <identifier> repeat_rate <characters per second>:: - Sets the frequency of key repeats once the repeat_delay has passed. - -**input** <identifier> scroll_method <none|two_finger|edge|on_button_down>:: - Changes the scroll method for the specified input device. - -**input** <identifier> tap <enabled|disabled>:: - Enables or disables tap for specified input device. - -Seat Configuration ------------------- - -Configure options for multiseat mode. sway-seat commands must be used inside a -_seat { }_ block in the config. - -A _seat_ is a collection of input devices that act independently of each other. -Seats are identified by name and the default seat is _seat0_ if no seats are -configured. Each seat has an independent keyboard focus and a separate cursor that -is controlled by the pointer devices of the seat. This is useful for multiple -people using the desktop at the same time with their own devices (each sitting in -their own "seat"). - -**seat** <name> attach <input_identifier>:: - Attach an input device to this seat by its input identifier. A special value - of _*_ will attach all devices to the seat. - -**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). - -See Also --------- - -**sway**(5) -- cgit v1.2.3