fork/home-manager
git clone https://git.julia.blue/fork/home-manager
65b65ce5
master
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{ 28invocation = "p"; 29execution = ":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 { 40vapoursynthSupport = true; 41}) { 42extraMakeWrapperArgs = [ 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 = '' 59rofi.show-icons: true 60rofi.modi: drun,emoji,ssh 61''; 62---- 63+ 64becomes 65+ 66[ source,nix ] 67---- 68programs.rofi.extraConfig = { 69show-icons = true; 70modi = "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 81inherit (config.lib.formats.rasi) mkLiteral; 82in { 83"@import" = "~/.config/rofi/theme.rasi"; 84 85"*" = { 86background-color = mkLiteral "#000000"; 87foreground-color = mkLiteral "rgba ( 250, 251, 252, 100 % )"; 88border-color = mkLiteral "#FFFFFF"; 89width = 512; 90}; 91 92"#textbox-prompt-colon" = { 93expand = false; 94str = ":"; 95margin = mkLiteral "0px 0.3em 0em 0em"; 96text-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 = { 111dawnTime = "6:00-7:45"; 112duskTime = "18:35-20:15"; 113settings = { 114redshift = { 115gamma = 0.8; 116adjustment-method = "randr"; 117}; 118 119randr = { 120screen = 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 132single string is now deprecated in favor of specfiying it as a list of 133strings. 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 = { 156platformTheme = "gnome"; 157style = { 158name = "adwaita-dark"; 159package = 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 = { 169name = "DejaVu Sans"; 170size = 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 = { 181enabled = true; 182settings = { 183color_scheme = 5; 184delay = 15; 185highlight_base_name = 1; 186highlight_megabytes = 1; 187highlight_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`.