fork/home-manager

git clone https://git.julia.blue/fork/home-manager

Nicolas Berbichedocs: add note about Waybar modules1aaa1a03

master
2.9 KiB73 linesraw
1[[sec-release-21.11]]
2== Release 21.11
3
4The 21.11 release branch became the stable branch in November, 2021.
5
6[[sec-release-21.11-highlights]]
7=== Highlights
8
9This release has the following notable changes:
10
11* All Home Manager modules are now loaded on all platforms. With this
12change you will get a more descriptive error message if you attempt to
13enable a module that is incompatible with the host platform.
14+
15Previously, modules that were platform specific would only be loaded
16on that particular platform. For example, a module defining a
17https://systemd.io/[systemd] service would only be loaded when the
18host platform was Linux. This reduced evaluation times, simplified the
19generated documentation, and made it impossible to accidentally use
20modules that do not support the host platform.
21+
22While the above benefits are quite nice, avoiding module loads also
23brings a few problems. For example, the
24https://nix-community.github.io/home-manager/[public documentation]
25will only show the options available for Linux hosts and the
26documentation cannot make references to options within modules that
27are unavailable on some hosts. Finally, users who wish to use the same
28configuration file for different platforms cannot do so, even if the
29platform incompatible options are unused.
30+
31Ultimately, the benefits of loading all modules won and the behavior
32has now changed. For associated discussion see
33https://github.com/nix-community/home-manager/issues/1906[issue #1906].
34
35* Rofi version 1.7.0 removed many options that were used by the module and replaced them with custom themes, which are more flexible and powerful.
36+
37You can replicate your old configuration by moving those options to <<opt-programs.rofi.theme>>. Keep in mind that the syntax is different so you may need to do some changes.
38
39* Taskwarrior version 2.6.0 respects XDG Specification for the config file now.
40Option <<opt-programs.taskwarrior.config>> and friends now generate the config file at
41`$XDG_CONFIG_HOME/task/taskrc` instead of `~/.taskrc`.
42
43[[sec-release-21.11-state-version-changes]]
44=== State Version Changes
45
46The state version in this release includes the changes below. These
47changes are only active if the `home.stateVersion` option is set to
48"21.11" or later.
49
50* The <<opt-home.keyboard>> option now defaults to `null`, meaning that Home Manager won't do any keyboard layout management. For example, `setxkbmap` won't be run in X sessions.
51
52* The <<opt-programs.pet.settings>> option no longer place its value inside a `General` attribute.
53For example,
54+
55[source,nix]
56programs.pet.settings.editor = "nvim";
57+
58becomes
59+
60[source,nix]
61programs.pet.settings.General.editor = "nvim";
62
63* The <<opt-programs.waybar.settings>> option now allows defining modules directly under <<opt-programs.waybar.settings>>.
64For example,
65+
66[source,nix]
67programs.waybar.settings.modules."custom/my-module" = { };
68+
69becomes
70+
71[source,nix]
72programs.waybar.settings."custom/my-module" = { };
73