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

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+ container to the next/previous workspace and +move container to workspace current+
(the last one makes sense only when used with criteria). (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]] [[back_and_forth]]
To switch back to the previously focused workspace, use +workspace To switch back to the previously focused workspace, use +workspace
back_and_forth+. 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*: *Syntax*:
----------------------------------- -----------------------------------
workspace <next|prev|next_on_output|prev_on_output> 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 it has. This is useful in case you are changing the workspaces name
dynamically. dynamically.
=== Renaming workspaces ==== Renaming workspaces
You can rename workspaces. This might be useful to start with the default You can rename workspaces. This might be useful to start with the default
numbered workspaces, do your work, and rename the workspaces afterwards to 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"' 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]] [[resizingconfig]]
=== Resizing containers/windows === Resizing containers/windows