X-Git-Url: https://git.lizzy.rs/?a=blobdiff_plain;f=doc%2Fbspwm.1;h=c7f6e500a25808adfee10b000b3aa7a4b69714bb;hb=a7821774c50aefa8c758b964814818b4634b77ce;hp=fab196a8cbc40e49da18dd822f69111e902ed309;hpb=d85d3133f9fbcb6d583ffa027e5ee1c6d8c7eced;p=bspwm.git diff --git a/doc/bspwm.1 b/doc/bspwm.1 index fab196a..c7f6e50 100644 --- a/doc/bspwm.1 +++ b/doc/bspwm.1 @@ -2,12 +2,12 @@ .\" Title: bspwm .\" Author: [see the "Author" section] .\" Generator: DocBook XSL Stylesheets v1.78.1 -.\" Date: 07/18/2014 +.\" Date: 05/09/2016 .\" Manual: Bspwm Manual -.\" Source: Bspwm 0.8.9 +.\" Source: Bspwm 0.9.1-54-gcdc20bb .\" Language: English .\" -.TH "BSPWM" "1" "07/18/2014" "Bspwm 0\&.8\&.9" "Bspwm Manual" +.TH "BSPWM" "1" "05/09/2016" "Bspwm 0\&.9\&.1\-54\-gcdc20bb" "Bspwm Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -33,7 +33,9 @@ bspwm \- Binary space partitioning window manager .sp \fBbspwm\fR [\fB\-h\fR|\fB\-v\fR|\fB\-c\fR \fICONFIG_PATH\fR] .sp -\fBbspc\fR \fICOMMAND\fR [\fIARGUMENTS\fR] +\fBbspc\fR \fIDOMAIN\fR [\fISELECTOR\fR] \fICOMMANDS\fR +.sp +\fBbspc\fR \fICOMMAND\fR [\fIOPTIONS\fR] [\fIARGUMENTS\fR] .SH "DESCRIPTION" .sp \fBbspwm\fR is a tiling window manager that represents windows as the leaves of a full binary tree\&. @@ -55,87 +57,13 @@ Print the version and exit\&. .RS 4 Use the given configuration file\&. .RE -.SH "CONFIGURATION" -.sp -\fBbspwm\fR has only two sources of informations: the X events it receives and the messages it reads on a dedicated socket\&. -.sp -The default configuration file is \fI$XDG_CONFIG_HOME/bspwm/bspwmrc\fR\&. -.sp -Keyboard and pointer bindings are defined with sxhkd\&. -.sp -Example configuration files can be found in the \fBexamples\fR directory\&. -.SH "SPLITTING MODES" -.sp -New windows are inserted in the tree as close as possible to the focused window\&. -.sp -There is only two splitting modes: \fIautomatic\fR and \fImanual\fR\&. -.sp -The default mode is \fIautomatic\fR\&. The \fImanual\fR mode is entered by sending a \fBpreselection\fR message\&. -.sp -Example: insertion of a new node (number 4) into the given tree in \fIautomatic\fR mode: -.sp -.if n \{\ -.RS 4 -.\} -.nf - b c - / \e / \e - 3 a \-\-> 4 b - ^ / \e ^ / \e - 2 1 3 a - / \e - 2 1 - +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ - | | | | | | - | | 2 | | | 3 | - | | | | | | - | 3 |\-\-\-\-\-\-\-\-\-\-\-\-| \-\-> | 4 |\-\-\-\-\-\-\-\-\-\-\-\-| - | ^ | | | ^ | | | - | | 1 | | | 1 | 2 | - | | | | | | | - +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ -.fi -.if n \{\ -.RE -.\} -.sp -Same departure, but the mode is \fImanual\fR, and a \fBwindow \-\-presel up\fR message was sent beforehand: -.sp -.if n \{\ -.RS 4 -.\} -.nf - b b - / \e / \e - 3 a \-\-> c a - ^ / \e / \e / \e - 2 1 4 3 2 1 - ^ -+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ -| | | | | | -| | 2 | | 4 | 2 | -| | | | ^ | | -| 3 |\-\-\-\-\-\-\-\-\-\-\-\-| \-\-> |\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\-| -| ^ | | | | | -| | 1 | | 3 | 1 | -| | | | | | -+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ -.fi -.if n \{\ -.RE -.\} -.SH "CONTAINERS" -.sp -Each monitor contains at least one desktop\&. -.sp -Each desktop contains at most one tree\&. .SH "COMMON DEFINITIONS" .sp .if n \{\ .RS 4 .\} .nf -DIR := left | right | up | down +DIR := north | west | south | east CYCLE_DIR := next | prev .fi .if n \{\ @@ -143,31 +71,40 @@ CYCLE_DIR := next | prev .\} .SH "SELECTORS" .sp -Selectors are used to select a target window, desktop, or monitor\&. A selector can either describe the target relatively or name it globally\&. +Selectors are used to select a target node, desktop, or monitor\&. A selector can either describe the target relatively or name it globally\&. .sp -Descriptive (relative) selectors consist of a primary selector and any number of non\-conflicting modifiers as follows: +Selectors consist of a descriptor and any number of non\-conflicting modifiers as follows: .sp .if n \{\ .RS 4 .\} .nf -PRIMARY_SELECTOR[\&.MODIFIER]* +DESCRIPTOR(\&.MODIFIER)* .fi .if n \{\ .RE .\} .sp -For obvious reasons, neither desktops nor monitors names may be valid descriptive selectors\&. -.SS "Window" +An exclamation mark can be prepended to certain modifiers in order to reverse their meaning\&. +.SS "Node" .sp -Select a window\&. +Select a node\&. .sp .if n \{\ .RS 4 .\} .nf -WINDOW_SEL := - | (DIR|CYCLE_DIR|biggest|last|focused|older|newer)[\&.floating|\&.tiled][\&.like|\&.unlike][\&.manual|\&.automatic][\&.urgent][\&.local] +NODE_SEL := (DIR|CYCLE_DIR|PATH|last|older|newer|focused|pointed|biggest|)[\&.[!]focused][\&.[!]automatic][\&.[!]local][\&.[!]leaf][\&.[!]window][\&.[!]STATE][\&.[!]FLAG][\&.[!]LAYER][\&.[!]same_class] + +STATE := tiled|pseudo_tiled|floating|fullscreen + +FLAG := hidden|sticky|private|locked|urgent + +LAYER := below|normal|above + +PATH := @[DESKTOP_SEL:][[/]JUMP](/JUMP)* + +JUMP := first|1|second|2|brother|parent|DIR .fi .if n \{\ .RE @@ -178,12 +115,12 @@ WINDOW_SEL := .nr an-break-flag 1 .br .ps +1 -\fBPrimary Selectors\fR +\fBDescriptors\fR .RS 4 .PP \fIDIR\fR .RS 4 -Selects the window in the given (spacial) direction relative to the active window\&. +Selects the window in the given (spacial) direction relative to the active node\&. .RE .PP \fICYCLE_DIR\fR @@ -191,29 +128,80 @@ Selects the window in the given (spacial) direction relative to the active windo Selects the window in the given (cyclic) direction\&. .RE .PP -biggest +\fIPATH\fR .RS 4 -Selects the biggest window on the current desktop\&. +Selects the node at the given path\&. .RE .PP last .RS 4 -Selects the previously focused window\&. +Selects the previously focused node\&. +.RE +.PP +older +.RS 4 +Selects the node older than the focused node in the history\&. +.RE +.PP +newer +.RS 4 +Selects the node newer than the focused node in the history\&. .RE .PP focused .RS 4 -Selects the currently focused window\&. +Selects the currently focused node\&. .RE .PP -older +pointed .RS 4 -Selects the window older than the focused window in the history\&. +Selects the window under the pointer\&. .RE .PP -newer +biggest +.RS 4 +Selects the biggest window on the current desktop\&. +.RE +.PP + +.RS 4 +Selects the node with the given ID\&. +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBPath Jumps\fR +.RS 4 +.sp +The initial node is the focused node (or the root if the path starts with \fI/\fR) of the focused desktop (or the selected desktop if the path has a \fIDESKTOP_SEL\fR prefix)\&. +.PP +1|first +.RS 4 +Jumps to the first child\&. +.RE +.PP +2|second +.RS 4 +Jumps to the second child\&. +.RE +.PP +brother +.RS 4 +Jumps to the brother node\&. +.RE +.PP +parent +.RS 4 +Jumps to the parent node\&. +.RE +.PP +\fIDIR\fR .RS 4 -Selects the window newer than the focused window in the history\&. +Jumps to the node holding the edge in the given direction\&. .RE .RE .sp @@ -225,44 +213,49 @@ Selects the window newer than the focused window in the history\&. \fBModifiers\fR .RS 4 .PP -floating +[!]focused .RS 4 -Only consider floating windows\&. +Only consider focused or unfocused nodes\&. .RE .PP -tiled +[!]automatic .RS 4 -Only consider tiled windows\&. +Only consider nodes in automatic or manual insertion mode\&. .RE .PP -like +[!]local .RS 4 -Only consider windows that have the same class as the current window\&. +Only consider nodes in or not in the current desktop\&. .RE .PP -unlike +[!]leaf .RS 4 -Only consider windows that have a different class than the current window\&. +Only consider leaves or internal nodes\&. .RE .PP -manual +[!]window .RS 4 -Only consider windows in manual splitting mode\&. +Only consider nodes that hold or don\(cqt hold a window\&. .RE .PP -automatic +[!](tiled|pseudo_tiled|floating|fullscreen) .RS 4 -Only consider windows in automatic splitting mode\&. +Only consider windows in or not in the given state\&. .RE .PP -local +[!]same_class .RS 4 -Only consider windows of the current desktop\&. +Only consider windows that have or don\(cqt have the same class as the current window\&. .RE .PP -urgent +[!](hidden|sticky|private|locked|urgent) +.RS 4 +Only consider windows that have or don\(cqt have the given flag set\&. +.RE +.PP +[!](below|normal|above) .RS 4 -Only consider urgent windows\&. +Only consider windows in or not in the given layer\&. .RE .RE .SS "Desktop" @@ -273,9 +266,7 @@ Select a desktop\&. .RS 4 .\} .nf -DESKTOP_SEL := - | [MONITOR_SEL:]^ - | (CYCLE_DIR|last|[MONITOR_SEL:]focused|older|newer)[\&.occupied|\&.free][\&.urgent][\&.local] +DESKTOP_SEL := (CYCLE_DIR|last|older|newer|[MONITOR_SEL:](focused|^)||)[\&.[!]occupied][\&.[!]focused][\&.[!]urgent][\&.[!]local] .fi .if n \{\ .RE @@ -286,27 +277,27 @@ DESKTOP_SEL := .nr an-break-flag 1 .br .ps +1 -\fBPrimary Selectors\fR +\fBDescriptors\fR .RS 4 .PP - +\fICYCLE_DIR\fR .RS 4 -Selects the desktop with the given name\&. +Selects the desktop in the given direction relative to the active desktop\&. .RE .PP -^ +last .RS 4 -Selects the nth desktop\&. +Selects the previously focused desktop\&. .RE .PP -\fICYCLE_DIR\fR +older .RS 4 -Selects the desktop in the given direction relative to the active desktop\&. +Selects the desktop older than the focused desktop in the history\&. .RE .PP -last +newer .RS 4 -Selects the previously focused desktop\&. +Selects the desktop newer than the focused desktop in the history\&. .RE .PP focused @@ -314,14 +305,19 @@ focused Selects the currently focused desktop\&. .RE .PP -older +^ .RS 4 -Selects the desktop older than the focused desktop in the history\&. +Selects the nth desktop\&. .RE .PP -newer + .RS 4 -Selects the desktop newer than the focused desktop in the history\&. +Selects the desktop with the given ID\&. +.RE +.PP + +.RS 4 +Selects the desktop with the given name\&. .RE .RE .sp @@ -333,24 +329,24 @@ Selects the desktop newer than the focused desktop in the history\&. \fBModifiers\fR .RS 4 .PP -occupied +[!]occupied .RS 4 -Only consider occupied desktops\&. +Only consider occupied or free desktops\&. .RE .PP -free +[!]focused .RS 4 -Only consider free desktops\&. +Only consider focused or unfocused desktops\&. .RE .PP -urgent +[!]urgent .RS 4 -Only consider urgent desktops\&. +Only consider urgent or non urgent desktops\&. .RE .PP -local +[!]local .RS 4 -Only consider desktops of the current monitor\&. +Only consider inside or outside of the current monitor\&. .RE .RE .SS "Monitor" @@ -361,9 +357,7 @@ Select a monitor\&. .RS 4 .\} .nf -MONITOR_SEL := - | ^ - | (DIR|CYCLE_DIR|last|primary|focused|older|newer)[\&.occupied|\&.free] +MONITOR_SEL := (DIR|CYCLE_DIR|last|older|newer|focused|primary|^||)[\&.[!]occupied][\&.[!]focused] .fi .if n \{\ .RE @@ -374,18 +368,8 @@ MONITOR_SEL := .nr an-break-flag 1 .br .ps +1 -\fBPrimary Selectors\fR -.RS 4 -.PP - -.RS 4 -Selects the monitor with the given name\&. -.RE -.PP -^ +\fBDescriptors\fR .RS 4 -Selects the nth monitor\&. -.RE .PP \fIDIR\fR .RS 4 @@ -397,14 +381,19 @@ Selects the monitor in the given (spacial) direction relative to the active moni Selects the monitor in the given (cyclic) direction relative to the active monitor\&. .RE .PP -primary +last .RS 4 -Selects the primary monitor\&. +Selects the previously focused monitor\&. .RE .PP -last +older .RS 4 -Selects the previously focused monitor\&. +Selects the monitor older than the focused monitor in the history\&. +.RE +.PP +newer +.RS 4 +Selects the monitor newer than the focused monitor in the history\&. .RE .PP focused @@ -412,14 +401,24 @@ focused Selects the currently focused monitor\&. .RE .PP -older +primary .RS 4 -Selects the monitor older than the focused monitor in the history\&. +Selects the primary monitor\&. .RE .PP -newer +^ .RS 4 -Selects the monitor newer than the focused monitor in the history\&. +Selects the nth monitor\&. +.RE +.PP + +.RS 4 +Selects the monitor with the given ID\&. +.RE +.PP + +.RS 4 +Selects the monitor with the given name\&. .RE .RE .sp @@ -431,38 +430,42 @@ Selects the monitor newer than the focused monitor in the history\&. \fBModifiers\fR .RS 4 .PP -occupied +[!]occupied .RS 4 -Only consider monitors where the focused desktop is occupied\&. +Only consider monitors where the focused desktop is occupied or free\&. .RE .PP -free +[!]focused .RS 4 -Only consider monitors where the focused desktop is free\&. +Only consider focused or unfocused monitors\&. .RE .RE .SH "WINDOW STATES" .PP -floating +tiled .RS 4 -Is above any tiled window and can be moved/resized freely\&. Although it doesn\(cqt occupy any tiling space, it is still part of the window tree\&. +Its size and position are determined by the splitting type and ratio of each node of its path in the window tree\&. .RE .PP pseudo_tiled .RS 4 -Has a libre size while being centered in its tiling space\&. +Has an unrestricted size while being centered in its tiling space\&. +.RE +.PP +floating +.RS 4 +Can be moved/resized freely\&. Although it doesn\(cqt occupy any tiling space, it is still part of the window tree\&. .RE .PP fullscreen .RS 4 -Fills its monitor rectangle, is above all the other windows and has no borders\&. +Fills its monitor rectangle and has no borders\&. It is send in the ABOVE layer by default\&. .RE +.SH "NODE FLAGS" .PP -locked +hidden .RS 4 -Ignores the -\fBclose\fR -message\&. +Is hidden and doesn\(cqt occupy any tiling space\&. .RE .PP sticky @@ -474,8 +477,25 @@ private .RS 4 Tries to keep the same tiling position/size\&. .RE -.SH "COMMANDS" -.SS "Window" +.PP +locked +.RS 4 +Ignores the +\fBnode \-\-close\fR +message\&. +.RE +.PP +urgent +.RS 4 +Has its urgency hint set\&. This flag is set externally\&. +.RE +.SH "STACKING LAYERS" +.sp +There\(cqs three stacking layers: BELOW, NORMAL and ABOVE\&. +.sp +In each layer, the window are orderered as follow: tiled & pseudo\-tiled < fullscreen < floating\&. +.SH "DOMAINS" +.SS "Node" .sp .it 1 an-trap .nr an-no-space-flag 1 @@ -485,7 +505,9 @@ Tries to keep the same tiling position/size\&. \fBGeneral Syntax\fR .RS 4 .sp -window [\fIWINDOW_SEL\fR] \fIOPTIONS\fR +node [\fINODE_SEL\fR] \fICOMMANDS\fR +.sp +If \fINODE_SEL\fR is omitted, \fBfocused\fR is assumed\&. .RE .sp .it 1 an-trap @@ -493,69 +515,135 @@ window [\fIWINDOW_SEL\fR] \fIOPTIONS\fR .nr an-break-flag 1 .br .ps +1 -\fBOptions\fR +\fBCommands\fR .RS 4 .PP -\fB\-f\fR, \fB\-\-focus\fR [\fIWINDOW_SEL\fR] +\fB\-f\fR, \fB\-\-focus\fR [\fINODE_SEL\fR] .RS 4 -Focus the selected or given window\&. +Focus the selected or given node\&. +.RE +.PP +\fB\-a\fR, \fB\-\-activate\fR [\fINODE_SEL\fR] +.RS 4 +Activate the selected or given node\&. .RE .PP \fB\-d\fR, \fB\-\-to\-desktop\fR \fIDESKTOP_SEL\fR .RS 4 -Send the selected window to the given desktop\&. +Send the selected node to the given desktop\&. .RE .PP \fB\-m\fR, \fB\-\-to\-monitor\fR \fIMONITOR_SEL\fR .RS 4 -Send the selected window to the given monitor\&. +Send the selected node to the given monitor\&. +.RE +.PP +\fB\-n\fR, \fB\-\-to\-node\fR \fINODE_SEL\fR +.RS 4 +Transplant the selected node to the given node\&. +.RE +.PP +\fB\-s\fR, \fB\-\-swap\fR \fINODE_SEL\fR +.RS 4 +Swap the selected node with the given node\&. +.RE +.PP +\fB\-p\fR, \fB\-\-presel\-dir\fR [~]\fIDIR\fR|cancel +.RS 4 +Preselect the splitting area of the selected node (or cancel the preselection)\&. If +\fB~\fR +is prepended to +\fIDIR\fR +and the current preselection direction matches +\fIDIR\fR, then the argument is interpreted as +\fBcancel\fR\&. .RE .PP -\fB\-w\fR, \fB\-\-to\-window\fR \fIWINDOW_SEL\fR +\fB\-o\fR, \fB\-\-presel\-ratio\fR \fIRATIO\fR .RS 4 -Transplant the selected window to the given window\&. +Set the splitting ratio of the preselection area\&. .RE .PP -\fB\-s\fR, \fB\-\-swap\fR \fIWINDOW_SEL\fR +\fB\-v\fR, \fB\-\-move\fR \fIdx\fR \fIdy\fR .RS 4 -Swap the selected window with the given window\&. +Move the selected window by +\fIdx\fR +pixels horizontally and +\fIdy\fR +pixels vertically\&. .RE .PP -\fB\-p\fR, \fB\-\-presel\fR \fIDIR\fR|cancel +\fB\-z\fR, \fB\-\-resize\fR top|left|bottom|right|top_left|top_right|bottom_right|bottom_left \fIdx\fR \fIdy\fR .RS 4 -Preselect the splitting area of the selected window (or cancel the preselection)\&. +Resize the selected window by moving the given handle by +\fIdx\fR +pixels horizontally and +\fIdy\fR +pixels vertically\&. .RE .PP -\fB\-r\fR, \fB\-\-ratio\fR \fIRATIO\fR +\fB\-r\fR, \fB\-\-ratio\fR \fIRATIO\fR|(+|\-)\fIPIXELS\fR .RS 4 -Set the splitting ratio of the selected window (0 < +Set the splitting ratio of the selected node (0 < \fIRATIO\fR < 1)\&. .RE .PP -\fB\-e\fR, \fB\-\-edge\fR \fIDIR\fR \fIRATIO\fR|\(+-\fIPIXELS\fR +\fB\-R\fR, \fB\-\-rotate\fR \fI90|270|180\fR +.RS 4 +Rotate the tree rooted at the selected node\&. +.RE +.PP +\fB\-F\fR, \fB\-\-flip\fR \fIhorizontal|vertical\fR +.RS 4 +Flip the the tree rooted at selected node\&. +.RE +.PP +\fB\-E\fR, \fB\-\-equalize\fR +.RS 4 +Reset the split ratios of the tree rooted at the selected node to their default value\&. +.RE +.PP +\fB\-B\fR, \fB\-\-balance\fR +.RS 4 +Adjust the split ratios of the tree rooted at the selected node so that all windows occupy the same area\&. +.RE +.PP +\fB\-C\fR, \fB\-\-circulate\fR forward|backward +.RS 4 +Circulate the windows of the tree rooted at the selected node\&. +.RE +.PP +\fB\-t\fR, \fB\-\-state\fR [~](tiled|pseudo_tiled|floating|fullscreen) +.RS 4 +Set the state of the selected window\&. If +\fB~\fR +is present and the current state matches the given state, then the argument is interpreted as the last state\&. +.RE +.PP +\fB\-g\fR, \fB\-\-flag\fR hidden|sticky|private|locked[=on|off] .RS 4 -Set or change the splitting ratio of the edge located in the given direction in relation to the selected window\&. +Set or toggle the given flag for the selected node\&. .RE .PP -\fB\-R\fR, \fB\-\-rotate\fR \fIDIR\fR \fI90|270|180\fR +\fB\-l\fR, \fB\-\-layer\fR below|normal|above .RS 4 -Rotate the tree holding the edge located in the given direction in relation to the selected window\&. +Set the stacking layer of the selected window\&. .RE .PP -\fB\-t\fR, \fB\-\-toggle\fR floating|fullscreen|pseudo_tiled|locked|sticky|private[=on|off] +\fB\-i\fR, \fB\-\-insert\-receptacle\fR .RS 4 -Set or toggle the given state for the selected window\&. +Insert a receptacle node at the selected node\&. .RE .PP \fB\-c\fR, \fB\-\-close\fR .RS 4 -Close the selected window\&. +Close the windows rooted at the selected node\&. .RE .PP \fB\-k\fR, \fB\-\-kill\fR .RS 4 -Kill the selected window\&. +Kill the windows rooted at the selected node\&. .RE .RE .SS "Desktop" @@ -568,7 +656,9 @@ Kill the selected window\&. \fBGeneral Syntax\fR .RS 4 .sp -desktop [\fIDESKTOP_SEL\fR] \fIOPTIONS\fR +desktop [\fIDESKTOP_SEL\fR] \fICOMMANDS\fR +.sp +If \fIDESKTOP_SEL\fR is omitted, \fBfocused\fR is assumed\&. .RE .sp .it 1 an-trap @@ -576,7 +666,7 @@ desktop [\fIDESKTOP_SEL\fR] \fIOPTIONS\fR .nr an-break-flag 1 .br .ps +1 -\fBOptions\fR +\fBCOMMANDS\fR .RS 4 .PP \fB\-f\fR, \fB\-\-focus\fR [\fIDESKTOP_SEL\fR] @@ -584,6 +674,11 @@ desktop [\fIDESKTOP_SEL\fR] \fIOPTIONS\fR Focus the selected or given desktop\&. .RE .PP +\fB\-a\fR, \fB\-\-activate\fR [\fIDESKTOP_SEL\fR] +.RS 4 +Activate the selected or given desktop\&. +.RE +.PP \fB\-m\fR, \fB\-\-to\-monitor\fR \fIMONITOR_SEL\fR .RS 4 Send the selected desktop to the given monitor\&. @@ -604,44 +699,14 @@ Rename the selected desktop\&. Swap the selected desktop with the given desktop\&. .RE .PP -\fB\-r\fR, \fB\-\-remove\fR -.RS 4 -Remove the selected desktop\&. -.RE -.PP -\fB\-c\fR, \fB\-\-cancel\-presel\fR -.RS 4 -Cancel the preselection of all the windows of the selected desktop\&. -.RE -.PP -\fB\-F\fR, \fB\-\-flip\fR \fIhorizontal|vertical\fR -.RS 4 -Flip the tree of the selected desktop\&. -.RE -.PP -\fB\-R\fR, \fB\-\-rotate\fR \fI90|270|180\fR -.RS 4 -Rotate the tree of the selected desktop\&. -.RE -.PP -\fB\-E\fR, \fB\-\-equalize\fR -.RS 4 -Reset the split ratios of the tree of the selected desktop\&. -.RE -.PP -\fB\-B\fR, \fB\-\-balance\fR -.RS 4 -Adjust the split ratios of the tree of the selected desktop so that all windows occupy the same area\&. -.RE -.PP -\fB\-C\fR, \fB\-\-circulate\fR forward|backward +\fB\-b\fR, \fB\-\-bubble\fR \fICYCLE_DIR\fR .RS 4 -Circulate the leaves of the tree of the selected desktop\&. +Bubble the selected desktop in the given direction\&. .RE .PP -\fB\-t\fR, \fB\-\-toggle\fR floating[=on|off] +\fB\-r\fR, \fB\-\-remove\fR .RS 4 -Set or toggle the given state for the selected desktop\&. +Remove the selected desktop\&. .RE .RE .SS "Monitor" @@ -654,7 +719,9 @@ Set or toggle the given state for the selected desktop\&. \fBGeneral Syntax\fR .RS 4 .sp -monitor [\fIMONITOR_SEL\fR] \fIOPTIONS\fR +monitor [\fIMONITOR_SEL\fR] \fICOMMANDS\fR +.sp +If \fIMONITOR_SEL\fR is omitted, \fBfocused\fR is assumed\&. .RE .sp .it 1 an-trap @@ -662,7 +729,7 @@ monitor [\fIMONITOR_SEL\fR] \fIOPTIONS\fR .nr an-break-flag 1 .br .ps +1 -\fBOptions\fR +\fBCommands\fR .RS 4 .PP \fB\-f\fR, \fB\-\-focus\fR [\fIMONITOR_SEL\fR] @@ -675,11 +742,6 @@ Focus the selected or given monitor\&. Create desktops with the given names in the selected monitor\&. .RE .PP -\fB\-r\fR, \fB\-\-remove\-desktops\fR \&... -.RS 4 -Remove desktops with the given names\&. -.RE -.PP \fB\-o\fR, \fB\-\-reorder\-desktops\fR \&... .RS 4 Reorder the desktops of the selected monitor to match the given order\&. @@ -687,7 +749,12 @@ Reorder the desktops of the selected monitor to match the given order\&. .PP \fB\-d\fR, \fB\-\-reset\-desktops\fR \&... .RS 4 -Rename, add or remove desktops depending on whether the number of given names is equal, superior or inferior to the number of existing desktops\&. Incidentally reset the settings of the existing desktops\&. +Rename, add or remove desktops depending on whether the number of given names is equal, superior or inferior to the number of existing desktops\&. +.RE +.PP +\fB\-g\fR, \fB\-\-rectangle\fR WxH+X+Y +.RS 4 +Set the rectangle of the selected monitor\&. .RE .PP \fB\-n\fR, \fB\-\-rename\fR @@ -699,6 +766,11 @@ Rename the selected monitor\&. .RS 4 Swap the selected monitor with the given monitor\&. .RE +.PP +\fB\-r\fR, \fB\-\-remove\fR +.RS 4 +Remove the selected monitor\&. +.RE .RE .SS "Query" .sp @@ -710,7 +782,7 @@ Swap the selected monitor with the given monitor\&. \fBGeneral Syntax\fR .RS 4 .sp -query \fIOPTIONS\fR +query \fICOMMANDS\fR [\fIOPTIONS\fR] .RE .sp .it 1 an-trap @@ -718,55 +790,28 @@ query \fIOPTIONS\fR .nr an-break-flag 1 .br .ps +1 -\fBOptions\fR +\fBCommands\fR .RS 4 .PP -\fB\-W\fR, \fB\-\-windows\fR +\fB\-N\fR, \fB\-\-nodes\fR .RS 4 -List matching windows\&. +List the IDs of the matching nodes\&. .RE .PP \fB\-D\fR, \fB\-\-desktops\fR .RS 4 -List matching desktops\&. +List the IDs of the matching desktops\&. .RE .PP \fB\-M\fR, \fB\-\-monitors\fR .RS 4 -List matching monitors\&. +List the IDs of the matching monitors\&. .RE .PP \fB\-T\fR, \fB\-\-tree\fR .RS 4 -Print tree rooted at query\&. -.RE -.PP -\fB\-H\fR, \fB\-\-history\fR -.RS 4 -Print the history as it relates to the query\&. +Print a JSON representation of the matching item\&. .RE -.PP -\fB\-S\fR, \fB\-\-stack\fR -.RS 4 -Print the window stacking order\&. -.RE -.PP -[\fB\-m\fR,\fB\-\-monitor\fR [\fIMONITOR_SEL\fR]] | [\fB\-d\fR,\fB\-\-desktop\fR [\fIDESKTOP_SEL\fR]] | [\fB\-w\fR, \fB\-\-window\fR [\fIWINDOW_SEL\fR]] -.RS 4 -Constrain matches to the selected monitor, desktop or window\&. -.RE -.RE -.SS "Restore" -.sp -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBGeneral Syntax\fR -.RS 4 -.sp -restore \fIOPTIONS\fR .RE .sp .it 1 an-trap @@ -777,22 +822,16 @@ restore \fIOPTIONS\fR \fBOptions\fR .RS 4 .PP -\fB\-T\fR, \fB\-\-tree\fR -.RS 4 -Load the desktop trees from the given file\&. -.RE -.PP -\fB\-H\fR, \fB\-\-history\fR -.RS 4 -Load the focus history from the given file\&. -.RE -.PP -\fB\-S\fR, \fB\-\-stack\fR +\fB\-m\fR,\fB\-\-monitor\fR [\fIMONITOR_SEL\fR], \fB\-d\fR,\fB\-\-desktop\fR [\fIDESKTOP_SEL\fR], \fB\-n\fR, \fB\-\-node\fR [\fINODE_SEL\fR] .RS 4 -Load the window stacking order from the given file\&. +Constrain matches to the selected monitor, desktop or node\&. The descriptor can be omitted for +\fI\-M\fR, +\fI\-D\fR +and +\fI\-N\fR\&. .RE .RE -.SS "Control" +.SS "Wm" .sp .it 1 an-trap .nr an-no-space-flag 1 @@ -802,7 +841,7 @@ Load the window stacking order from the given file\&. \fBGeneral Syntax\fR .RS 4 .sp -control \fIOPTIONS\fR +wm \fICOMMANDS\fR .RE .sp .it 1 an-trap @@ -810,35 +849,40 @@ control \fIOPTIONS\fR .nr an-break-flag 1 .br .ps +1 -\fBOptions\fR +\fBCommands\fR .RS 4 .PP -\fB\-\-adopt\-orphans\fR +\fB\-d\fR, \fB\-\-dump\-state\fR .RS 4 -Manage all the unmanaged windows remaining from a previous session\&. +Dump the current world state on standard output\&. .RE .PP -\fB\-\-toggle\-visibility\fR +\fB\-l\fR, \fB\-\-load\-state\fR .RS 4 -Toggle the visibility of all the windows\&. +Load a world state from the given file\&. .RE .PP -\fB\-\-record\-history\fR on|off +\fB\-a\fR, \fB\-\-add\-monitor\fR WxH+X+Y .RS 4 -Enable or disable the recording of window focus history\&. +Add a monitor for the given name and rectangle\&. .RE .PP -\fB\-\-subscribe\fR +\fB\-o\fR, \fB\-\-adopt\-orphans\fR .RS 4 -Continuously print status informations\&. +Manage all the unmanaged windows remaining from a previous session\&. .RE .PP -\fB\-\-get\-status\fR +\fB\-h\fR, \fB\-\-record\-history\fR on|off .RS 4 -Print the current status informations\&. +Enable or disable the recording of node focus history\&. +.RE +.PP +\fB\-g\fR, \fB\-\-get\-status\fR +.RS 4 +Print the current status information\&. .RE .RE -.SS "Pointer" +.SS "Rule" .sp .it 1 an-trap .nr an-no-space-flag 1 @@ -848,7 +892,7 @@ Print the current status informations\&. \fBGeneral Syntax\fR .RS 4 .sp -pointer \fIOPTIONS\fR +rule \fICOMMANDS\fR .RE .sp .it 1 an-trap @@ -856,25 +900,25 @@ pointer \fIOPTIONS\fR .nr an-break-flag 1 .br .ps +1 -\fBOptions\fR +\fBCommands\fR .RS 4 .PP -\fB\-g\fR, \fB\-\-grab\fR focus|move|resize_side|resize_corner +\fB\-a\fR, \fB\-\-add\fR (|*)[:(|*)] [\fB\-o\fR|\fB\-\-one\-shot\fR] [monitor=MONITOR_SEL|desktop=DESKTOP_SEL|node=NODE_SEL] [state=STATE] [layer=LAYER] [split_dir=DIR] [split_ratio=RATIO] [(hidden|sticky|private|locked|center|follow|manage|focus|border)=(on|off)] .RS 4 -Initiate the given pointer action\&. +Create a new rule\&. .RE .PP -\fB\-t\fR, \fB\-\-track\fR +\fB\-r\fR, \fB\-\-remove\fR ^|head|tail|(|*)[:(|*)]\&... .RS 4 -Pass the pointer root coordinates for the current pointer action\&. +Remove the given rules\&. .RE .PP -\fB\-u\fR, \fB\-\-ungrab\fR +\fB\-l\fR, \fB\-\-list\fR .RS 4 -Terminate the current pointer action\&. +List the rules\&. .RE .RE -.SS "Rule" +.SS "Config" .sp .it 1 an-trap .nr an-no-space-flag 1 @@ -883,34 +927,13 @@ Terminate the current pointer action\&. .ps +1 \fBGeneral Syntax\fR .RS 4 -.sp -rule \fIOPTIONS\fR -.RE -.sp -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBOptions\fR -.RS 4 .PP -\fB\-a\fR, \fB\-\-add\fR ||* [\fB\-o\fR|\fB\-\-one\-shot\fR] [monitor=MONITOR_SEL|desktop=DESKTOP_SEL|window=WINDOW_SEL] [(floating|fullscreen|pseudo_tiled|locked|sticky|private|center|follow|manage|focus)=(true|false)] [split_dir=DIR] +config [\-m \fIMONITOR_SEL\fR|\-d \fIDESKTOP_SEL\fR|\-n \fINODE_SEL\fR] [] .RS 4 -Create a new rule\&. -.RE -.PP -\fB\-r\fR, \fB\-\-remove\fR ^|head|tail|||*\&... -.RS 4 -Remove the given rules\&. -.RE -.PP -\fB\-l\fR, \fB\-\-list\fR [||*] -.RS 4 -List the rules\&. +Get or set the value of \&. .RE .RE -.SS "Config" +.SS "Subscribe" .sp .it 1 an-trap .nr an-no-space-flag 1 @@ -920,9 +943,11 @@ List the rules\&. \fBGeneral Syntax\fR .RS 4 .PP -config [\-m \fIMONITOR_SEL\fR|\-d \fIDESKTOP_SEL\fR|\-w \fIWINDOW_SEL\fR] [] +subscribe (all|report|monitor|desktop|node|\&...)* .RS 4 -Get or set the value of \&. +Continuously print status information\&. See the +\fBEVENTS\fR +section for the detailed description of each event\&. .RE .RE .SS "Quit" @@ -942,215 +967,349 @@ Quit with an optional exit status\&. .RE .SH "EXIT CODES" .sp -If the server can\(cqt handle a message, \fBbspc\fR will return with one of the following exit codes: +If the server can\(cqt handle a message, \fBbspc\fR will return with a non\-zero exit code\&. +.SH "SETTINGS" +.sp +Colors are in the form \fI#RRGGBB\fR, booleans are \fItrue\fR, \fIon\fR, \fIfalse\fR or \fIoff\fR\&. +.sp +All the boolean settings are \fIfalse\fR by default unless stated otherwise\&. +.SS "Global Settings" .PP -1 +\fInormal_border_color\fR .RS 4 -Failure\&. +Color of the border of an unfocused window\&. .RE .PP -2 +\fIactive_border_color\fR .RS 4 -Syntax error\&. +Color of the border of a focused window of an unfocused monitor\&. .RE .PP -3 +\fIfocused_border_color\fR .RS 4 -Unknown command\&. +Color of the border of a focused window of a focused monitor\&. .RE -.SH "SETTINGS" -.sp -Colors are either X color names or \fI#RRGGBB\fR, booleans are \fItrue\fR or \fIfalse\fR\&. -.sp -All the boolean settings are \fIfalse\fR by default\&. -.SS "Global Settings" .PP -\fIfocused_border_color\fR +\fIpresel_feedback_color\fR .RS 4 -Color of the border of a focused window of a focused monitor\&. +Color of the +\fBnode \-\-presel\-{dir,ratio}\fR +message feedback area\&. .RE .PP -\fIactive_border_color\fR +\fIsplit_ratio\fR .RS 4 -Color of the border of a focused window of an unfocused monitor\&. +Default split ratio\&. .RE .PP -\fInormal_border_color\fR +\fIstatus_prefix\fR .RS 4 -Color of the border of an unfocused window\&. +Prefix prepended to each of the status lines\&. .RE .PP -\fIpresel_border_color\fR +\fIexternal_rules_command\fR .RS 4 -Color of the -\fBpresel\fR -message feedback\&. +External command used to retrieve rule consequences\&. The command will receive the the ID of the window being processed as its first argument and the class and instance names as second and third arguments\&. The output of that command must have the following format: +\fBkey1=value1 key2=value2 \&...\fR +(the valid key/value pairs are given in the description of the +\fIrule\fR +command)\&. .RE .PP -\fIfocused_locked_border_color\fR +\fIinitial_polarity\fR .RS 4 -Color of the border of a focused locked window of a focused monitor\&. +On which child should a new window be attached when adding a window on a single window tree in automatic mode\&. Accept the following values: +\fBfirst_child\fR, +\fBsecond_child\fR\&. .RE .PP -\fIactive_locked_border_color\fR +\fIborderless_monocle\fR .RS 4 -Color of the border of a focused locked window of an unfocused monitor\&. +Remove borders of tiled windows for the +\fBmonocle\fR +desktop layout\&. .RE .PP -\fInormal_locked_border_color\fR +\fIgapless_monocle\fR .RS 4 -Color of the border of an unfocused locked window\&. +Remove gaps of tiled windows for the +\fBmonocle\fR +desktop layout\&. .RE .PP -\fIfocused_sticky_border_color\fR +\fIpaddingless_monocle\fR .RS 4 -Color of the border of a focused sticky window of a focused monitor\&. +Remove padding space for the +\fBmonocle\fR +desktop layout\&. .RE .PP -\fIactive_sticky_border_color\fR +\fIsingle_monocle\fR .RS 4 -Color of the border of a focused sticky window of an unfocused monitor\&. +Set the desktop layout to +\fBmonocle\fR +if there\(cqs only one tiled window in the tree\&. .RE .PP -\fInormal_sticky_border_color\fR +\fIpointer_modifier\fR .RS 4 -Color of the border of an unfocused sticky window\&. +Keyboard modifier used for moving or resizing windows\&. Accept the following values: +\fBshift\fR, +\fBcontrol\fR, +\fBlock\fR, +\fBmod1\fR, +\fBmod2\fR, +\fBmod3\fR, +\fBmod4\fR, +\fBmod5\fR\&. .RE .PP -\fIfocused_private_border_color\fR +\fIpointer_action1\fR, \fIpointer_action2\fR, \fIpointer_action3\fR .RS 4 -Color of the border of a focused private window of a focused monitor\&. +Action performed when pressing +\fIpointer_modifier\fR ++ +\fIbutton\fR\&. Accept the following values: +\fBmove\fR, +\fBresize_side\fR, +\fBresize_corner\fR, +\fBfocus\fR\&. .RE .PP -\fIactive_private_border_color\fR +\fIclick_to_focus\fR .RS 4 -Color of the border of a focused private window of an unfocused monitor\&. +Focus a window (or a monitor) by clicking it\&. .RE .PP -\fInormal_private_border_color\fR +\fIfocus_follows_pointer\fR .RS 4 -Color of the border of an unfocused private window\&. +Focus the window under the pointer\&. .RE .PP -\fIurgent_border_color\fR +\fIpointer_follows_focus\fR .RS 4 -Color of the border of an urgent window\&. +When focusing a window, put the pointer at its center\&. .RE .PP -\fIsplit_ratio\fR +\fIpointer_follows_monitor\fR .RS 4 -Default split ratio\&. +When focusing a monitor, put the pointer at its center\&. .RE .PP -\fIstatus_prefix\fR +\fIignore_ewmh_focus\fR .RS 4 -Prefix prepended to each of the status lines\&. +Ignore EWMH focus requests coming from applications\&. .RE .PP -\fIexternal_rules_command\fR +\fIcenter_pseudo_tiled\fR .RS 4 -External command used to retrieve rule consequences\&. The command will receive the the ID of the window being processed as its first argument and the class and instance names as second and third arguments\&. The output of that command must have the following format: -\fBkey1=value1 key2=value2 \&...\fR -(the valid key/value pairs are given in the description of the -\fIrule\fR -command)\&. +Center pseudo tiled windows into their tiling rectangles\&. Defaults to +\fItrue\fR\&. .RE .PP -\fIhistory_aware_focus\fR +\fIhonor_size_hints\fR .RS 4 -Give priority to the focus history when focusing nodes\&. +Apply ICCCM window size hints\&. .RE .PP -\fIfocus_by_distance\fR +\fIremove_disabled_monitors\fR .RS 4 -Base focusing on distances between windows\&. +Consider disabled monitors as disconnected\&. .RE .PP -\fIborderless_monocle\fR +\fIremove_unplugged_monitors\fR .RS 4 -Remove borders for tiled windows in monocle mode\&. +Remove unplugged monitors\&. .RE .PP -\fIgapless_monocle\fR +\fImerge_overlapping_monitors\fR .RS 4 -Remove gaps for tiled windows in monocle mode\&. +Merge overlapping monitors (the bigger remains)\&. .RE +.SS "Monitor and Desktop Settings" .PP -\fIfocus_follows_pointer\fR +\fItop_padding\fR, \fIright_padding\fR, \fIbottom_padding\fR, \fIleft_padding\fR .RS 4 -Focus the window under the pointer\&. +Padding space added at the sides of the monitor or desktop\&. .RE +.SS "Desktop Settings" .PP -\fIpointer_follows_monitor\fR +\fIwindow_gap\fR .RS 4 -When focusing a monitor, put the pointer at its center\&. +Size of the gap that separates windows\&. .RE +.SS "Node Settings" .PP -\fIauto_alternate\fR +\fIborder_width\fR .RS 4 -Interpret two consecutive identical -\fBuse\fR -messages as an -\fBalternate\fR -message\&. +Window border width\&. .RE +.SH "POINTER BINDINGS" .PP -\fIauto_cancel\fR +\fIbutton1\fR .RS 4 -Interpret two consecutive identical -\fBpresel\fR -messages as a -\fBcancel\fR -message\&. +Focus the window under the pointer if +\fIclick_to_focus\fR +is set\&. .RE .PP -\fIapply_floating_atom\fR +\fIpointer_modifier\fR + \fIbutton1\fR .RS 4 -Set the value of the -\fI_BSPWM_FLOATING_WINDOW\fR -atom of each window according to its floating state\&. +Move the window under the pointer\&. .RE .PP -\fIignore_ewmh_focus\fR +\fIpointer_modifier\fR + \fIbutton2\fR .RS 4 -Ignore EWMH focus requests coming from applications\&. +Resize the window under the pointer by dragging the nearest side\&. .RE .PP -\fIremove_disabled_monitors\fR +\fIpointer_modifier\fR + \fIbutton3\fR .RS 4 -Consider disabled monitors as disconnected\&. +Resize the window under the pointer by dragging the nearest corner\&. .RE +.sp +The behavior of \fIpointer_modifier\fR + \fIbutton\fR can be modified through the \fIpointer_action\fR setting\&. +.SH "EVENTS" .PP -\fIremove_unplugged_monitors\fR +\fIreport\fR .RS 4 -Remove unplugged monitors\&. +See the next section for the description of the format\&. .RE .PP -\fImerge_overlapping_monitors\fR +\fImonitor_add \fR .RS 4 -Merge overlapping monitors (the bigger remains)\&. +A monitor is added\&. .RE -.SS "Monitor and Desktop Settings" .PP -\fItop_padding\fR, \fIright_padding\fR, \fIbottom_padding\fR, \fIleft_padding\fR +\fImonitor_rename \fR .RS 4 -Padding space added at the sides of the monitor or desktop\&. +A monitor is renamed\&. .RE -.SS "Default, Desktop Default and Window Settings" .PP -\fIborder_width\fR +\fImonitor_remove \fR .RS 4 -Window border width\&. +A monitor is removed\&. .RE -.SS "Default and Desktop Settings" .PP -\fIwindow_gap\fR +\fImonitor_swap \fR .RS 4 -Size of the gap that separates windows\&. +A monitor is swapped\&. +.RE +.PP +\fImonitor_focus \fR +.RS 4 +A monitor is focused\&. +.RE +.PP +\fImonitor_geometry \fR +.RS 4 +The geometry of a monitor changed\&. +.RE +.PP +\fIdesktop_add \fR +.RS 4 +A desktop is added\&. +.RE +.PP +\fIdesktop_rename \fR +.RS 4 +A desktop is renamed\&. +.RE +.PP +\fIdesktop_remove \fR +.RS 4 +A desktop is removed\&. +.RE +.PP +\fIdesktop_swap \fR +.RS 4 +A desktop is swapped\&. +.RE +.PP +\fIdesktop_transfer \fR +.RS 4 +A desktop is transferred\&. +.RE +.PP +\fIdesktop_focus \fR +.RS 4 +A desktop is focused\&. +.RE +.PP +\fIdesktop_activate \fR +.RS 4 +A desktop is activated\&. +.RE +.PP +\fIdesktop_layout tiled|monocle\fR +.RS 4 +The layout of a desktop changed\&. +.RE +.PP +\fInode_manage \fR +.RS 4 +A window is managed\&. +.RE +.PP +\fInode_unmanage \fR +.RS 4 +A window is unmanaged\&. +.RE +.PP +\fInode_swap \fR +.RS 4 +A node is swapped\&. +.RE +.PP +\fInode_transfer \fR +.RS 4 +A node is transferred\&. +.RE +.PP +\fInode_focus \fR +.RS 4 +A node is focused\&. +.RE +.PP +\fInode_activate \fR +.RS 4 +A node is activated\&. +.RE +.PP +\fInode_presel (dir DIR|ratio RATIO|cancel)\fR +.RS 4 +A node is preselected\&. +.RE +.PP +\fInode_stack below|above \fR +.RS 4 +A node is stacked below or above another node\&. +.RE +.PP +\fInode_geometry \fR +.RS 4 +The geometry of a window changed\&. +.RE +.PP +\fInode_state tiled|pseudo_tiled|floating|fullscreen on|off\fR +.RS 4 +The state of a window changed\&. +.RE +.PP +\fInode_flag hidden|sticky|private|locked|urgent on|off\fR +.RS 4 +One of the flags of a node changed\&. +.RE +.PP +\fInode_layer below|normal|above\fR +.RS 4 +The layer of a window changed\&. .RE -.SH "STATUS FORMAT" .sp -Status informations are composed of items separated by colons\&. +Please note that \fBbspwm\fR initializes monitors before it reads messages on its socket, therefore the initial monitor events can\(cqt be received\&. +.SH "REPORT FORMAT" +.sp +Each report event message is composed of items separated by colons\&. .sp Each item has the form \fI\fR where \fI\fR is the first character of the item\&. .PP @@ -1194,9 +1353,19 @@ Urgent focused desktop\&. Urgent unfocused desktop\&. .RE .PP -\fIL(tiled|monocle)\fR +\fIL(T|M)\fR .RS 4 -Layout of the focused desktop of the focused monitor\&. +Layout of the focused desktop of a monitor\&. +.RE +.PP +\fIT(T|P|F|=|@)\fR +.RS 4 +State of the focused node of a focused desktop\&. +.RE +.PP +\fIG(S?P?L?)\fR +.RS 4 +Active flags of the focused node of a focused desktop\&. .RE .SH "ENVIRONMENT VARIABLES" .PP @@ -1206,82 +1375,7 @@ The path of the socket used for the communication between \fBbspc\fR and \fBbspwm\fR\&. If it isn\(cqt defined, then the following path is used: -\fI/tmp/bspwm\-socket\fR\&. -.RE -.SH "PANELS" -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -Any EWMH compliant panel (e\&.g\&.: -\fItint2\fR, -\fIbmpanel2\fR, etc\&.)\&. -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -A custom panel if the -\fI\-s\fR -flag is used (have a look at the files in -\fIexamples/panel\fR)\&. -.RE -.SH "KEY FEATURES" -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -Configured and controlled through messages\&. -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -Multiple monitors support (via -\fIRandR\fR)\&. -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -EWMH support (\fBtint2\fR -works)\&. -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -Hybrid tiling\&. +\fI/tmp/bspwm__\-socket\fR\&. .RE .SH "CONTRIBUTORS" .sp @@ -1320,6 +1414,3 @@ Ivan Kanakarakis .SH "AUTHOR" .sp Bastien Dejean -.SH "MAILING LIST" -.sp -bspwm at librelist\&.com