doc/CHANGELOG.md

   1 # From 0.9.6 to 0.9.7
   2
   3 This release fixes a bug in the behavior of `single_monocle`.
   4
   5 # From 0.9.4 to 0.9.6
   6
   7 ## Additions
   8
   9 - New *wm* command: `--restart`. It was already possible to restart `bspwm` without loosing the current state through `--{dump,load}-state`, but this command will also keep the existing subscribers intact.
  10 - New settings: `automatic_scheme`, `removal_adjustment`. The automatic insertion mode now provides three ways of inserting a new node: `spiral`, `longest_side` (the default) and `alternate`. Those schemes are described in the README.
  11 - New settings: `ignore_ewmh_struts`, `presel_feedback`, `{top,right,bottom,left}_monocle_padding`.
  12 - New node descriptor: `smallest`.
  13 - New desktop modifier: `active`.
  14
  15 ## Changes
  16
  17 - The `focused` and `active` modifiers now mean the same thing across every object.
  18 - Fullscreen windows are no longer sent to the `above` layer. Within the same layer, fullscreen windows are now above floating windows. If you want a floating window to be above a fullscreen window, you'll need to rely on layers.
  19 - Pseudo-tiled windows now shrink automatically.
  20
  21 ## Removals
  22
  23 - The `paddingless_monocle` setting was removed (and subsumed). The effect of `paddingless_monocle` can now be achieved with:
  24 ```shell
  25 for side in top right bottom left; do
  26         bspc config ${side}_monocle_padding -$(bspc config ${side}_padding)
  27 done
  28 ```
  29
  30 # From 0.9.3 to 0.9.4
  31
  32 ## Changes
  33
  34 - The following events: `node_{manage,unmanage}` are now `node_{add,remove}`.
  35
  36 ## Additions
  37
  38 - New monitor/desktop/node descriptors: `any`, `newest`.
  39 - New node flag: `marked`.
  40 - New monitor descriptor: `pointed`.
  41 - New *wm* command: `--reorder-monitors`.
  42 - Receptacles are now described in the manual.
  43 - New `--follow` option added to `node -{m,d,n,s}` and `desktop -{m,s}`.
  44 - The *subscribe* command now has the following options: `--fifo`, `--count`.
  45 - New settings: `ignore_ewmh_fullscreen`, `mapping_events_count`.
  46
  47 # From 0.9.2 to 0.9.3
  48
  49 ## Changes
  50
  51 - *click_to_focus* is now a button name. Specifying a boolean is deprecated but will still work (`true` is equivalent to `button1`).
  52
  53 ## Additions
  54
  55 - `node -r` now accepts a relative fraction argument.
  56 - An option was added to `query -{M,D,N}` in order to output names instead of IDs: `--names`.
  57 - New rule consequence: `rectangle=WxH+X+Y`.
  58 - New settings: `swallow_first_click` and `directional_focus_tightness`.
  59
  60 # From 0.9.1 to 0.9.2
  61
  62 ## Changes
  63
  64 - Monitors, desktops and nodes have unique IDs, `bspc query -{N,D,M}` returns IDs and events reference objects by ID instead of name.
  65 - `bspc` fails verbosely and only returns a single non-zero exit code.
  66 - The `DIR` descriptor is based on [right-window](https://github.com/ntrrgc/right-window).
  67 - 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.)
  68 - `bspc query -{N,D,M}` accepts an optional reference argument used by certain descriptors/modifiers.
  69 - Monitors are ordered visually by default.
  70 - The following settings: `border_width`, `window_gap` and `*_padding` behave as expected.
  71 - External rules also receives the monitor, desktop and node selectors computed from the built-in rules stage as subsequent arguments.
  72 - The `focus_follows_pointer` setting is implemented via enter notify events.
  73
  74 ## Additions
  75
  76 - Nodes can be hidden/shown via the new `hidden` flag.
  77 - Node receptacles can be inserted with `node -i`. An example is given in `git show e8aa679`.
  78 - Non-tiled nodes can be moved/resized via `node -{v,z}`.
  79 - 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`.
  80 - Node descriptors: `<node_id>`, `pointed`.
  81 - Node modifiers: `hidden`, `descendant_of`, `ancestor_of`, `window`, `active`. Example: `bspc query -N 0x00400006 -n .descendant_of` returns the descendants of `0x00400006`.
  82 - Desktop descriptor: `<desktop_id>`.
  83 - Monitor descriptor: `<monitor_id>`.
  84 - Settings: `pointer_motion_interval`, `pointer_modifier`, `pointer_action{1,2,3}`, `click_to_focus`, `honor_size_hints`.
  85 - Event: `pointer_action`.
  86 - ICCCM/EWMH atoms: `WM_STATE`, `_NET_WM_STRUT_PARTIAL`.
  87 - `bspc` shell completions for `fish`.
  88
  89 ## Removals
  90
  91 - The `pointer` domain. Pointer actions are handled internally. You need to remove any binding that uses this domain from your `sxhkdrc`.
  92 - Settings: `history_aware_focus`, `focus_by_distance`. Both settings are merged into the new `DIR` implementation.
  93 - `monitor -r|--remove-desktops`: use `desktop -r|--remove` instead.
  94 - `wm -r|--remove-monitor`: use `monitor -r|--remove` instead.
  95
  96 # From 0.9 to 0.9.1
  97
  98 ## Overview
  99
 100 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.
 101
 102 ## Changes
 103
 104 - All the commands that started with `window` now start with `node`.
 105 - `-W|--windows`, `-w|--window`, `-w|--to-window` are now `-N|--nodes`, `-n|--node`, `-n|--to-node`.
 106 - 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).
 107 - The `WINDOW_SEL` becomes `NODE_SEL` and now contains a `PATH` specifier to select internal nodes.
 108 - The `control` domain is renamed to `wm`.
 109 - `restore -{T,H,S}` was unified into `wm -l|--load-state` and `query -{T,H,S}` into `wm -d|--dump-state`.
 110 - `control --subscribe` becomes `subscribe`.
 111 - `node --toggle` (previously `window --toggle`) is split into `node --state` and `node --flag`.
 112 - The preselection direction (resp. ratio) is now set with `node --presel-dir|-p` (resp. `node --presel-ratio|-o`).
 113 - The following desktop commands: `--rotate`, `--flip`, `--balance`, `--equalize`, `--circulate` are now node commands.
 114 - `query -T ...` outputs JSON.
 115 - `query -{M,D,N}`: the descriptor part of the selector is now optional (e.g.: `query -D -d .urgent`).
 116 - 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.).
 117 - Modifiers can now be applied to any descriptor (e.g.: `query -N -n 0x80000d.floating`).
 118 - `wm -l` (previously `restore -T`) will now destroy the existing tree and restore from scratch instead of relying on existing monitors and desktops.
 119 - `subscribe` (previously `control --subscribe`) now accepts arguments and can receive numerous events from different domains (see the *EVENTS* section of the manual).
 120 - `rule -a`: it is now possible to specify the class name *and* instance name (e.g.: `rule -a Foo:bar`).
 121 - `presel_border_color` is now `presel_feedback_color`.
 122 - `bspwm -v` yields an accurate version.
 123 - The monitors are sorted, by default, according to the natural visual hierarchy.
 124
 125 ## Additions
 126
 127 ### Settings
 128
 129 - `single_monocle`.
 130 - `paddingless_monocle`.
 131
 132 ### Commands
 133
 134 - `{node,desktop} --activate`.
 135 - `node --layer`.
 136 - `desktop --bubble`.
 137 - `wm {--add-monitor,--remove-monitor}`.
 138 - `monitor --rectangle`.
 139
 140 ## Removals
 141
 142 ### Commands
 143
 144 - `desktop --toggle`
 145 - `desktop --cancel-presel`
 146 - `control --toggle-visibility`.
 147
 148 ### Settings
 149
 150 - `apply_floating_atom`.
 151 - `auto_alternate`.
 152 - `auto_cancel`.
 153 - `focused_locked_border_color`
 154 - `active_locked_border_color`
 155 - `normal_locked_border_color`
 156 - `focused_sticky_border_color`
 157 - `active_sticky_border_color`
 158 - `normal_sticky_border_color`
 159 - `focused_private_border_color`
 160 - `active_private_border_color`
 161 - `normal_private_border_color`
 162 - `urgent_border_color`
 163
 164 ## Message Translation Guide
 165
 166 0.9                                      | 0.9.1
 167 -----------------------------------------|----------------------------------
 168 `{left,down,up,right}`                   | `{west,south,north,east}`
 169 `window -r`                              | `node -o` (`node -r` also exists)
 170 `window -e DIR RATIO`                    | `node @DIR -r RATIO`
 171 `window -R DIR DEG`                      | `node @DIR -R DEG`
 172 `window -w`                              | `node -n`
 173 `desktop DESKTOP_SEL -R DEG`             | `node @DESKTOP_SEL:/ -R DEG`
 174 `desktop DESKTOP_SEL -E`                 | `node @DESKTOP_SEL:/ -E`
 175 `desktop DESKTOP_SEL -B`                 | `node @DESKTOP_SEL:/ -B`
 176 `desktop DESKTOP_SEL -C forward|backward`| `node @DESKTOP_SEL:/ -C forward|backward`
 177 `desktop DESKTOP_SEL --cancel-presel`    | `bspc query -N -d DESKTOP_SEL | xargs -I id -n 1 bspc node id -p cancel`
 178 `window -t floating`                     | `node -t ~floating`
 179 `query -W -w`                            | `query -N -n .leaf`
 180 `query -{T,H,S}`                         | `wm -d`
 181 `restore -{T,H,S}`                       | `wm -l`