fork/home-manager
git clone https://git.julia.blue/fork/home-manager
7ef3db37
master
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 = [ { 61command = "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--