userguide: make moving cons/workspaces to other outputs its own section

Frequent requests for this functionality on IRC made me aware that it’s
not easily findable.
This commit is contained in:
Michael Stapelberg 2012-09-19 17:13:00 +02:00
parent 91d6fde7f5
commit c5db01e6f8
1 changed files with 28 additions and 11 deletions

View File

@ -1390,20 +1390,13 @@ container to workspace next+, +move container to workspace prev+ to move a
container to the next/previous workspace and +move container to workspace current+
(the last one makes sense only when used with criteria).
See <<move_to_outputs>> for how to move a container/workspace to a different
RandR output.
[[back_and_forth]]
To switch back to the previously focused workspace, use +workspace
back_and_forth+.
To move a container to another xrandr output such as +LVDS1+ or +VGA1+, you can
use the +move container to output+ command followed by the name of the target
output. You may also use +left+, +right+, +up+, +down+ instead of the xrandr
output name to move to the next output in the specified direction.
To move a whole workspace to another xrandr output such as +LVDS1+ or +VGA1+,
you can use the +move workspace to output+ command followed by the name of the
target output. You may also use +left+, +right+, +up+, +down+ instead of the
xrandr output name to move to the next output in the specified direction.
*Syntax*:
-----------------------------------
workspace <next|prev|next_on_output|prev_on_output>
@ -1465,7 +1458,7 @@ to switch to the workspace which begins with number 1, regardless of which name
it has. This is useful in case you are changing the workspaces name
dynamically.
=== Renaming workspaces
==== Renaming workspaces
You can rename workspaces. This might be useful to start with the default
numbered workspaces, do your work, and rename the workspaces afterwards to
@ -1483,6 +1476,30 @@ i3-msg 'rename workspace 1 to "1: www"'
i3-msg 'rename workspace "1: www" to "10: www"'
------------------------------------------------
=== Moving containers/workspaces to RandR outputs
[[move_to_outputs]]
To move a container to another RandR output (addressed by names like +LVDS1+ or
+VGA1+) or to a RandR output identified by a specific direction (like +left+,
+right+, +up+ or +down+), there are two commands:
*Syntax*:
--------------------------------------------------------
move container to output <<left|right|down|up>|<output>>
move workspace to output <<left|right|down|up>|<output>>
--------------------------------------------------------
*Examples*:
--------------------------------------------------------
# Move the current workspace to the next output
# (effectively toggles when you only have two outputs)
bindsym mod+x move workspace to output right
# Put this window on the presentation output.
bindsym mod+x move container to output VGA1
--------------------------------------------------------
[[resizingconfig]]
=== Resizing containers/windows