2 ┌──────────────────────────────┐
3 │ Release notes for i3 v4.3 │
4 └──────────────────────────────┘
6 This is the third release of the new major version of i3, v4.3. It is
7 considered stable. All users of i3 are strongly encouraged to upgrade.
9 One of the most visible changes is probably that commands which lead to an
10 error will now spawn i3-nagbar. This will make you immediately aware of
11 problems such as typos in your configuration file (such as "bindsym $mod+x exc
12 firefox" instead of "exec"). This is not restricted to parser errors, but all
13 errors (such as when trying to move a window to another workspace without
14 actually having a window focused). If this is annoying to you for some specific
15 key configuration, you can turn it off by replacing a binding like:
16 bindsym $mod+x move absolute position center
17 with something like this:
18 bindsym $mod+x exec --no-startup-id i3-msg move absolute position center >/dev/null 2>&1
19 (Yes, this is somewhat painful, but intended. You should not suppress errors in
20 general, so we don’t want to make it too easy.)
23 We also made the orientation (horizontal/vertical) part of the layout
24 mechanism: Before, we got the default layout and you could change
25 orientation. Now, there are two new layouts "splitv" and "splith", which
26 replace the default layout. The "split h" and "split v" commands continue to
27 work as before, they split the current container and you will end up in a
28 split container with layout splith (after "split h") or splitv (after "split
31 To change a splith container into a splitv container, use either "layout
32 splitv" or "layout toggle split". The latter command is used in the
33 default config as mod+l (previously "layout default"). In case you have
34 "layout default" in your config file, it is recommended to just replace
35 it by "layout toggle split", which will work as "layout default" did
36 before when pressing it once, but toggle between horizontal/vertical
37 when pressing it repeatedly.
39 The rationale behind this commit is that it’s cleaner to have all
40 parameters that influence how windows are rendered in the layout itself
41 rather than having a special parameter in combination with only one
42 layout. This enables us to change existing split containers in all cases
43 without breaking existing features (see ticket #464). Also, users should
44 feel more confident about whether they are actually splitting or just
45 changing an existing split container now.
47 As a nice side-effect, this commit brings back the "layout toggle"
48 feature we once had in i3 version 3 (see the userguide).
51 Another very important change is that we now support pango for rendering text.
52 The default is still to use misc-fixed (X core fonts), but you can use a font
53 specification starting with "xft:" now, such as "xft:DejaVu Sans Mono 10" and
54 i3 will use pango. The sole motivation for this is NOT to have fancier window
55 decorations, but to support fonts which have more glyphs (think Japanese for
56 example) and to support right-to-left rendering (open http://www.ftpal.net/
57 for an example). Supporting users from all over the planet is important, and
58 as such I would strongly advise distribution packagers to leave pango support
59 in. In case you are working on a very low-spec embedded device, it is easy
60 enough to disable pango support, see common.mk.
62 ┌────────────────────────────┐
64 └────────────────────────────┘
66 • docs/refcard: update for v4
67 • docs/userguide: clarify the default for focus_follows_mouse and new_window
68 • docs/userguide: add section about implicit containers
69 • docs/ipc: document the 'window' field in the GET_TREE reply
70 • docs/ipc: update links to ipc libraries
71 • docs/ipc: make the reply sections consistent
72 • docs/i3bar-protocol: add example (illustration-only!) shell script
73 • man/i3bar.man: reference i3bar-protocol
74 • IPC: Commands now lead to proper error messages in general. If we forgot
75 about a specific one, please open a ticket.
76 • IPC: implement GET_VERSION to find out the i3 version
77 • i3-dump-log now comes with a massively more helpful error message that
78 should cover all the use cases.
79 • 'workspace number <number>' now opens a new workspace
80 • 'workspace number <number>' now works with the back_and_forth option
81 • Allow focus with target (criteria) when in fullscreen mode in some cases
82 • Allow focus child/parent when in fullscreen mode
83 • Restrict directional focus when in fullscreen mode
84 • Prevent moving out of fullscreen containers
85 • Add 'move to workspace current' (useful when used with criteria)
86 • replace loglevels by a global debug logging
87 • make: new makefile layout
88 • make: canonicalize path when compiling. This leads to sth like
89 ../i3-4.2/src/main.c in backtraces, clearly identifying i3 code.
90 • automatically hide i3bar when it’s unneeded (after urgency hints)
91 • i3-config-wizard: use the level 0 keysym whenever it’s unambiguous
92 • i3-nagbar: use custom scripts to work around different terminal emulators
93 using different ways of interpreting the arguments to -e
94 • i3-sensible-terminal: add xfce4-terminal
95 • default config: require confirmation when exiting i3
96 • Display i3-nagbar when a command leads to an error.
97 • testcases: complete-run now supports --xtrace
98 • testcases: handle EAGAIN (fixes hangs)
99 • testcases: handle test bailouts
100 • Introduce splith/splitv layouts, remove orientation
101 • Implement hide_edge_borders option
102 • Support _NET_ACTIVE_WINDOW ClientMessages
103 • Set I3_PID atom on the X11 root window
104 • Implement i3 --moreversion, handy for figuring out whether you run the
105 latest binary which is installed.
106 • i3bar: be less strict about the {"version":1} JSON header
107 • shm-logging: implement i3-dump-log -f (follow)
108 • Implement pango support
110 ┌────────────────────────────┐
112 └────────────────────────────┘
114 • Fix floating precision bug when floating windows are moved between outputs.
115 • i3bar won’t crash when full_text is missing or null in the JSON input
116 • When having "workspace number 1" in your config, there will no longer be a
117 stray workspace "number 1".
118 • i3.config.keycodes used bindsym instead of bindcode for the arrow key
119 resizing bindings by mistake
120 • Fix 'move to workspace' when used with criteria
121 • Handle clicks to the very left edge of i3bar
122 • When using i3 -C, don’t send remaining arguments as an IPC command
123 • Fix reload crashes in rare cases
124 • i3bar: inform all clients of new tray selection owner (fixes tray problems
125 with X-Chat and possibly others)
126 • resizing: traverse containers up properly (fixes non-working resizing when
127 having a h-split within a h-split for example)
128 • Fix floating coordinates when moving assigned workspaces
129 • Properly fix floating coordinates when disabling outputs
130 • floating_fix_coordinates: properly deal with negative positions
131 • floating windows: add deco_height only when in normal border mode (fixes
132 initial floating window position/size when using a different default border
134 • Fix moving scratchpad window
135 • Cleanup zero-byte logfile on immediate exit (they are created by i3
136 --get-socketpath for example).
138 ┌────────────────────────────┐
140 └────────────────────────────┘
142 Thanks for testing, bugfixes, discussions and everything I forgot go out to:
144 aksr, Axel Wagner, darkraven, David Coppa, eeemsi, Felicitus, Fernando Tarlá
145 Cardoso Lemos, Iakov Davydov, jh, Julius Plenz, Marcel Hellwig, Marcus,
146 Michael Stapelberg, mloskot, Moritz Bandemer, oblique, Ondrej Grover, Pavel
147 Löbl, Philipp Middendorf, prg, Quentin Glidic, somelauw, stfn, tucos,
148 TunnelWicht, Valentin Haenel
150 -- Michael Stapelberg, 2012-08-18