bspwm/doc/CHANGELOG.md

From 0.9.2 to 0.9.3

Changes

• click_to_focus is now a button name. Specifying a boolean is deprecated but will still work (true is equivalent to button1).

Additions

• node -r now accepts a relative fraction argument.
• An option was added to query -{M,D,N} in order to output names instead of IDs: --names.
• New rule consequence: rectangle=WxH+X+Y.
• New settings: swallow_first_click and directional_focus_tightness.

From 0.9.1 to 0.9.2

Changes

• Monitors, desktops and nodes have unique IDs, bspc query -{N,D,M} returns IDs and events reference objects by ID instead of name.
• bspc fails verbosely and only returns a single non-zero exit code.
• The DIR descriptor is based on right-window.
• The CYCLE_DIR descriptor isn't limited to the current desktop/monitor anymore. (You can emulate the previous behavior by appending a .local modifier to the selector.)
• bspc query -{N,D,M} accepts an optional reference argument used by certain descriptors/modifiers.
• Monitors are ordered visually by default.
• The following settings: border_width, window_gap and *_padding behave as expected.
• External rules also receives the monitor, desktop and node selectors computed from the built-in rules stage as subsequent arguments.
• The focus_follows_pointer setting is implemented via enter notify events.

Additions

• Nodes can be hidden/shown via the new hidden flag.
• Node receptacles can be inserted with node -i. An example is given in git show e8aa679.
• Non-tiled nodes can be moved/resized via node -{v,z}.
• The reference of a selector can be set via the {NODE,DESKTOP,MONITOR}_SEL# prefix, example: bspc node 0x0080000c#south -c will close the node at the south of 0x0080000c.
• Node descriptors: <node_id>, pointed.
• Node modifiers: hidden, descendant_of, ancestor_of, window, active. Example: bspc query -N 0x00400006 -n .descendant_of returns the descendants of 0x00400006.
• Desktop descriptor: <desktop_id>.
• Monitor descriptor: <monitor_id>.
• Settings: pointer_motion_interval, pointer_modifier, pointer_action{1,2,3}, click_to_focus, honor_size_hints.
• Event: pointer_action.
• ICCCM/EWMH atoms: WM_STATE, _NET_WM_STRUT_PARTIAL.
• bspc shell completions for fish.

Removals

• The pointer domain. Pointer actions are handled internally. You need to remove any binding that uses this domain from your sxhkdrc.
• Settings: history_aware_focus, focus_by_distance. Both settings are merged into the new DIR implementation.
• monitor -r|--remove-desktops: use desktop -r|--remove instead.
• wm -r|--remove-monitor: use monitor -r|--remove instead.

From 0.9 to 0.9.1

Overview

All the commands that acted on leaves can now be applied on internal nodes (including focusing and preselection). Consequently, the window domain is now a node domain. Please note that some commands are applied to the leaves of the tree rooted at the selected node and not to the node itself.

Changes

• All the commands that started with window now start with node.
• -W|--windows, -w|--window, -w|--to-window are now -N|--nodes, -n|--node, -n|--to-node.
• We now use cardinal directions: west,south,north,east instead of left,down,up,right (in fact the latter is just plain wrong: the up,down axis is perpendicular to the screen).
• The WINDOW_SEL becomes NODE_SEL and now contains a PATH specifier to select internal nodes.
• The control domain is renamed to wm.
• restore -{T,H,S} was unified into wm -l|--load-state and query -{T,H,S} into wm -d|--dump-state.
• control --subscribe becomes subscribe.
• node --toggle (previously window --toggle) is split into node --state and node --flag.
• The preselection direction (resp. ratio) is now set with node --presel-dir|-p (resp. node --presel-ratio|-o).
• The following desktop commands: --rotate, --flip, --balance, --equalize, --circulate are now node commands.
• query -T ... outputs JSON.
• query -{M,D,N}: the descriptor part of the selector is now optional (e.g.: query -D -d .urgent).
• Many new modifiers were added, some were renamed. The opposite of a modifier is now expressed with the ! prefix (e.g.: like becomes same_class, unlike becomes !same_class, etc.).
• Modifiers can now be applied to any descriptor (e.g.: query -N -n 0x80000d.floating).
• wm -l (previously restore -T) will now destroy the existing tree and restore from scratch instead of relying on existing monitors and desktops.
• subscribe (previously control --subscribe) now accepts arguments and can receive numerous events from different domains (see the EVENTS section of the manual).
• rule -a: it is now possible to specify the class name and instance name (e.g.: rule -a Foo:bar).
• presel_border_color is now presel_feedback_color.
• bspwm -v yields an accurate version.
• The monitors are sorted, by default, according to the natural visual hierarchy.

Additions

Settings

• single_monocle.
• paddingless_monocle.

Commands

• {node,desktop} --activate.
• node --layer.
• desktop --bubble.
• wm {--add-monitor,--remove-monitor}.
• monitor --rectangle.

Removals

Commands

• desktop --toggle
• desktop --cancel-presel
• control --toggle-visibility.

Settings

• apply_floating_atom.
• auto_alternate.
• auto_cancel.
• focused_locked_border_color
• active_locked_border_color
• normal_locked_border_color
• focused_sticky_border_color
• active_sticky_border_color
• normal_sticky_border_color
• focused_private_border_color
• active_private_border_color
• normal_private_border_color
• urgent_border_color

Message Translation Guide

0.9	0.9.1
{left,down,up,right}	{west,south,north,east}
window -r	node -o (node -r also exists)
window -e DIR RATIO	node @DIR -r RATIO
window -R DIR DEG	node @DIR -R DEG
window -w	node -n
desktop DESKTOP_SEL -R DEG	node @DESKTOP_SEL:/ -R DEG
desktop DESKTOP_SEL -E	node @DESKTOP_SEL:/ -E
desktop DESKTOP_SEL -B	node @DESKTOP_SEL:/ -B
`desktop DESKTOP_SEL -C forward	backward`
desktop DESKTOP_SEL --cancel-presel	`bspc query -N -d DESKTOP_SEL
window -t floating	node -t ~floating
query -W -w	query -N -n .leaf
query -{T,H,S}	wm -d
restore -{T,H,S}	wm -l