X-Git-Url: https://git.lizzy.rs/?a=blobdiff_plain;f=doc%2Fbspwm.1.txt;h=e55e0e612b40e575bd0b12fbc2d8f425e2bc6423;hb=dc805f9a6aad87c018b8e552c0c3d5db450c1219;hp=c853a0b3d8fd328afde01ad7a29198cb06652651;hpb=a76c52e3d7107601dbfa4689f54cc08f8dcf273d;p=bspwm.git diff --git a/doc/bspwm.1.txt b/doc/bspwm.1.txt index c853a0b..e55e0e6 100644 --- a/doc/bspwm.1.txt +++ b/doc/bspwm.1.txt @@ -141,7 +141,7 @@ Select a window. ---- WINDOW_SEL := - | (DIR|CYCLE_DIR|biggest|last|focused)[.floating|.tiled][.like|.unlike][.automatic|.manual][.urgent|.nonurgent] + | (DIR|CYCLE_DIR|biggest|last|focused|older|newer)[.floating|.tiled][.like|.unlike][.manual][.urgent][.local] ---- Primary Selectors @@ -158,11 +158,17 @@ biggest:: Selects the biggest window on the current desktop. last:: - Selects the previously focused window on the current desktop. + Selects the previously focused window. focused:: Selects the currently focused window. +older:: + Selects the window older than the focused window in the history. + +newer:: + Selects the window newer than the focused window in the history. + Modifiers ^^^^^^^^^ @@ -178,18 +184,15 @@ like:: unlike:: Only consider windows that have a different class than the current window. -automatic:: - Only consider windows in automatic splitting mode. - manual:: Only consider windows in manual splitting mode (see *--presel*). +local:: + Only consider windows of the current desktop. + urgent:: Only consider urgent windows. -nonurgent:: - Only consider nonurgent windows. - Desktop ~~~~~~~ @@ -198,7 +201,7 @@ Select a desktop. ---- DESKTOP_SEL := | ^ - | (CYCLE_DIR|last|focused)[.occupied|.free][.urgent|.nonurgent] + | (CYCLE_DIR|last|focused|older|newer)[.occupied|.free][.urgent][.local] ---- Primary Selectors @@ -219,6 +222,12 @@ last:: focused:: Selects the currently focused desktop. +older:: + Selects the desktop older than the focused desktop in the history. + +newer:: + Selects the desktop newer than the focused desktop in the history. + Modifiers ^^^^^^^^^ @@ -231,8 +240,8 @@ free:: urgent:: Only consider urgent desktops. -nonurgent:: - Only consider nonurgent desktops. +local:: + Only consider desktops of the current monitor. Monitor ~~~~~~~ @@ -242,7 +251,7 @@ Select a monitor. ---- MONITOR_SEL := | ^ - | (DIR|CYCLE_DIR|last|primary|focused)[.occupied|.free] + | (DIR|CYCLE_DIR|last|primary|focused|older|newer)[.occupied|.free] ---- Primary Selectors @@ -269,6 +278,12 @@ last:: focused:: Selects the currently focused monitor. +older:: + Selects the monitor older than the focused monitor in the history. + +newer:: + Selects the monitor newer than the focused monitor in the history. + Modifiers ^^^^^^^^^ @@ -319,7 +334,7 @@ Options *-R*, *--rotate* 'DIR' '90|270|180':: Rotate the tree holding the edge located in the given direction in relation to the selected window. -*-t*, *--toggle* floating|fullscreen|locked|sticky[=on|off]:: +*-t*, *--toggle* floating|fullscreen|locked|sticky|private[=on|off]:: Set or toggle the given state for the selected window. *-c*, *--close*:: @@ -470,6 +485,9 @@ Options *--toggle-visibility*:: Toggle the visibility of all the windows. +*--record-history* on|off:: + Enable or disable the recording of window focus history. + Pointer ~~~~~~~ @@ -481,11 +499,14 @@ pointer 'OPTIONS' Options ^^^^^^^ +*-g*, *--grab* focus|move|resize_side|resize_corner:: + Initiate the given pointer action. + *-t*, *--track* :: Pass the pointer root coordinates for the current pointer action. -*-g*, *--grab* focus|move|resize_side|resize_corner:: - Perform the given pointer action. +*-u*, *--ungrab*:: + Terminate the current pointer action. Rule ~~~~ @@ -498,13 +519,13 @@ rule 'OPTIONS' Options ^^^^^^^ -*-a*, *--add* [-d 'DESKTOP_SEL' [--follow]] [--floating] [--fullscreen] [--locked] [--sticky] [--focus] [--unmanage] [--one-shot]:: - Create a new rule ( must match the class or instance name). +*-a*, *--add* | [-d 'DESKTOP_SEL' [--follow]] [--floating] [--fullscreen] [--locked] [--sticky] [--focus] [--frame] [--private] [--unmanage] [--one-shot]:: + Create a new rule. -*-r*, *--remove* |tail|head...:: - Remove the rules with the given UIDs. +*-r*, *--remove* |^|tail|head...:: + Remove the rules with the given names or indexes. -*-l*, *--list* []:: +*-l*, *--list* []:: List the rules. Config @@ -558,12 +579,33 @@ Global Settings 'focused_sticky_border_color':: Color of the border of a focused sticky window of a focused monitor. +'active_sticky_border_color':: + Color of the border of a focused sticky window of an unfocused monitor. + 'normal_sticky_border_color':: Color of the border of an unfocused sticky window. +'focused_private_border_color':: + Color of the border of a focused private window of a focused monitor. + +'active_private_border_color':: + Color of the border of a focused private window of an unfocused monitor. + +'normal_private_border_color':: + Color of the border of an unfocused private window. + 'urgent_border_color':: Color of the border of an urgent window. +'focused_frame_opacity':: + Opacity of a focused frame of a focused monitor. + +'active_frame_opacity':: + Opacity of a focused frame of an unfocused monitor. + +'normal_frame_opacity':: + Opacity of an unfocused frame. + 'split_ratio':: Default split ratio. @@ -616,6 +658,42 @@ Desktop Settings Window border width. +Internal State Format +--------------------- + +If a 'PANEL_FIFO' is specified, *bspwm* will write informations regarding its current state to it. + +Those informations are composed of items separated by colons. + +Each item as the form '' where '' is the first character of the item. + +'M':: + Focused monitor. + +'m':: + Unfocused monitor. + +'O':: + Occupied focused desktop. + +'o':: + Occupied unfocused desktop. + +'F':: + Free focused desktop. + +'f':: + Free unfocused desktop. + +'U':: + Urgent focused desktop. + +'u':: + Urgent unfocused desktop. + +'L(tiled|monocle)':: + Layout of the focused desktop of the focused monitor. + Environment Variables ---------------------