diff options
Diffstat (limited to 'sway/sway.5.scd')
| -rw-r--r-- | sway/sway.5.scd | 86 |
1 files changed, 20 insertions, 66 deletions
diff --git a/sway/sway.5.scd b/sway/sway.5.scd index 240e0731..f6f0e859 100644 --- a/sway/sway.5.scd +++ b/sway/sway.5.scd @@ -87,14 +87,15 @@ The following commands may only be used in the configuration file. The following commands cannot be used directly in the configuration file. They are expected to be used with *bindsym* or at runtime through *swaymsg*(1). -*border* normal|pixel [<n>] +*border* none|normal|csd|pixel [<n>] Set border style for focused window. _normal_ includes a border of thickness _n_ and a title bar. _pixel_ is a border without title bar _n_ - pixels thick. Default is _normal_ with border thickness 2. + pixels thick. Default is _normal_ with border thickness 2. _csd_ is short + for client-side-decorations, which allows the client to draw its own + decorations. -*border* none|toggle - Set border style for focused window to _none_ or _toggle_ between the - available border styles: _normal_, _pixel_, _none_. +*border* toggle + Cycles through the available border styles. *exit* Exit sway and end your Wayland session. @@ -420,15 +421,11 @@ The default colors are: _focus\_wrapping force_. This is only available for convenience. Please use _focus\_wrapping_ instead when possible. -*gaps* edge\_gaps on|off|toggle - When _on_, gaps will be added between windows and workspace edges if the - inner gap is nonzero. When _off_, gaps will only be added between views. - _toggle_ cannot be used in the configuration file. - *gaps* inner|outer <amount> Sets default _amount_ pixels of _inner_ or _outer_ gap, where the inner affects spacing around each view and outer affects the spacing around each - workspace. Outer gaps are in addition to inner gaps. + workspace. Outer gaps are in addition to inner gaps. To reduce or remove + outer gaps, outer gaps can be set to a negative value. This affects new workspaces only, and is used when the workspace doesn't have its own gaps settings (see: workspace <ws> gaps inner|outer <amount>). @@ -501,61 +498,6 @@ The default colors are: Prevents windows matching <criteria> from being focused automatically when they're created. This has no effect on the first window in a workspace. -*output* <name> mode|resolution|res <WIDTHxHEIGHT>[@<RATE>[Hz]] - Configures the specified output to use the given mode. Modes are a - combination of width and height (in pixels) and a refresh rate that your - display can be configured to use. For a list of available modes for each - output, use *swaymsg -t get\_outputs*. - - Examples: - - output HDMI-A-1 mode 1920x1080 - - output HDMI-A-1 mode 1920x1080@60Hz - -*output* <name> position|pos <X> <Y> - Places the specified output at the specific position in the global - coordinate space. - -*output* <name> scale <factor> - Scales the specified output by the specified scale _factor_. An integer is - recommended, but fractional values are also supported. If a fractional - value are specified, be warned that it is not possible to faithfully - represent the contents of your windows - they will be rendered at the next - highest integral scale factor and downscaled. You may be better served by - setting an integral scale factor and adjusting the font size of your - applications to taste. - -*output* <name> background|bg <file> <mode> [<fallback\_color>] - Sets the wallpaper for the given output to the specified file, using the - given scaling mode (one of "stretch", "fill", "fit", "center", "tile"). If - the specified file cannot be accessed or if the image does fill the entire - output, a fallback color may be provided to cover the rest of the output. - __fallback\_color__ should be specified as _#RRGGBB_. Alpha is not - supported. - -**output** <name> background|bg <color> solid\_color - Sets the background of the given output to the specified color. _color_ - should be specified as _#RRGGBB_. Alpha is not supported. - -**output** <name> transform <transform> - Sets the background transform to the given value. Can be one of "90", "180", - "270" for rotation; or "flipped", "flipped-90", "flipped-180", "flipped-270" - to apply a rotation and flip, or "normal" to apply no transform. - -*output* <name> disable|enable - Enables or disables the specified output (all outputs are enabled by - default). - -*NOTES FOR THE OUTPUT COMMANDS* - -You may combine output commands into one, like so: - - output HDMI-A-1 mode 1920x1080 pos 1920,0 bg ~/wallpaper.png stretch - -You can get a list of output names with *swaymsg -t get\_outputs*. You may also -match any output by using the output name "\*". - *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 @@ -618,6 +560,18 @@ match any output by using the output name "\*". *workspace\_layout* default|stacking|tabbed Specifies the initial layout for new workspaces. +# BAR CONTROL + +*bar hidden\_state* hide|show|toggle [<bar\_id>] + Sets the hidden state of the bar (see *sway-bar*(5)), either individually, + by specifying a bar id, or if none is given, for all bar instances. + _toggle_ switches between _hide_ and _show_. + +*bar mode* dock|hide|invisible|toggle [<bar\_id>] + Sets the mode of the bar (see *sway-bar*(5)), either individually, + by specifying a bar id, or if none is given, for all bar instances. + _toggle_ switches between _dock_ and _hide_. + # CRITERIA A criteria is a string in the form of, for example: |