From dcf6501ede60cf1ed02f52521777ff323fc6482a Mon Sep 17 00:00:00 2001
From: Nikita Bobko <git@bobko.xyz>
Date: Sun, 29 Oct 2023 14:44:27 +0100
Subject: [PATCH] fixup! Update docs

---
 docs/commands.md | 34 ++++++++++++++++++++++++++++------
 1 file changed, 28 insertions(+), 6 deletions(-)

diff --git a/docs/commands.md b/docs/commands.md
index 270762b9..b8bcff70 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -10,16 +10,22 @@
 - [mode](#mode)
 - [move-container-to-workspace](#move-container-to-workspace)
 - [move-in](#move-in)
+- [move-through](#move-through)
+- [move-workspace-to-display](#move-workspace-to-display)
 
 ## close-all-windows-but-current
 
-> `close-all-windows-but-current`
+```
+close-all-windows-but-current
+```
 
 On the focused workspace, closes all windows but current. This command doesn't have any arguments.
 
 ## exec-and-forget
 
-> `exec-and-forget bash_command`
+```
+exec-and-forget bash_command
+```
 
 Runs `/bin/bash -c '$bash_command'`. Stdout, stderr and exit code are ignored.
 
@@ -27,7 +33,9 @@ For example, you can use this command to launch applications: `exec-and-forget o
 
 ## exec-and-wait
 
-> `exec-and-wait bash_command`
+```
+exec-and-wait bash_command
+```
 
 Runs `/bin/bash -c '$bash_command'`, and waits until the command is terminated. Stdout, stderr and exit code are ignored.
 
@@ -49,15 +57,19 @@ It will open up Terminal.app and make it float. `sleep 1` is still required beca
 
 Flattens [the tree](./guide.md#tree) of currently focused workspace. This command doesn't have any arguments.
 
+The command is useful when you messed up with your layout, and it's easier to "reset" it and start again.
+
 ## focus
 
-> `focus (left|down|up|right)`
+```
+focus (left|down|up|right)
+```
 
 Sets focus to the nearest window in the given direction.
 
 Contrary to i3, `focus` command doesn't have a separate argument to focus floating windows. From `focus` command perspective,
 floating windows are part of [the tree](./guide.md#tree). The floating window parent is determined as the smallest tiling
-container that contains the center of the window.
+container that contains the center of the floating window.
 
 This technique eliminates the need for an additional binding for floating windows.
 
@@ -65,7 +77,15 @@ This technique eliminates the need for an additional binding for floating window
 
 ## layout
 
-> `layout (h_list|v_list|h_accordion|v_accordion|list|accordion|horizontal|vertical|tiling|floating)...`
+```
+layout (h_list|v_list|h_accordion|v_accordion|list|accordion|horizontal|vertical|tiling|floating)...
+```
+
+Changes layout of the focused window to the given layout.
+
+If several arguments are supplied then 
+
+If the currently active layout is not in the list, the first layout in the list will be activated.
 
 `layout (h_list|v_list|h_accordion|v_accordion|list|accordion|horizontal|vertical)` does nothing for floating windows.
 
@@ -77,4 +97,6 @@ This technique eliminates the need for an additional binding for floating window
 
 ## move-through
 
+## move-workspace-to-display
+
 ## reload-config