fork/home-manager

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

Robert Helgessondocs: rename "doc" directory to "docs"7ef3db37

master
3.3 KiB96 linesraw
1[[sec-release-20.09]]
2== Release 20.09
3
4The 20.09 release branch became the stable branch in late September, 2020.
5
6[[sec-release-20.09-highlights]]
7=== Highlights
8
9This release has the following notable changes:
10
11* Nothing has happened.
12
13[[sec-release-20.09-state-version-changes]]
14=== State Version Changes
15
16The state version in this release includes the changes below. These
17changes are only active if the `home.stateVersion` option is set to
18"20.09" or later.
19
20* The options <<opt-home.homeDirectory>> and <<opt-home.username>> no
21longer have default values and must therefore be provided in your
22configuration. Previously their values would default to the content of
23the environment variables `HOME` and `USER`, respectively.
24+
25--
26Further, the options <<opt-xdg.cacheHome>>, <<opt-xdg.configHome>>,
27and <<opt-xdg.dataHome>> will no longer be affected by the
28`XDG_CACHE_HOME`, `XDG_CONFIG_HOME`, and `XDG_DATA_HOME` environment
29variables. They now unconditionally default to
30
31- `"${config.home.homeDirectory}/.cache"`,
32- `"${config.home.homeDirectory}/.config"`, and
33- `"${config.home.homeDirectory}/.local/share"`.
34
35If you choose to switch to state version 20.09 then you must set these
36options if you use non-default XDG base directory paths.
37
38The initial configuration generated by
39
40[source,console]
41$ nix-shell '<home-manager>' -A install
42
43will automatically include these options, when necessary.
44--
45
46* Git's `smtpEncryption` option is now set to `tls` only if both <<opt-accounts.email.accounts.\_name_.smtp.tls.enable>> and <<opt-accounts.email.accounts.\_name_.smtp.tls.useStartTls>> are `true`. If only <<opt-accounts.email.accounts.\_name_.smtp.tls.enable>> is `true`, `ssl` is used instead.
47
48* The `nixpkgs` module no longer references `<nixpkgs>`. Before it would do so when building the `pkgs` module argument. Starting with state version 20.09, the `pkgs` argument is instead built from the same Nixpkgs that was used to initialize the Home Manager modules. This is useful, for example, when using Home Manager within a Nix Flake. If you want to keep using `<nixpkgs>` with state version ≥ 20.09 then add
49+
50[source,nix]
51_module.args.pkgsPath = <nixpkgs>;
52+
53to your Home Manager configuration.
54
55* The options `wayland.windowManager.sway.config.bars` and `opt-xsession.windowManager.i3.config.bars` have been changed so that most of the suboptions are now nullable and default to `null`. The default for these two options has been changed to manually set the old defaults for each suboption. The overall effect is that if the `bars` options is not set, then the default remains the same. On the other hand, something like:
56+
57--
58[source,nix]
59----
60bars = [ {
61  command = "waybar";
62} ];
63----
64will now create the config:
65....
66bar {
67  swaybar_command waybar
68}
69....
70instead of
71....
72bar {
73
74  font pango:monospace 8
75  mode dock
76  hidden_state hide
77  position bottom
78  status_command /nix/store/h7s6i9q1z5fxrlyyw5ls8vqxhf5bcs5a-i3status-2.13/bin/i3status
79  swaybar_command waybar
80  workspace_buttons yes
81  strip_workspace_numbers no
82  tray_output primary
83  colors {
84    background #000000
85    statusline #ffffff
86    separator #666666
87    focused_workspace #4c7899 #285577 #ffffff
88    active_workspace #333333 #5f676a #ffffff
89    inactive_workspace #333333 #222222 #888888
90    urgent_workspace #2f343a #900000 #ffffff
91    binding_mode #2f343a #900000 #ffffff
92  }
93
94}
95....
96--