git.sur5r.net Git - i3/i3/blob - RELEASE-NOTES-4.0

   1
   2  ┌────────────────────────────┐
   3  │ Release notes for i3 v4.0  │
   4  └────────────────────────────┘
   5
   6 This is the first release of the new major version of i3, v4.0. It has been a
   7 long time since v3.ε was released (over one year). A lot has been happening
   8 since then, we made 736 commits – compare that to the total number of 1664
   9 commits for i3.
  10
  11 The reason for the high number of commits and long time for this release is the
  12 big refactoring we have been doing. Instead of using several lists and a table
  13 as data structures, we now use a single tree of containers. These containers
  14 represent invisible entities like your X11 root window, your different monitors
  15 and workspaces, but also visible entities like actual windows.
  16
  17 Using a tree has made a lot of things cleaner and easier – in the code *and* in
  18 the user interface. Admittedly though, you will probably need a day or two to
  19 get used to a few more advanced movement commands if you are used to v3.ε right
  20 now.
  21
  22  ┌────────────────────────────┐
  23  │ New features               │
  24  └────────────────────────────┘
  25
  26  • In addition to the proper flex/bison based parser for the config file
  27    introduced in 3.δ, we now also have a flex/bison parser for commands. What
  28    this means is that we can have more human-readable, beautiful command names
  29    instead of cryptic commands like 'f' for fullscreen or 'mh' for move left.
  30    In fact, the commands for the aforementioned functions *are* 'fullscreen'
  31    and 'move left'!
  32
  33  • You can now chain commands using ';' (a semicolon). One example for that is
  34    'workspace 3 ; exec /usr/bin/urxvt' to switch to a new workspace and open a
  35    terminal.
  36
  37  • You can specify which windows should be affected by your command by using
  38    different criteria. A good example is '[class="Firefox"] kill' to get rid
  39    of all Firefox windows.
  40
  41  • As the configuration file needs new commands (and a few options are
  42    obsolete), you need to change it. To make this process a little bit easier
  43    for you, this release comes with the script i3-migrate-config-to-v4. Just
  44    run it on your current config file and it will spit out a v4 config file to
  45    stdout. To make things even better, i3 automatically detects v3 config files
  46    and calls that script, so you never end up with a non-working config :).
  47
  48  • Similarly to the criteria when using commands, we now have a 'for_window'
  49    configuration directive, which lets you automatically apply certain commands
  50    to certain windows. Use it to set border styles per window, for example with
  51    'for_window [class="XTerm"] border 1pixel'.
  52
  53  • Since dock clients (like dzen2) are now part of the layout tree (as opposed
  54    to a custom data structure as before), it was easy to implement top and
  55    bottom dock areas. Programs which properly specify the dock hint get placed
  56    on the edge of the screen they request. i3bar has the -dtop and -dbottom
  57    parameters, for example.
  58
  59  • The internal workspace bar is obsolete. Use i3bar instead.
  60
  61  • Resizing now works between all windows!
  62
  63  • Fullscreen now works for everything!
  64
  65  • Floating now works for everything!
  66
  67  • Your layout is now preserved when doing an inplace restart.
  68
  69  • When you have an error in your config file, a new program called i3-nagbar
  70    will tell you so. It offers you two buttons: One to view the error in your
  71    $PAGER and one to edit your config in your $EDITOR.
  72
  73  • The default config used key symbols (like 'bind Mod1+f fullscreen') instead
  74    of key codes. If you use a non-qwerty layout, the program i3-config-wizard
  75    can create a key symbol based config file based on your current layout. You
  76    can also chose between Windows (Mod4) and Alt (Mod1) as your default
  77    modifier. i3-config-wizard will automatically be started as long as you
  78    don’t have a configuration file for i3.
  79
  80  • Custom X cursor themes are now supported.
  81
  82  • The RandR backend now respects the primary output.
  83
  84  • A wrong 'font' configuration in your config file will no longer make i3
  85    exit. Instead, it will fall back to a different font and tell you about the
  86    error in its log.
  87
  88  • The default split direction (whether a new window gets placed right next to
  89    the current one or below the current one) is now automatically set to
  90    horizontal if you have a monitor that is wider than high or vertical if you
  91    a monitor which is higher than wide. This works great with rotated monitors.
  92
  93  • Sockets and temporary files are now placed in XDG_RUNTIME_DIR, if set (this
  94    is used on systemd based systems).
  95
  96  • Tools like i3bar, i3-msg etc. use the I3_SOCKET_PATH property which is set
  97    to the X11 root window, so you don’t have to configure your socket path
  98    anywhere.
  99
 100  • The kill command kills single windows by default now. To kill a whole
 101    application, use 'kill client'.
 102
 103  • IPC: Commands can now have custom replies. When the parser encounters an
 104    error, a proper error reply is sent.
 105
 106  • There is now an 'exec_always' configuration directive which works like
 107    'exec' but will also be run when restarting.
 108
 109  ┌────────────────────────────┐
 110  │ Future features            │
 111  └────────────────────────────┘
 112
 113 Our plans were big but our time and manpower is limited. Therefore, the
 114 following features did not make it into this release. However, the foundation
 115 is now in place and implementing them is possible, so stay tuned!
 116
 117  • Saving/Restoring specific parts of your layout
 118
 119  • Session saving
 120
 121  • Sticky windows
 122
 123  ┌────────────────────────────┐
 124  │ Thanks!                    │
 125  └────────────────────────────┘
 126
 127 Thanks for testing, bugfixes, discussions and everything I forgot go out to:
 128
 129   aniou, artoj, badboy, cloud, cradle, David Coppa, dbp, dothebart, eeemsi,
 130   eelvex, f8l, fernando, jan, jimdigriz, jon, julien, kacper, ktosiek,
 131   lexszero, litemotiv, lourens, madroach, marcus, merovius, mike, mirko, mseed,
 132   mxf, phnom, quaec, rogutes, sardemff7, smartass, thepub, tiago, tucos,
 133   woddf2, xpt, ys
 134
 135 -- Michael Stapelberg, 2011-07-31