diff --git a/docs/userguide b/docs/userguide index 301d8c81..d52e8045 100644 --- a/docs/userguide +++ b/docs/userguide @@ -1637,15 +1637,17 @@ bindsym $mod+f fullscreen toggle bindsym $mod+t floating toggle -------------- -=== Focusing/Moving containers +[[_focusing_moving_containers]] -To change the focus, use the focus command: +focus left+, +focus right+, +focus -down+ and +focus up+. +=== Focusing containers -There are a few special parameters you can use for the focus command: +To change focus, you can use the +focus+ command. The following options are +available: +left|right|up|down:: + Sets focus to the nearest container in the given direction. parent:: - Sets focus to the +Parent Container+ of the current +Container+. + Sets focus to the parent container of the current container. child:: The opposite of +focus parent+, sets the focus to the last focused child container. @@ -1659,23 +1661,16 @@ output:: Followed by a direction or an output name, this will focus the corresponding output. -For moving, use +move left+, +move right+, +move down+ and +move up+. - *Syntax*: ------------------------------------ -focus -focus -focus output <|output> -move [ px] -move [absolute] position [[ px] [ px]|center] ------------------------------------ - -Note that the amount of pixels you can specify for the +move+ command is only -relevant for floating containers. The default amount is 10 pixels. +---------------------------------------------- +focus left|right|down|up +focus parent|child|floating|tiling|mode_toggle +focus output left|right|up|down| +---------------------------------------------- *Examples*: ----------------------- -# Focus container on the left, bottom, top, right: +------------------------------------------------- +# Focus container on the left, bottom, top, right bindsym $mod+j focus left bindsym $mod+k focus down bindsym $mod+l focus up @@ -1692,8 +1687,33 @@ bindsym $mod+x focus output right # Focus the big output bindsym $mod+x focus output HDMI-2 +------------------------------------------------- -# Move container to the left, bottom, top, right: +=== Moving containers + +Use the +move+ command to move a container. + +*Syntax*: +----------------------------------------------------- +# Moves the container into the given direction. +# The optional pixel argument specifies how far the +# container should be moved if it is floating and +# defaults to 10 pixels. +move [ px] + +# Moves the container either to a specific location +# or to the center of the screen. If 'absolute' is +# used, it is moved to the center of all outputs. +move [absolute] position [[ px] [ px]|center] + +# Moves the container to the current position of the +# mouse cursor. Only affects floating containers. +move position mouse +----------------------------------------------------- + +*Examples*: +------------------------------------------------------- +# Move container to the left, bottom, top, right bindsym $mod+j move left bindsym $mod+k move down bindsym $mod+l move up @@ -1703,10 +1723,12 @@ bindsym $mod+semicolon move right # move more than the default bindsym $mod+j move left 20 px -# Move floating container to the center -# of all outputs +# Move floating container to the center of all outputs bindsym $mod+c move absolute position center ----------------------- + +# Move container to the current position of the cursor +bindsym $mod+m move position mouse +------------------------------------------------------- === Changing (named) workspaces/moving to workspaces