1 files changed, 60 insertions, 50 deletions

diff --git a/sway/sway.5.txt b/sway/sway.5.txt
index bd2de12d..00806112 100644
--- a/sway/sway.5.txt
+++ b/sway/sway.5.txt
@@ -16,7 +16,13 @@ on startup.  These commands usually consist of setting your preferences and
 setting key bindings. An example config is likely present in /etc/sway/config
 for you to check out.
 
-These commands can be executed in your config file, via **sway-msg**(1), or via
+Lines in the configuration file might be extended through multiple lines by
+adding a '\' character at the end of line. e.g.:
+
+        bindsym Shift+XF86AudioRaiseVolume exec pactl set-sink-volume \
+                $(pactl list sinks | grep -B 1 RUNNING | sed '1q;d' | sed 's/[^0-9]\+//g') +5%
+
+These commands can be executed in your config file, via **swaymsg**(1), or via
 the bindsym command.
 
 Commands
@@ -30,53 +36,28 @@ The following commands may only be used in the configuration file.
         +
         See **sway-bar**(5) for details.
 
-**input** <input device> <block of commands>::
-        Append _{_ to this command, the following lines will be commands to configure
-        the named input device, and _}_ on its own line will close the block.
-        +
-        See **sway-input**(5) for details.
-
 **set** <name> <value>::
-        Creates a substitution for _value_ that can be used with $_name_ in other
-        commands.
+        Sets variable $name to _value_. You can use the new variable in the arguments
+        of future commands.
 
 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>]::
         Set border style for focused window. _normal_ includes a border of thickness
-        _n_ and a title bar. _pixel_ is just the border without title bar. Default is
-        _normal_ with border thickness 2.
+        _n_ and a title bar. _pixel_ is a border without title bar _n_ pixels thick.
+        Default is _normal_ with border thickness 2.
 
 **border** <none|toggle>::
         Set border style for focused window to _none_ or _toggle_ between the
         available border styles: _normal_, _pixel_, _none_.
 
-**new_window** <normal|none|pixel> [<n>]::
-        Set default border style for new windows.
-
-**new_float** <normal|none|pixel> [<n>]::
-        Set default border style for new floating windows. This does only apply to
-        windows that are spawned in floating mode.
-
 **exit**::
         Exit sway and end your Wayland session.
 
 **floating** <enable|disable|toggle>::
         Make focused view floating, non-floating, or the opposite of what it is now.
 
-**floating_maximum_size** <width> x <height>::
-        Specifies the maximum dimensions of floating windows.
-        Uses the container dimensions as default.
-        -1 x -1 will remove any restriction on dimentions.
-        0 x 0 has the same behavior as not setting any value.
-        If in conflict this option has precedence over floating_minimum_size.
-
-**floating_minimum_size** <width> x <height>::
-        Specifies the minimum dimensions of floating windows.
-        Default parameters are 75 x 50.
-        -1 and 0 are invalid parameters, default will be used instead.
-
 **focus** <direction>::
         Direction may be one of _up_, _down_, _left_, _right_, or _parent_. The
         directional focus commands will move the focus in that direction. The parent
