fork/home-manager

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

Robin Stummbroot: use upstream defaults, allow all config options (#2644)65b65ce5

master
4.9 KiB200 linesraw
1[[sec-release-21.05]]
2== Release 21.05
3
4The 21.05 release branch became the stable branch in May, 2021.
5
6[[sec-release-21.05-highlights]]
7=== Highlights
8
9This release has the following notable changes:
10
11* The `opt-programs.broot.verbs` option is now a list rather than an
12attribute set. To migrate, move the keys of the attrset into the list
13items' `invocation` keys. For example,
14+
15[source,nix]
16----
17programs.broot.verbs = {
18  "p" = { execution = ":parent"; };
19};
20----
21+
22becomes
23+
24[source,nix]
25----
26programs.broot.verbs = [
27  {
28    invocation = "p";
29    execution = ":parent";
30  }
31];
32----
33
34* The <<opt-programs.mpv.package>> option has been changed to allow custom
35derivations. The following configuration is now possible:
36+
37[source,nix]
38----
39programs.mpv.package = (pkgs.wrapMpv (pkgs.mpv-unwrapped.override {
40  vapoursynthSupport = true;
41}) {
42  extraMakeWrapperArgs = [
43    "--prefix" "LD_LIBRARY_PATH" ":" "${pkgs.vapoursynth-mvtools}/lib/vapoursynth"
44  ];
45});
46----
47+
48As a result of this change, <<opt-programs.mpv.package>> is no longer the
49resulting derivation. Use the newly introduced `programs.mpv.finalPackage`
50instead.
51
52* The <<opt-programs.rofi.extraConfig>> option is now an attribute set rather
53than a string. To migrate, move each line into the attribute set,
54removing the `rofi.` prefix from the keys. For example,
55+
56[source,nix]
57----
58programs.rofi.extraConfig = ''
59  rofi.show-icons: true
60  rofi.modi: drun,emoji,ssh
61'';
62----
63+
64becomes
65+
66[source,nix]
67----
68programs.rofi.extraConfig = {
69  show-icons = true;
70  modi = "drun,emoji,ssh";
71};
72----
73+
74* The <<opt-programs.rofi.theme>> option now supports defining a theme
75using an attribute set, the following configuration is now possible:
76+
77[source,nix]
78----
79programs.rofi.theme = let
80  # Necessary to avoid quoting non-string values
81  inherit (config.lib.formats.rasi) mkLiteral;
82in {
83   "@import" = "~/.config/rofi/theme.rasi";
84
85  "*" = {
86    background-color = mkLiteral "#000000";
87    foreground-color = mkLiteral "rgba ( 250, 251, 252, 100 % )";
88    border-color = mkLiteral "#FFFFFF";
89    width = 512;
90  };
91
92  "#textbox-prompt-colon" = {
93    expand = false;
94    str = ":";
95    margin = mkLiteral "0px 0.3em 0em 0em";
96    text-color = mkLiteral "@foreground-color";
97  };
98};
99----
100
101
102* The `services.redshift.extraOptions` and `services.gammastep.extraOptions`
103options were removed in favor of <<opt-services.redshift.settings>> and
104`services.gammastep.settings`, that are now an attribute set rather
105than a string. They also support new features not available before, for
106example:
107+
108[source,nix]
109----
110services.redshift = {
111  dawnTime = "6:00-7:45";
112  duskTime = "18:35-20:15";
113  settings = {
114    redshift = {
115      gamma = 0.8;
116      adjustment-method = "randr";
117    };
118
119    randr = {
120      screen = 0;
121    };
122  };
123};
124----
125+
126It is recommended to check either
127https://github.com/jonls/redshift/blob/master/redshift.conf.sample[redshift.conf.sample] or
128https://gitlab.com/chinstrap/gammastep/-/blob/master/gammastep.conf.sample[gammastep.conf.sample]
129for the available additional options in each program.
130
131* Specifying `programs.neomutt.binds.map` or `programs.neomutt.macros.map` as a
132  single string is now deprecated in favor of specfiying it as a list of
133  strings.
134
135* The `programs.neovim.configure` is deprecated in favor of other `programs.neovim` options;
136please use the other options at your disposal:
137+
138[source,nix]
139----
140configure.packages.*.opt  -> programs.neovim.plugins = [ { plugin = ...; optional = true; }]
141configure.packages.*.start  -> programs.neovim.plugins = [ { plugin = ...; }]
142configure.customRC -> programs.neovim.extraConfig
143----
144
145* Home Manager now respects the `NO_COLOR` environment variable as per
146https://no-color.org/[].
147
148* Qt module now supports <<opt-qt.style.name>> to specify a theme name and
149<<opt-qt.style.package>> to specify a theme package. If you have set
150<<opt-qt.platformTheme>> to `gnome`, a <<opt-qt.style.package>> compatible
151with both Qt and Gtk is now required to be set. For instance:
152+
153[source,nix]
154----
155qt = {
156  platformTheme = "gnome";
157  style = {
158    name = "adwaita-dark";
159    package = pkgs.adwaita-qt;
160  };
161};
162----
163
164* The library type `fontType` now has a `size` attribute in addition to `name`. For example:
165+
166[source,nix]
167----
168font = {
169  name = "DejaVu Sans";
170  size = 8;
171};
172----
173
174* The <<opt-programs.htop.settings>> option is introduced to replace individual
175options in `programs.htop`. To migrate, set the htop options directly in
176<<opt-programs.htop.settings>>. For example:
177+
178[source,nix]
179----
180programs.htop = {
181  enabled = true;
182  settings = {
183     color_scheme = 5;
184     delay = 15;
185     highlight_base_name = 1;
186     highlight_megabytes = 1;
187     highlight_threads = 1;
188  };
189};
190----
191
192[[sec-release-21.05-state-version-changes]]
193=== State Version Changes
194
195The state version in this release includes the changes below. These
196changes are only active if the `home.stateVersion` option is set to
197"21.05" or later.
198
199* The `newsboat` module now stores generated configuration in
200  `$XDG_CONFIG_HOME/newsboat`.