fork/home-manager
git clone https://git.julia.blue/fork/home-manager
7ef3db37
master
1[[sec-release-19.03]] 2== Release 19.03 3 4The 19.03 release branch became the stable branch in April, 2019. 5 6[[sec-release-19.03-highlights]] 7=== Highlights 8: opt-home-file-source : opt-home.file._name_.source 9 10This release has the following notable changes: 11 12* The <<{opt-home-file-source}>> option now allows source files to be 13hidden, that is, having a name starting with the `.` character. It 14also allows the source file name to contain characters not typically 15allowed for Nix store paths. For example, your configuration can now 16contain things such as 17+ 18[ source,nix ] 19---- 20home.file."my file".source = ./. + "/file with spaces!"; 21---- 22 23* The type used for the systemd unit options under 24<<opt-systemd.user.services>>, <<opt-systemd.user.sockets>>, etc. has 25been changed to offer more robust merging of configurations. If you 26don't override values within systemd units then you are not affected 27by this change. Unfortunately, if you do override unit values you may 28encounter errors. 29+ 30In particular, if you get an error saying that a ``unique option'' is 31``defined multiple times'' then you need to use the 32https://nixos.org/nixos/manual/#sec-option-definitions-setting-priorities[`mkForce`] 33function. For example, 34+ 35[ source,nix ] 36---- 37systemd.user.services.foo.Service.ExecStart = "/foo/bar"; 38---- 39+ 40becomes 41+ 42[ source,nix ] 43---- 44systemd.user.services.foo.Service.ExecStart = lib.mkForce "/foo/bar"; 45---- 46+ 47We had to make this change because the old merging was causing too 48many confusing situations for people. 49 50[[sec-release-19.03-state-version-changes]] 51=== State Version Changes 52 53The state version in this release includes the changes below. These 54changes are only active if the <<opt-home.stateVersion>> option is set 55to ``19.03'' or later. 56 57* There is now an option <<opt-programs.beets.enable>> that defaults 58to `false`. Before the module would be active if the 59<<opt-programs.beets.settings>> option was non-empty.