diff options
Diffstat (limited to 'sway/sway.5.txt')
-rw-r--r-- | sway/sway.5.txt | 26 |
1 files changed, 19 insertions, 7 deletions
diff --git a/sway/sway.5.txt b/sway/sway.5.txt index d626df48..1bb5cd3b 100644 --- a/sway/sway.5.txt +++ b/sway/sway.5.txt | |||
@@ -16,7 +16,8 @@ on startup. These commands usually consist of setting your preferences and | |||
16 | setting key bindings. An example config is likely present in /etc/sway/config | 16 | setting key bindings. An example config is likely present in /etc/sway/config |
17 | for you to check out. | 17 | for you to check out. |
18 | 18 | ||
19 | Some of the commands can also or only be sent at runtime with **sway-msg**(1). | 19 | These commands can be executed in your config file, via **sway-msg**(1), or via |
20 | the bindsym command. | ||
20 | 21 | ||
21 | Commands | 22 | Commands |
22 | -------- | 23 | -------- |
@@ -26,13 +27,14 @@ The following commands may only be used in the configuration file. | |||
26 | **bar** <block of commands>:: | 27 | **bar** <block of commands>:: |
27 | Append _{_ to this command, the following lines will be commands that | 28 | Append _{_ to this command, the following lines will be commands that |
28 | configure **swaybar**, and _}_ on its own line to close the block. | 29 | configure **swaybar**, and _}_ on its own line to close the block. |
30 | + | ||
31 | See **sway-bar**(5) for details. | ||
29 | 32 | ||
30 | **bindsym** <key combo> <command>:: | 33 | **input** <input device> <block of commands>:: |
31 | Binds _key combo_ to execute _command_ when pressed. You may use XKB key | 34 | Append _{_ to this command, the following lines will be commands to configure |
32 | names here (**xev**(1) is a good tool for discovering them). An example | 35 | the named input device, and _}_ on its own line will close the block. |
33 | bindsym command would be _bindsym Mod1+Shift+f exec firefox_, which would | 36 | + |
34 | execute Firefox if the alt, shift, and F keys are pressed together. Any | 37 | See **sway-input**(5) for details. |
35 | valid sway command is eligible to be bound to a key combo. | ||
36 | 38 | ||
37 | **set** <name> <value>:: | 39 | **set** <name> <value>:: |
38 | Creates a substitution for _value_ that can be used with $_name_ in other | 40 | Creates a substitution for _value_ that can be used with $_name_ in other |
@@ -107,6 +109,16 @@ They are expected to be used with **bindsym** or at runtime through **swaymsg**( | |||
107 | The following commands may be used either in the configuration file | 109 | The following commands may be used either in the configuration file |
108 | or triggered at runtime. | 110 | or triggered at runtime. |
109 | 111 | ||
112 | **bindsym** <key combo> <command>:: | ||
113 | Binds _key combo_ to execute _command_ when pressed. You may use XKB key | ||
114 | names here (**xev**(1) is a good tool for discovering them). An example | ||
115 | bindsym command would be _bindsym Mod1+Shift+f exec firefox_, which would | ||
116 | execute Firefox if the alt, shift, and F keys are pressed together. Any | ||
117 | valid sway command is eligible to be bound to a key combo. | ||
118 | + | ||
119 | **bindcode** <code> <command> is also available for binding with key codes | ||
120 | instead of key names. | ||
121 | |||
110 | **debuglog** <on|off|toggle>:: | 122 | **debuglog** <on|off|toggle>:: |
111 | Enables, disables or toggles logging for debug. The toggle argument cannot | 123 | Enables, disables or toggles logging for debug. The toggle argument cannot |
112 | be used in the configuration file. | 124 | be used in the configuration file. |