mirror of
https://github.com/NickHu/sway
synced 2024-12-27 21:58:11 +01:00
Add sway-input(5)
This commit is contained in:
parent
1813482266
commit
d9a08b7a9d
2 changed files with 49 additions and 59 deletions
|
@ -56,6 +56,7 @@ if scdoc.found()
|
||||||
'sway/sway.1.scd',
|
'sway/sway.1.scd',
|
||||||
'sway/sway.5.scd',
|
'sway/sway.5.scd',
|
||||||
'sway/sway-bar.5.scd',
|
'sway/sway-bar.5.scd',
|
||||||
|
'sway/sway-input.5.scd',
|
||||||
]
|
]
|
||||||
foreach filename : man_files
|
foreach filename : man_files
|
||||||
topic = filename.split('.')[-3].split('/')[-1]
|
topic = filename.split('.')[-3].split('/')[-1]
|
||||||
|
|
|
@ -1,58 +1,50 @@
|
||||||
/////
|
sway-input(5)
|
||||||
vim:set ft=asciidoc ts=4 sw=4 tw=82 noet:
|
|
||||||
/////
|
# NAME
|
||||||
sway-input (5)
|
|
||||||
==============
|
|
||||||
|
|
||||||
Name
|
|
||||||
----
|
|
||||||
sway-input - input configuration file and commands
|
sway-input - input configuration file and commands
|
||||||
|
|
||||||
Description
|
# DESCRIPTION
|
||||||
-----------
|
|
||||||
|
|
||||||
Sway allows for configuration of devices within the sway configuration file.
|
Sway allows for configuration of devices within the sway configuration file.
|
||||||
sway-input commands must be used inside an _input { }_ block in the config.
|
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**.
|
To obtain a list of available device identifiers, run *swaymsg -t get\_inputs*.
|
||||||
|
|
||||||
Input Commands
|
# INPUT COMMANDS
|
||||||
--------------
|
|
||||||
|
|
||||||
Keyboard Configuration
|
## KEYBOARD CONFIGURATION
|
||||||
~~~~~~~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
For more information on these xkb configuration options, see
|
For more information on these xkb configuration options, see
|
||||||
**xkeyboard-config**(7).
|
*xkeyboard-config*(7).
|
||||||
|
|
||||||
**input** <identifier> xkb_layout <layout_name>::
|
*input* <identifier> xkb\_layout <layout\_name>
|
||||||
Sets the layout of the keyboard like _us_ or _de_.
|
Sets the layout of the keyboard like _us_ or _de_.
|
||||||
|
|
||||||
**input** <identifier> xkb_model <model_name>::
|
*input* <identifier> xkb\_model <model\_name>
|
||||||
Sets the model of the keyboard. This has an influence for some extra keys your
|
Sets the model of the keyboard. This has an influence for some extra keys
|
||||||
keyboard might have.
|
your keyboard might have.
|
||||||
|
|
||||||
**input** <identifier> xkb_options <options>::
|
*input* <identifier> xkb\_options <options>
|
||||||
Sets extra xkb configuration options for the keyboard.
|
Sets extra xkb configuration options for the keyboard.
|
||||||
|
|
||||||
**input** <identifier> xkb_rules <rules>::
|
*input* <identifier> xkb\_rules <rules>
|
||||||
Sets files of rules to be used for keyboard mapping composition.
|
Sets files of rules to be used for keyboard mapping composition.
|
||||||
|
|
||||||
**input** <identifier> xkb_variant <variant>::
|
*input* <identifier> xkb\_variant <variant>
|
||||||
Sets the variant of the keyboard like _dvorak_ or _colemak_.
|
Sets the variant of the keyboard like _dvorak_ or _colemak_.
|
||||||
|
|
||||||
Mapping Configuration
|
## MAPPING CONFIGURATION
|
||||||
---------------------
|
|
||||||
|
|
||||||
**input** <identifier> map_to_output <identifier>::
|
*input* <identifier> map\_to\_output <identifier>
|
||||||
Maps inputs from this device to the specified output. Only meaningful if the
|
Maps inputs from this device to the specified output. Only meaningful if the
|
||||||
device is a pointer, touch, or drawing tablet device.
|
device is a pointer, touch, or drawing tablet device.
|
||||||
|
|
||||||
**input** <identifier> map_to_region <WxH\@X,Y>::
|
*input* <identifier> map\_to\_region <WxH@X,Y>
|
||||||
Maps inputs from this device to the specified region of the global output
|
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
|
layout. Only meaningful if the device is a pointer, touch, or drawing tablet
|
||||||
device.
|
device.
|
||||||
|
|
||||||
**input** <identifier> map_from_region <X1xY1> <X2xY2>::
|
*input* <identifier> map\_from\_region <X1xY1> <X2xY2>
|
||||||
Ignores inputs from this device that do not occur within the specified
|
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
|
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
|
(e.g. 0.5x0.5 0.7x0.7). Not all devices support millimeters. Only meaningful
|
||||||
|
@ -60,72 +52,69 @@ Mapping Configuration
|
||||||
as a drawing tablet or touch screen - most pointers provide events relative
|
as a drawing tablet or touch screen - most pointers provide events relative
|
||||||
to the previous frame).
|
to the previous frame).
|
||||||
|
|
||||||
Libinput Configuration
|
## LIBINPUT CONFIGURATION
|
||||||
~~~~~~~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
**input** <identifier> accel_profile <adaptive|flat>::
|
*input* <identifier> accel\_profile adaptive|flat
|
||||||
Sets the pointer acceleration profile for the specified input device.
|
Sets the pointer acceleration profile for the specified input device.
|
||||||
|
|
||||||
**input** <identifier> click_method <none|button_areas|clickfinger>::
|
*input* <identifier> click\_method none|button\_areas|clickfinger
|
||||||
Changes the click method for the specified device.
|
Changes the click method for the specified device.
|
||||||
|
|
||||||
**input** <identifier> drag_lock <enabled|disabled>::
|
*input* <identifier> drag\_lock enabled|disabled
|
||||||
Enables or disables drag lock for specified input device.
|
Enables or disables drag lock for specified input device.
|
||||||
|
|
||||||
**input** <identifier> dwt <enabled|disabled>::
|
*input* <identifier> dwt enabled|disabled
|
||||||
Enables or disables disable-while-typing for the specified input device.
|
Enables or disables disable-while-typing for the specified input device.
|
||||||
|
|
||||||
**input** <identifier> events <enabled|disabled|disabled_on_external_mouse>::
|
*input* <identifier> events enabled|disabled|disabled\_on\_external\_mouse
|
||||||
Enables or disables send_events for specified input device.
|
Enables or disables send_events for specified input device. (Disabling
|
||||||
(Disabling send_events disables the input device)
|
send_events disables the input device)
|
||||||
|
|
||||||
**input** <identifier> left_handed <enabled|disabled>::
|
*input* <identifier> left\_handed enabled|disabled
|
||||||
Enables or disables left handed mode for specified input device.
|
Enables or disables left handed mode for specified input device.
|
||||||
|
|
||||||
**input** <identifier> middle_emulation <enabled|disabled>::
|
*input* <identifier> middle\_emulation enabled|disabled
|
||||||
Enables or disables middle click emulation.
|
Enables or disables middle click emulation.
|
||||||
|
|
||||||
**input** <identifier> natural_scroll <enabled|disabled>::
|
*input* <identifier> natural\_scroll enabled|disabled
|
||||||
Enables or disables natural (inverted) scrolling for the specified input
|
Enables or disables natural (inverted) scrolling for the specified input
|
||||||
device.
|
device.
|
||||||
|
|
||||||
**input** <identifier> pointer_accel <[-1,1]>::
|
*input* <identifier> pointer\_accel [<-1|1>]
|
||||||
Changes the pointer acceleration for the specified input device.
|
Changes the pointer acceleration for the specified input device.
|
||||||
|
|
||||||
**input** <identifier> repeat_delay <milliseconds>::
|
*input* <identifier> repeat\_delay <milliseconds>
|
||||||
Sets the amount of time a key must be held before it starts repeating.
|
Sets the amount of time a key must be held before it starts repeating.
|
||||||
|
|
||||||
**input** <identifier> repeat_rate <characters per second>::
|
*input* <identifier> repeat\_rate <characters per second>
|
||||||
Sets the frequency of key repeats once the repeat_delay has passed.
|
Sets the frequency of key repeats once the repeat\_delay has passed.
|
||||||
|
|
||||||
**input** <identifier> scroll_method <none|two_finger|edge|on_button_down>::
|
*input* <identifier> scroll\_method none|two\_finger|edge|on\_button\_down
|
||||||
Changes the scroll method for the specified input device.
|
Changes the scroll method for the specified input device.
|
||||||
|
|
||||||
**input** <identifier> tap <enabled|disabled>::
|
*input* <identifier> tap enabled|disabled
|
||||||
Enables or disables tap for specified input device.
|
Enables or disables tap for specified input device.
|
||||||
|
|
||||||
Seat Configuration
|
## SEAT CONFIGURATION
|
||||||
------------------
|
|
||||||
|
|
||||||
Configure options for multiseat mode. sway-seat commands must be used inside a
|
Configure options for multiseat mode. sway-seat commands must be used inside a
|
||||||
_seat { }_ block in the config.
|
_seat { }_ block in the config.
|
||||||
|
|
||||||
A _seat_ is a collection of input devices that act independently of each other.
|
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
|
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
|
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
|
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
|
people using the desktop at the same time with their own devices (each sitting
|
||||||
their own "seat").
|
in their own "seat").
|
||||||
|
|
||||||
**seat** <name> attach <input_identifier>::
|
*seat* <name> attach <input\_identifier>
|
||||||
Attach an input device to this seat by its input identifier. A special value
|
Attach an input device to this seat by its input identifier. A special
|
||||||
of _*_ will attach all devices to the seat.
|
value of "\*" will attach all devices to the seat.
|
||||||
|
|
||||||
**seat** <name> fallback <true|false>::
|
*seat* <name> fallback true|false
|
||||||
Set this seat as the fallback seat. A fallback seat will attach any device not
|
Set this seat as the fallback seat. A fallback seat will attach any device
|
||||||
explicitly attached to another seat (similar to a "default" seat).
|
not explicitly attached to another seat (similar to a "default" seat).
|
||||||
|
|
||||||
See Also
|
# SEE ALSO
|
||||||
--------
|
|
||||||
|
|
||||||
**sway**(5)
|
*sway*(5)
|
Loading…
Reference in a new issue