aboutsummaryrefslogtreecommitdiff
path: root/sway/sway.5.scd
diff options
context:
space:
mode:
Diffstat (limited to 'sway/sway.5.scd')
-rw-r--r--sway/sway.5.scd28
1 files changed, 18 insertions, 10 deletions
diff --git a/sway/sway.5.scd b/sway/sway.5.scd
index e04c5fbf..fd0a22dc 100644
--- a/sway/sway.5.scd
+++ b/sway/sway.5.scd
@@ -72,7 +72,7 @@ The following commands may only be used in the configuration file.
*sway-output*(5) for more information.
It can be disabled by setting the command to a single dash:
- _swaybg_command -_
+ _swaybg\_command -_
*swaynag_command* <command>
Executes custom command for _swaynag_. Default is _swaynag_. Additional
@@ -82,7 +82,7 @@ The following commands may only be used in the configuration file.
results.
It can be disabled by setting the command to a single dash:
- _swaynag_command -_
+ _swaynag\_command -_
*xwayland* enable|disable
Enables or disables Xwayland support, which allows X11 applications to be
@@ -282,7 +282,7 @@ runtime.
for_window <criteria> move container to output <output>
-*bindsym* [--release|--locked] [--input-device=<device>] [--no-warn] <key combo> <command>
+*bindsym* [--whole-window] [--border] [--exclude-titlebar] [--release] [--locked] [--input-device=<device>] [--no-warn] <key combo> <command>
Binds _key combo_ to execute the sway command _command_ when pressed. You
may use XKB key names here (*xev*(1) is a good tool for discovering these).
With the flag _--release_, the command is executed when the key combo is
@@ -294,11 +294,24 @@ runtime.
the _--no-warn_ flag.
Mouse buttons can either be specified in the form _button[1-9]_ or by using
- the name of the event code (ex _BTN_LEFT_ or _BTN_RIGHT_). For the former
+ the name of the event code (ex _BTN\_LEFT_ or _BTN\_RIGHT_). For the former
option, the buttons will be mapped to their values in X11 (1=left, 2=middle,
3=right, 4=scroll up, 5=scroll down, 6=scroll left, 7=scroll right, 8=back,
9=forward). For the latter option, you can find the event names using
_libinput debug-events_.
+
+ _--whole-window_, _--border_, and _--exclude-titlebar_ are mouse-only options
+ which affect the region in which the mouse bindings can be triggered. By
+ default, mouse bindings are only triggered when over the title bar. With the
+ _--border_ option, the border of the window will be included in this region.
+ With the _--whole-window_ option, the cursor can be anywhere over a window
+ including the title, border, and content. _--exclude-titlebar_ can be used in
+ conjunction with any other option to specify that the titlebar should be
+ excluded from the region of consideration.
+
+ There is currently, however, no way to execute a mouse binding over a layer
+ surface (which includes the background of an empty workspace). This behaviour
+ is carried over from i3.
Example:
```
@@ -306,7 +319,7 @@ runtime.
bindsym Mod1+Shift+f exec firefox
```
- *bindcode* [--release|--locked] [--input-device=<device>] [--no-warn] <code> <command>
+ *bindcode* [--whole-window] [--border] [--exclude-titlebar] [--release] [--locked] [--input-device=<device>] [--no-warn] <code> <command>
is also available for binding with key/button codes instead of key/button names.
*client.<class>* <border> <background> <text> <indicator> <child_border>
@@ -539,11 +552,6 @@ The default colors are:
\* may be used in lieu of a specific output name to configure all outputs.
A list of output names may be obtained via *swaymsg -t get_outputs*.
-*pointer_constraint* enable|disable|escape
- Enables or disables the ability for clients to capture the cursor (enabled
- by default). This is primarily useful for video games. The "escape" command
- can be used at runtime to escape from a captured client.
-
*popup_during_fullscreen* smart|ignore|leave_fullscreen
Determines what to do when a fullscreen view opens a dialog.
If _smart_ (the default), the dialog will be displayed. If _ignore_, the