1 files changed, 20 insertions, 3 deletions

diff --git a/sway/sway.5.scd b/sway/sway.5.scd
index ff138562..5d99c9d6 100644
--- a/sway/sway.5.scd
+++ b/sway/sway.5.scd
@@ -167,6 +167,15 @@ They are expected to be used with *bindsym* or at runtime through *swaymsg*(1).
         "Sticks" a floating window to the current output so that it shows up on all
         workspaces.
 
+*swap* container with id|con\_id|mark <arg>
+        Swaps the position, geometry, and fullscreen status of two containers. The
+        first container can be selected either by criteria or focus. The second
+        container can be selected by _id_, _con\_id_, or _mark_. _id_ can only be
+        used with xwayland views. If the first container has focus, it will retain
+        focus unless it is moved to a different workspace or the second container
+        becomes fullscreen on the same workspace as the first container. In either
+        of those cases, the second container will gain focus.
+
 The following commands may be used either in the configuration file or at
 runtime.
 
@@ -177,17 +186,20 @@ runtime.
 
                 for\_window <criteria> move container to workspace <workspace>
 
-*bindsym* <key combo> <command>
+*bindsym* [--release|--locked] <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.
 
         Example:
 
                 # Execute firefox when alt, shift, and f are pressed together
                 bindsym Mod1+Shift+f exec firefox
 
-        *bindcode* <code> <command> is also available for binding with key codes
-        instead of key names.
+        *bindcode* [--release|--locked] <code> <command> is also available for
+        binding with key codes instead of key names.
 
 *client.<class>* <border> <background> <text> <indicator> <child\_border>
         Configures the color of window borders and title bars. All 5 colors are
@@ -551,6 +563,11 @@ The following attributes may be matched with:
         value is \_\_focused\_\_, then the window instance must be the same as that
         of the currently focused window.
 
+*shell*
+        Compare value against the window shell, such as "xdg\_shell" or "xwayland".
+        Can be a regular expression. If value is \_\_focused\_\_, then the shell
+        must be the same as that of the currently focused window.
+
 *tiling*
         Matches tiling windows.