1 files changed, 13 insertions, 3 deletions

diff --git a/sway/sway.5.scd b/sway/sway.5.scd
index ad5dacc8..b8b838ab 100644
--- a/sway/sway.5.scd
+++ b/sway/sway.5.scd
@@ -745,9 +745,19 @@ The default colors are:
         state. Using _allow_ or _deny_ controls the window's ability to set itself
         as urgent. By default, windows are allowed to set their own urgency.
 
-*workspace* [--no-auto-back-and-forth] [number] <name>
-        Switches to the specified workspace. The string "number" is optional and is
-        used to sort workspaces.
+*workspace* [--no-auto-back-and-forth] [number] <[num:]name>
+        Switches to the specified workspace. The _num:_ portion of the name is
+        optional and will be used for ordering. If _num:_ is not given and
+        _name_ is a number, then it will be also be used for ordering.
+
+        If the _no-auto-back-and-forth_ option is given, then this command will
+        not perform a back-and-forth operation when the workspace is already
+        focused and _workspace_auto_back_and_forth_ is enabled.
+
+        If the _number_ keyword is specified and a workspace with the number
+        already exists, then the workspace with the number will be used. If a
+        workspace with the number does not exist, a new workspace will be created
+        with the name _name_.
 
 *workspace* prev|next
         Switches to the next workspace on the current output or on the next output