diff options
Diffstat (limited to 'sway/sway.5.scd')
| -rw-r--r-- | sway/sway.5.scd | 64 |
1 files changed, 48 insertions, 16 deletions
diff --git a/sway/sway.5.scd b/sway/sway.5.scd index 95376ccc..06bc0dbf 100644 --- a/sway/sway.5.scd +++ b/sway/sway.5.scd @@ -134,8 +134,9 @@ They are expected to be used with *bindsym* or at runtime through *swaymsg*(1). *focus* mode\_toggle Moves focus between the floating and tiled layers. -*fullscreen* - Toggles fullscreen for the focused view. +*fullscreen* [enable|disable|toggle] + Makes focused view fullscreen, non-fullscreen, or the opposite of what it + is now. If no argument is given, it does the same as _toggle_. *gaps* inner|outer|horizontal|vertical|top|right|bottom|left all|current set|plus|minus <amount> @@ -280,14 +281,23 @@ runtime. for\_window <criteria> move container to output <output> -*bindsym* [--release|--locked] [--input-device=<device>] <key combo> <command> +*bindsym* [--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 released. Unless the flag _--locked_ is set, the command will not be run when a screen locking program is active. If _input-device_ is given, the binding will only be executed for that input device and will be executed - instead of any binding that is generic to all devices. + instead of any binding that is generic to all devices. By default, if you + overwrite a binding, swaynag will give you a warning. To silence this, use + 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 + 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_. Example: ``` @@ -295,8 +305,8 @@ runtime. bindsym Mod1+Shift+f exec firefox ``` - *bindcode* [--release|--locked] [--input-device=<device>] <code> <command> - is also available for binding with key codes instead of key names. + *bindcode* [--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> Configures the color of window borders and title bars. All 5 colors are @@ -321,7 +331,8 @@ runtime. A view that does not have focus. *client.urgent* - A view with an urgency hint. *Note*: This is not currently implemented. + A view with an urgency hint. *Note*: Native Wayland windows do not + support urgency. Urgency only works for Xwayland windows. The meaning of each color is: @@ -440,6 +451,16 @@ The default colors are: *font* <font> Sets font for use in title bars in Pango format. +*titlebar\_border\_thickness* <thickness> + Thickness of the titlebar border in pixels + +*titlebar\_padding* <horizontal> [<vertical>] + Padding of the text in the titlebar. _horizontal_ value affects horizontal + padding of the text while _vertical_ value affects vertical padding (space + above and below text). Padding includes titlebar borders so their value + should be greater than titlebar\_border\_thickness. If _vertical_ value is + not specified it is set to the _horizontal_ value. + *for\_window* <criteria> <command> Whenever a window that matches _criteria_ appears, run list of commands. See *CRITERIA* for more details. @@ -474,15 +495,6 @@ The default colors are: *seat* <seat> <seat-subcommands...> For details on seat subcommands, see *sway-input*(5). -*seat* <seat> cursor move|set <x> <y> - Move specified seat's cursor relative to current position or wrap to - absolute coordinates (with respect to the global coordinate space). - Specifying either value as 0 will not update that coordinate. - -*seat* <seat> cursor press|release left|right|1|2|3... - Simulate pressing (or releasing) the specified mouse button on the - specified seat. - *kill* Kills (closes) the currently focused container and all of its children. @@ -549,6 +561,26 @@ The default colors are: Set the opacity of the window between 0 (completely transparent) and 1 (completely opaque). +*tiling\_drag* enable|disable|toggle + Sets whether or not tiling containers can be dragged with the mouse. If + enabled (default), the _floating\_mod_ can be used to drag tiling, as well + as floating, containers. Using the left mouse button on title bars without + the _floating\_mod_ will also allow the container to be dragged. _toggle_ + should not be used in the config file. + +*tiling\_drag\_threshold* <threshold> + Sets the threshold that must be exceeded for a container to be dragged by + its titlebar. This has no effect if _floating\_mod_ is used or if + _tiling\_drag_ is set to _disable_. Once the threshold has been exceeded + once, the drag starts and the cursor can come back inside the threshold + without stopping the drag. _threshold_ is multiplied by the scale of the + output that the cursor on. The default is 9. + +*title\_align* left|center|right + Sets the title alignment. If _right_ is selected and _show\_marks_ is set + to _yes_, the marks will be shown on the _left_ side instead of the + _right_ side. + *unmark* [<identifier>] *unmark* will remove _identifier_ from the list of current marks on a window. If _identifier_ is omitted, all marks are removed. |