fork/home-manager

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

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

master
1.9 KiB59 linesraw
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.