Version 0.9.1

diff --git a/Makefile b/Makefile
index 9771e8432b24cc96bc7638bbcc4bf4435a03e30a..57939ad8c6ee9b6014cdfe42397836677ac7e558 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -11,7 +11,7 @@ DOCPREFIX ?= $(PREFIX)/share/doc/bspwm
 BASHCPL   ?= $(PREFIX)/share/bash-completion/completions
 ZSHCPL    ?= $(PREFIX)/share/zsh/site-functions
 
-MD_DOCS = README.md doc/CONTRIBUTING.md doc/INSTALL.md doc/MISC.md doc/TODO.md
+MD_DOCS = README.md doc/CHANGELOG.md doc/CONTRIBUTING.md doc/INSTALL.md doc/MISC.md doc/TODO.md
 XSESSIONS ?= $(PREFIX)/share/xsessions
 
 WM_SRC = bspwm.c helpers.c geometry.c jsmn.c settings.c monitor.c desktop.c tree.c stack.c history.c \

diff --git a/VERSION b/VERSION
index 9a7d84f2a96bb56f53bfc3a42ac10d06459e55c3..f514a2f0bd053cdaebb7ab7bcffca86fed32620a 100644 (file)
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.9
\ No newline at end of file
+0.9.1
\ No newline at end of file

diff --git a/doc/CHANGELOG.md b/doc/CHANGELOG.md
new file mode 100644 (file)
index 0000000..c0db1a5
--- /dev/null
+++ b/doc/CHANGELOG.md
@@ -0,0 +1,86 @@
+# 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`| `node @DESKTOP_SEL:/ -C forward|backward`
+`desktop DESKTOP_SEL --cancel-presel`    | `bspc query -N -d DESKTOP_SEL | xargs -I id -n 1 bspc node id -p cancel`
+`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`