@@ -95,9 +76,6 @@ They are expected to be used with **bindsym** or at runtime through **swaymsg**(
 **fullscreen**::
         Toggles fullscreen status for the focused view.
 
-**hide_edge_borders** <none|vertical|horizontal|both>::
-        Hide window borders adjacent to the screen edges. Default is _none_.
-
 **layout** <mode>::
         Sets the layout mode of the focused container. _mode_ can be one of _splith_,
         _splitv_, _toggle split_, _stacking_ or _tabbed_.
@@ -134,8 +112,8 @@ They are expected to be used with **bindsym** or at runtime through **swaymsg**(
         Equivalent to **split toggle**.
 
 **sticky** <enable|disable|toggle>::
-        If enabled and the windows is floating it will always be present on the active
-        workspace on that output.
+        "Sticks" a floating window to the current output so that it shows up on all
+        workspaces.
 
 The following commands may be used either in the configuration file
 or triggered at runtime.
@@ -149,7 +127,7 @@ or triggered at runtime.
 **bindsym** <key combo> <command>::
         Binds _key combo_ to execute _command_ when pressed. You may use XKB key
         names here (**xev**(1) is a good tool for discovering them). An example
-        bindsym command would be _bindsym Mod1+Shift+f exec firefox_, which would
+        bindsym command would be **bindsym Mod1+Shift+f exec firefox**, which would
         execute Firefox if the alt, shift, and F keys are pressed together. Any
         valid sway command is eligible to be bound to a key combo.
         +
@@ -195,18 +173,18 @@ The default colors are:
 [options="header"]
 |===========================================================================
 |color_class      |border    |background |text      |indicator |child_border
-|background       |n/a       |#ffffffff  |n/a       |n/a       |n/a
-|focused          |#4c7899ff |#285577ff  |#ffffffff |#2e9ef4ff |#285577ff
-|focused_inactive |#333333ff |#5f676aff  |#ffffffff |#484e50ff |#5f676aff
-|unfocused        |#333333ff |#222222ff  |#888888ff |#292d2eff |#222222ff
-|urgent           |#2f343aff |#900000ff  |#ffffffff |#900000ff |#900000ff
-|placeholder      |#000000ff |#0c0c0cff  |#ffffffff |#000000ff |#0c0c0cff
+|background       |n/a       |#ffffff  |n/a       |n/a       |n/a
+|focused          |#4c7899 |#285577  |#ffffff |#2e9ef4 |#285577
+|focused_inactive |#333333 |#5f676a  |#ffffff |#484e50 |#5f676a
+|unfocused        |#333333 |#222222  |#888888 |#292d2e |#222222
+|urgent           |#2f343a |#900000  |#ffffff |#900000 |#900000
+|placeholder      |#000000 |#0c0c0c  |#ffffff |#000000 |#0c0c0c
 |===========================================================================
 --
 
 **debuglog** <on|off|toggle>::
-        Enables, disables or toggles logging for debug. The toggle argument cannot
-        be used in the configuration file.
+        Enables, disables or toggles debug logging. The toggle argument cannot be used
+        in the configuration file.
 
 **exec** <shell command>::
         Executes _shell command_ with sh.
@@ -215,21 +193,32 @@ The default colors are:
         Like exec, but the shell command will be executed _again_ after *reload* or
         *restart* is executed.
 
+**floating_maximum_size** <width> x <height>::
+        Specifies the maximum dimensions of floating windows.
+        Uses the container dimensions as default.
+        -1 x -1 will remove any restriction on dimentions.
+        0 x 0 has the same behavior as not setting any value.
+        If in conflict this option has precedence over floating_minimum_size.
+
+**floating_minimum_size** <width> x <height>::
+        Specifies the minimum dimensions of floating windows.
+        Default parameters are 75 x 50.
+        -1 and 0 are invalid parameters, default will be used instead.
+
 **floating_modifier** <modifier> [normal|inverse]::
-        When the _modifier_ key is held down, you may use left click to drag floating
+        When the _modifier_ key is held down, you may hold left click to move floating
         windows, and right click to resize them. Unlike i3, this modifier may also be
         used to resize and move windows that are tiled. With the _inverse_ mode
         enabled, left click is used for resizing and right click for dragging. The
         mode paramenter is optional and defaults to _normal_ if it isn't defined.
 
 **floating_scroll** <up|down|left|right> [command]::
-        Sets the command to be executed on scrolling in the specified
-        direction while holding the floating modifier. Resets the
-        command, when given no arguments.
+        Sets a command to be executed when the mouse wheel is scrolled in the
+        specified direction while holding the floating modifier. Resets the command,
+        when given no arguments.
 
 **focus_follows_mouse** <yes|no>::
-        If set to _yes_, the currently focused view will change as you move your
-        mouse around the screen to the view that ends up underneath your mouse.
+        If set to _yes_, moving your mouse over a window will focus that window.
 
 **for_window** <criteria> <command>::
         Whenever a window that matches _criteria_ appears, run list of commands. See
@@ -256,6 +245,15 @@ The default colors are:
         workspace (or current workspace), and _current_ changes gaps for the current
         view or workspace.
 
+**hide_edge_borders** <none|vertical|horizontal|both>::
+        Hide window borders adjacent to the screen edges. Default is _none_.
+
+**input** <input device> <block of commands>::
+        Append _{_ to this command, the following lines will be commands to configure
+        the named input device, and _}_ on its own line will close the block.
+        +
+        See **sway-input**(5) for details.
+
 **smart_gaps** <on|off>::
         If smart_gaps are _on_ then gaps will only be enabled if a workspace has more
         than one child container.
@@ -269,8 +267,20 @@ The default colors are:
         When _output_: place mouse at center of newly focused window when changing
         output. When _none_: don't move mouse.
 
+**new_window** <normal|none|pixel> [<n>]::
+        Set default border style for new windows.
+
+**new_float** <normal|none|pixel> [<n>]::
+        Set default border style for new floating windows. This only applies to
+        windows that are spawned in floating mode, not windows that become floating
+        after the fact.
+
 **output** <name> <resolution|res> <WIDTHxHEIGHT>::
         Configures the specified output to use the given resolution.
+        +
+        _Note_: sway does not currently support modesetting. Your output's native
+        resolution will be used and the screen will be scaled from the resolution
+        specified to your native resolution.
 
 **output** <name> <position|pos> <X,Y>::
         Configures the specified output to be arranged at the given position.