X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=docs%2Fuserguide;fp=docs%2Fuserguide;h=977e1358c3632460d737ff36176bf04ab093a04b;hb=43386c51d413dc569cfd4939d534f8396f01586d;hp=7eea85423b335f336d7feb806b86b4ec37e68b8c;hpb=94a46a1e35a9cb4e1618feedf669b61a6c193c42;p=i3%2Fi3 diff --git a/docs/userguide b/docs/userguide index 7eea8542..977e1358 100644 --- a/docs/userguide +++ b/docs/userguide @@ -727,8 +727,8 @@ also when restarting i3 you should use the +exec_always+ keyword. These commands will be run in order. See <> for details on the special meaning of +;+ (semicolon) -and +,+ (comma): they chain commands together in i3 and need to be escaped if -you want to use them in your command. +and +,+ (comma): they chain commands together in i3, so you need to use quoted +strings if they appear in your command. *Syntax*: --------------------------------------- @@ -1012,6 +1012,31 @@ force_display_urgency_hint ms force_display_urgency_hint 500 ms --------------------------------- +=== Delaying exiting on zero displays + +Outputs may disappear momentarily and come back later. For example, +using a docking station that does not announce the undock (e.g. ACPI Undock +event triggered through manually pushing a button before actually ejecting +the notebook). During the removal of the notebook from the docking station, +all outputs disappear momentarily. + +To prevent i3 from exiting when no output is available momentarily, you can +tell i3 to delay a certain time first and check available outputs again using +the +delay_exit_on_zero_displays+ directive. Setting the value to 0 disables +this feature. + +The default is 500ms. + +*Syntax*: +---------------------------------------- +delay_exit_on_zero_displays ms +---------------------------------------- + +*Example*: +---------------------------------- +delay_exit_on_zero_displays 500 ms +---------------------------------- + === Focus on window activation [[focus_on_window_activation]] @@ -1551,8 +1576,8 @@ shell. This implies that you can use globbing (wildcards) and programs will be searched in your +$PATH+. See <> for details on the special meaning of +;+ (semicolon) -and +,+ (comma): they chain commands together in i3 and need to be escaped if -you want to use them in your command. +and +,+ (comma): they chain commands together in i3, so you need to use quoted +strings if they appear in your command. *Syntax*: -------------------------------- @@ -1639,15 +1664,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. @@ -1661,23 +1688,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 @@ -1694,8 +1714,33 @@ bindsym $mod+x focus output right # Focus the big output bindsym $mod+x focus output HDMI-2 +------------------------------------------------- + +=== 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] -# Move container to the left, bottom, top, right: +# 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 @@ -1705,10 +1750,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