From: Stefan Hagen <github@textmail.me>
Date: Sun, 5 Feb 2017 17:57:44 +0000 (+0100)
Subject: Explaing the workspace number "1: www" behavior (#2674)
X-Git-Tag: 4.14~54
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=55692c166795142419ffc2ce57cbdc0a84a61be7;p=i3%2Fi3

Explaing the workspace number "1: www" behavior (#2674)

The documentation did not explain how workspace number `"1: www"` is working.
Related to #2663

Rephrase to cover the creation case
---

diff --git a/docs/userguide b/docs/userguide
index 584edc80..69eeda35 100644
--- a/docs/userguide
+++ b/docs/userguide
@@ -2090,6 +2090,23 @@ i3-msg 'rename workspace to "2: mail"'
 bindsym $mod+r exec i3-input -F 'rename workspace to "%s"' -P 'New name: '
 --------------------------------------------------------------------------
 
+If you want to rename workspaces on demand while keeping the navigation stable,
+you can use a setup like this:
+
+*Example*:
+-------------------------
+bindsym $mod+1 workspace number "1: www"
+bindsym $mod+2 workspace number "2: mail"
+...
+-------------------------
+
+If a workspace does not exist, the command +workspace number "1: mail"+ will
+create workspace "1: mail".
+
+If a workspace with number 1 does already exist, the command will switch to this
+workspace and ignore the text part. So even when the workspace has been renamed
+to "1: web", the above command will still switch to it.
+
 === Moving workspaces to a different screen
 
 See <<move_to_outputs>> for how to move a container/workspace to a different