From 7fea36750ea23906c41c18a2768acad2f51b2916 Mon Sep 17 00:00:00 2001 From: Brian Ashworth Date: Fri, 28 Feb 2020 19:44:18 -0500 Subject: [PATCH] sway.5: correct description of workspace [number] This correct the description of the commmand: workspace [--no-auto-back-and-forth] [number] <[num:]name> Previously, the number and num pieces were being confused. This also documents the behavior of the --no-auto-back-and-forth flag. --- sway/sway.5.scd | 16 +++++++++++++--- 1 file 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] - 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