mirror of
https://github.com/nix-community/home-manager
synced 2024-12-26 03:39:47 +01:00
docs: fix link texts in release notes
(cherry picked from commit 59c15ebe3d
)
This commit is contained in:
parent
34ccacf798
commit
b408085bcb
10 changed files with 52 additions and 52 deletions
|
@ -6,7 +6,7 @@ The 19.03 release branch became the stable branch in April, 2019.
|
||||||
|
|
||||||
This release has the following notable changes:
|
This release has the following notable changes:
|
||||||
|
|
||||||
- The [opt-home.file._name_.source](#opt-home.file._name_.source) option now allows source
|
- The [home.file._name_.source](#opt-home.file._name_.source) option now allows source
|
||||||
files to be hidden, that is, having a name starting with the `.`
|
files to be hidden, that is, having a name starting with the `.`
|
||||||
character. It also allows the source file name to contain characters
|
character. It also allows the source file name to contain characters
|
||||||
not typically allowed for Nix store paths. For example, your
|
not typically allowed for Nix store paths. For example, your
|
||||||
|
@ -17,7 +17,7 @@ This release has the following notable changes:
|
||||||
```
|
```
|
||||||
|
|
||||||
- The type used for the systemd unit options under
|
- The type used for the systemd unit options under
|
||||||
[opt-systemd.user.sockets](#opt-systemd.user.sockets),
|
[systemd.user.sockets](#opt-systemd.user.sockets),
|
||||||
etc. has been changed to offer more robust merging of
|
etc. has been changed to offer more robust merging of
|
||||||
configurations. If you don't override values within systemd units
|
configurations. If you don't override values within systemd units
|
||||||
then you are not affected by this change. Unfortunately, if you do
|
then you are not affected by this change. Unfortunately, if you do
|
||||||
|
@ -44,9 +44,9 @@ This release has the following notable changes:
|
||||||
## State Version Changes {#sec-release-19.03-state-version-changes}
|
## State Version Changes {#sec-release-19.03-state-version-changes}
|
||||||
|
|
||||||
The state version in this release includes the changes below. These
|
The state version in this release includes the changes below. These
|
||||||
changes are only active if the [opt-home.stateVersion](#opt-home.stateVersion) option is
|
changes are only active if the [home.stateVersion](#opt-home.stateVersion) option is
|
||||||
set to "19.03" or later.
|
set to "19.03" or later.
|
||||||
|
|
||||||
- There is now an option [opt-programs.beets.enable](#opt-programs.beets.enable) that
|
- There is now an option [programs.beets.enable](#opt-programs.beets.enable) that
|
||||||
defaults to `false`. Before the module would be active if the
|
defaults to `false`. Before the module would be active if the
|
||||||
[opt-programs.beets.settings](#opt-programs.beets.settings) option was non-empty.
|
[programs.beets.settings](#opt-programs.beets.settings) option was non-empty.
|
||||||
|
|
|
@ -20,9 +20,9 @@ The state version in this release includes the changes below. These
|
||||||
changes are only active if the `home.stateVersion` option is set to
|
changes are only active if the `home.stateVersion` option is set to
|
||||||
\"19.09\" or later.
|
\"19.09\" or later.
|
||||||
|
|
||||||
- The [opt-programs.firefox.package](#opt-programs.firefox.package) option now expects a
|
- The [programs.firefox.package](#opt-programs.firefox.package) option now expects a
|
||||||
wrapped Firefox package and defaults to `pkgs.firefox`.
|
wrapped Firefox package and defaults to `pkgs.firefox`.
|
||||||
|
|
||||||
- The options [opt-home.keyboard.layout](#opt-home.keyboard.layout) and
|
- The options [home.keyboard.layout](#opt-home.keyboard.layout) and
|
||||||
[opt-home.keyboard.variant](#opt-home.keyboard.variant) now default to `null`, which
|
[home.keyboard.variant](#opt-home.keyboard.variant) now default to `null`, which
|
||||||
indicates that the system value should be used.
|
indicates that the system value should be used.
|
||||||
|
|
|
@ -6,8 +6,8 @@ The 20.03 release branch became the stable branch in April, 2020.
|
||||||
|
|
||||||
This release has the following notable changes:
|
This release has the following notable changes:
|
||||||
|
|
||||||
- Assigning a list to the [opt-home.file](#opt-home.file),
|
- Assigning a list to the [home.file](#opt-home.file),
|
||||||
[opt-xdg.dataFile](#opt-xdg.dataFile) options is
|
[xdg.dataFile](#opt-xdg.dataFile) options is
|
||||||
now deprecated and will produce a warning message if used.
|
now deprecated and will produce a warning message if used.
|
||||||
Specifically, if your configuration currently contains something
|
Specifically, if your configuration currently contains something
|
||||||
like
|
like
|
||||||
|
@ -71,7 +71,7 @@ This release has the following notable changes:
|
||||||
no longer packages compton, and instead packages the (mostly)
|
no longer packages compton, and instead packages the (mostly)
|
||||||
compatible fork called picom.
|
compatible fork called picom.
|
||||||
|
|
||||||
- The list form of the [opt-programs.ssh.matchBlocks](#opt-programs.ssh.matchBlocks) option has
|
- The list form of the [programs.ssh.matchBlocks](#opt-programs.ssh.matchBlocks) option has
|
||||||
been deprecated and configurations requiring match blocks in a
|
been deprecated and configurations requiring match blocks in a
|
||||||
defined order should switch to using DAG entries instead. For
|
defined order should switch to using DAG entries instead. For
|
||||||
example, a configuration
|
example, a configuration
|
||||||
|
@ -111,7 +111,7 @@ The state version in this release includes the changes below. These
|
||||||
changes are only active if the `home.stateVersion` option is set to
|
changes are only active if the `home.stateVersion` option is set to
|
||||||
\"20.03\" or later.
|
\"20.03\" or later.
|
||||||
|
|
||||||
- The [opt-programs.zsh.history.path](#opt-programs.zsh.history.path) option is no longer
|
- The [programs.zsh.history.path](#opt-programs.zsh.history.path) option is no longer
|
||||||
prepended by `$HOME`, which allows specifying absolute paths, for
|
prepended by `$HOME`, which allows specifying absolute paths, for
|
||||||
example, using the xdg module. Also, the default value is fixed to
|
example, using the xdg module. Also, the default value is fixed to
|
||||||
`$HOME/.zsh_history` and `dotDir` path is not prepended to it
|
`$HOME/.zsh_history` and `dotDir` path is not prepended to it
|
||||||
|
|
|
@ -15,14 +15,14 @@ The state version in this release includes the changes below. These
|
||||||
changes are only active if the `home.stateVersion` option is set to
|
changes are only active if the `home.stateVersion` option is set to
|
||||||
\"20.09\" or later.
|
\"20.09\" or later.
|
||||||
|
|
||||||
- The options [opt-home.homeDirectory](#opt-home.homeDirectory) and
|
- The options [home.homeDirectory](#opt-home.homeDirectory) and
|
||||||
[opt-home.username](#opt-home.username) no longer have default values and must
|
[home.username](#opt-home.username) no longer have default values and must
|
||||||
therefore be provided in your configuration. Previously their values
|
therefore be provided in your configuration. Previously their values
|
||||||
would default to the content of the environment variables `HOME` and
|
would default to the content of the environment variables `HOME` and
|
||||||
`USER`, respectively.
|
`USER`, respectively.
|
||||||
|
|
||||||
Further, the options [opt-xdg.cacheHome](#opt-xdg.cacheHome),
|
Further, the options [xdg.cacheHome](#opt-xdg.cacheHome),
|
||||||
[opt-xdg.dataHome](#opt-xdg.dataHome) will no
|
[xdg.dataHome](#opt-xdg.dataHome) will no
|
||||||
longer be affected by the `XDG_CACHE_HOME`, `XDG_CONFIG_HOME`, and
|
longer be affected by the `XDG_CACHE_HOME`, `XDG_CONFIG_HOME`, and
|
||||||
`XDG_DATA_HOME` environment variables. They now unconditionally
|
`XDG_DATA_HOME` environment variables. They now unconditionally
|
||||||
default to
|
default to
|
||||||
|
@ -45,10 +45,10 @@ changes are only active if the `home.stateVersion` option is set to
|
||||||
will automatically include these options, when necessary.
|
will automatically include these options, when necessary.
|
||||||
|
|
||||||
- Git's `smtpEncryption` option is now set to `tls` only if both
|
- Git's `smtpEncryption` option is now set to `tls` only if both
|
||||||
[opt-accounts.email.accounts._name_.smtp.tls.enable](#opt-accounts.email.accounts._name_.smtp.tls.enable) and
|
[accounts.email.accounts._name_.smtp.tls.enable](#opt-accounts.email.accounts._name_.smtp.tls.enable) and
|
||||||
[opt-accounts.email.accounts._name_.smtp.tls.useStartTls](#opt-accounts.email.accounts._name_.smtp.tls.useStartTls) are
|
[accounts.email.accounts._name_.smtp.tls.useStartTls](#opt-accounts.email.accounts._name_.smtp.tls.useStartTls) are
|
||||||
`true`. If only
|
`true`. If only
|
||||||
[opt-accounts.email.accounts._name_.smtp.tls.enable](#opt-accounts.email.accounts._name_.smtp.tls.enable) is
|
[accounts.email.accounts._name_.smtp.tls.enable](#opt-accounts.email.accounts._name_.smtp.tls.enable) is
|
||||||
`true`, `ssl` is used instead.
|
`true`, `ssl` is used instead.
|
||||||
|
|
||||||
- The `nixpkgs` module no longer references `<nixpkgs>`. Before it
|
- The `nixpkgs` module no longer references `<nixpkgs>`. Before it
|
||||||
|
|
|
@ -27,7 +27,7 @@ This release has the following notable changes:
|
||||||
];
|
];
|
||||||
```
|
```
|
||||||
|
|
||||||
- The [opt-programs.mpv.package](#opt-programs.mpv.package) option has been changed to
|
- The [programs.mpv.package](#opt-programs.mpv.package) option has been changed to
|
||||||
allow custom derivations. The following configuration is now
|
allow custom derivations. The following configuration is now
|
||||||
possible:
|
possible:
|
||||||
|
|
||||||
|
@ -41,11 +41,11 @@ This release has the following notable changes:
|
||||||
});
|
});
|
||||||
```
|
```
|
||||||
|
|
||||||
As a result of this change, [opt-programs.mpv.package](#opt-programs.mpv.package) is no
|
As a result of this change, [programs.mpv.package](#opt-programs.mpv.package) is no
|
||||||
longer the resulting derivation. Use the newly introduced
|
longer the resulting derivation. Use the newly introduced
|
||||||
`programs.mpv.finalPackage` instead.
|
`programs.mpv.finalPackage` instead.
|
||||||
|
|
||||||
- The [opt-programs.rofi.extraConfig](#opt-programs.rofi.extraConfig) option is now an attribute
|
- The [programs.rofi.extraConfig](#opt-programs.rofi.extraConfig) option is now an attribute
|
||||||
set rather than a string. To migrate, move each line into the
|
set rather than a string. To migrate, move each line into the
|
||||||
attribute set, removing the `rofi.` prefix from the keys. For
|
attribute set, removing the `rofi.` prefix from the keys. For
|
||||||
example,
|
example,
|
||||||
|
@ -66,7 +66,7 @@ This release has the following notable changes:
|
||||||
};
|
};
|
||||||
```
|
```
|
||||||
|
|
||||||
- The [opt-programs.rofi.theme](#opt-programs.rofi.theme) option now supports defining a
|
- The [programs.rofi.theme](#opt-programs.rofi.theme) option now supports defining a
|
||||||
theme using an attribute set, the following configuration is now
|
theme using an attribute set, the following configuration is now
|
||||||
possible:
|
possible:
|
||||||
|
|
||||||
|
@ -95,7 +95,7 @@ This release has the following notable changes:
|
||||||
|
|
||||||
- The `services.redshift.extraOptions` and
|
- The `services.redshift.extraOptions` and
|
||||||
`services.gammastep.extraOptions` options were removed in favor of
|
`services.gammastep.extraOptions` options were removed in favor of
|
||||||
[opt-services.redshift.settings](#opt-services.redshift.settings) and
|
[services.redshift.settings](#opt-services.redshift.settings) and
|
||||||
`services.gammastep.settings`, that are now an attribute set rather
|
`services.gammastep.settings`, that are now an attribute set rather
|
||||||
than a string. They also support new features not available before,
|
than a string. They also support new features not available before,
|
||||||
for example:
|
for example:
|
||||||
|
@ -140,10 +140,10 @@ This release has the following notable changes:
|
||||||
- Home Manager now respects the `NO_COLOR` environment variable as per
|
- Home Manager now respects the `NO_COLOR` environment variable as per
|
||||||
<https://no-color.org/>.
|
<https://no-color.org/>.
|
||||||
|
|
||||||
- Qt module now supports [opt-qt.style.name](#opt-qt.style.name) to specify a theme
|
- Qt module now supports [qt.style.name](#opt-qt.style.name) to specify a theme
|
||||||
name and [opt-qt.style.package](#opt-qt.style.package) to specify a theme package. If
|
name and [qt.style.package](#opt-qt.style.package) to specify a theme package. If
|
||||||
you have set [opt-qt.platformTheme](#opt-qt.platformTheme) to `gnome`, a
|
you have set [qt.platformTheme](#opt-qt.platformTheme) to `gnome`, a
|
||||||
[opt-qt.style.package](#opt-qt.style.package) compatible with both Qt and Gtk is now
|
[qt.style.package](#opt-qt.style.package) compatible with both Qt and Gtk is now
|
||||||
required to be set. For instance:
|
required to be set. For instance:
|
||||||
|
|
||||||
``` nix
|
``` nix
|
||||||
|
@ -166,9 +166,9 @@ This release has the following notable changes:
|
||||||
};
|
};
|
||||||
```
|
```
|
||||||
|
|
||||||
- The [opt-programs.htop.settings](#opt-programs.htop.settings) option is introduced to
|
- The [programs.htop.settings](#opt-programs.htop.settings) option is introduced to
|
||||||
replace individual options in `programs.htop`. To migrate, set the
|
replace individual options in `programs.htop`. To migrate, set the
|
||||||
htop options directly in [opt-programs.htop.settings](#opt-programs.htop.settings). For
|
htop options directly in [programs.htop.settings](#opt-programs.htop.settings). For
|
||||||
example:
|
example:
|
||||||
|
|
||||||
``` nix
|
``` nix
|
||||||
|
|
|
@ -35,11 +35,11 @@ This release has the following notable changes:
|
||||||
powerful.
|
powerful.
|
||||||
|
|
||||||
You can replicate your old configuration by moving those options to
|
You can replicate your old configuration by moving those options to
|
||||||
[opt-programs.rofi.theme](#opt-programs.rofi.theme). Keep in mind that the syntax is
|
[programs.rofi.theme](#opt-programs.rofi.theme). Keep in mind that the syntax is
|
||||||
different so you may need to do some changes.
|
different so you may need to do some changes.
|
||||||
|
|
||||||
- Taskwarrior version 2.6.0 respects XDG Specification for the config
|
- Taskwarrior version 2.6.0 respects XDG Specification for the config
|
||||||
file now. Option [opt-programs.taskwarrior.config](#opt-programs.taskwarrior.config) and friends
|
file now. Option [programs.taskwarrior.config](#opt-programs.taskwarrior.config) and friends
|
||||||
now generate the config file at `$XDG_CONFIG_HOME/task/taskrc`
|
now generate the config file at `$XDG_CONFIG_HOME/task/taskrc`
|
||||||
instead of `~/.taskrc`.
|
instead of `~/.taskrc`.
|
||||||
|
|
||||||
|
@ -49,11 +49,11 @@ The state version in this release includes the changes below. These
|
||||||
changes are only active if the `home.stateVersion` option is set to
|
changes are only active if the `home.stateVersion` option is set to
|
||||||
\"21.11\" or later.
|
\"21.11\" or later.
|
||||||
|
|
||||||
- The [opt-home.keyboard](#opt-home.keyboard) option now defaults to `null`, meaning
|
- The [home.keyboard](#opt-home.keyboard) option now defaults to `null`, meaning
|
||||||
that Home Manager won't do any keyboard layout management. For
|
that Home Manager won't do any keyboard layout management. For
|
||||||
example, `setxkbmap` won't be run in X sessions.
|
example, `setxkbmap` won't be run in X sessions.
|
||||||
|
|
||||||
- The [opt-programs.pet.settings](#opt-programs.pet.settings) option no longer place its
|
- The [programs.pet.settings](#opt-programs.pet.settings) option no longer place its
|
||||||
value inside a `General` attribute. For example,
|
value inside a `General` attribute. For example,
|
||||||
|
|
||||||
``` nix
|
``` nix
|
||||||
|
@ -66,8 +66,8 @@ changes are only active if the `home.stateVersion` option is set to
|
||||||
programs.pet.settings.General.editor = "nvim";
|
programs.pet.settings.General.editor = "nvim";
|
||||||
```
|
```
|
||||||
|
|
||||||
- The [opt-programs.waybar.settings](#opt-programs.waybar.settings) option now allows defining
|
- The [programs.waybar.settings](#opt-programs.waybar.settings) option now allows defining
|
||||||
modules directly under [opt-programs.waybar.settings](#opt-programs.waybar.settings). For
|
modules directly under [programs.waybar.settings](#opt-programs.waybar.settings). For
|
||||||
example,
|
example,
|
||||||
|
|
||||||
``` nix
|
``` nix
|
||||||
|
|
|
@ -29,8 +29,8 @@ The state version in this release includes the changes below. These
|
||||||
changes are only active if the `home.stateVersion` option is set to
|
changes are only active if the `home.stateVersion` option is set to
|
||||||
\"22.05\" or later.
|
\"22.05\" or later.
|
||||||
|
|
||||||
- The [opt-programs.waybar.settings](#opt-programs.waybar.settings) option now allows defining
|
- The [programs.waybar.settings](#opt-programs.waybar.settings) option now allows defining
|
||||||
modules directly under [opt-programs.waybar.settings](#opt-programs.waybar.settings).
|
modules directly under [programs.waybar.settings](#opt-programs.waybar.settings).
|
||||||
Defining modules under `programs.waybar.settings.modules` will now
|
Defining modules under `programs.waybar.settings.modules` will now
|
||||||
be an error. For example,
|
be an error. For example,
|
||||||
|
|
||||||
|
|
|
@ -6,7 +6,7 @@ The 22.11 release branch became the stable branch in November, 2022.
|
||||||
|
|
||||||
This release has the following notable changes:
|
This release has the following notable changes:
|
||||||
|
|
||||||
- The [opt-home.stateVersion](#opt-home.stateVersion) option no longer has a default
|
- The [home.stateVersion](#opt-home.stateVersion) option no longer has a default
|
||||||
value. It used to default to "18.09", which was the Home Manager
|
value. It used to default to "18.09", which was the Home Manager
|
||||||
version that introduced the option. If your configuration does not
|
version that introduced the option. If your configuration does not
|
||||||
explicitly set this option then you need to add
|
explicitly set this option then you need to add
|
||||||
|
@ -71,18 +71,18 @@ This release has the following notable changes:
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Of course, you can move the assignment of [opt-home.username](#opt-home.username),
|
Of course, you can move the assignment of [home.username](#opt-home.username),
|
||||||
[opt-home.stateVersion](#opt-home.stateVersion) to
|
[home.stateVersion](#opt-home.stateVersion) to
|
||||||
some other file or simply place them in your `home.nix`.
|
some other file or simply place them in your `home.nix`.
|
||||||
|
|
||||||
- The `services.picom` module has been refactored to use structural
|
- The `services.picom` module has been refactored to use structural
|
||||||
settings.
|
settings.
|
||||||
|
|
||||||
As a result `services.picom.extraOptions` has been removed in favor
|
As a result `services.picom.extraOptions` has been removed in favor
|
||||||
of [opt-services.picom.settings](#opt-services.picom.settings). Also, `services.picom.blur*`
|
of [services.picom.settings](#opt-services.picom.settings). Also, `services.picom.blur*`
|
||||||
were removed since upstream changed the blur settings to be more
|
were removed since upstream changed the blur settings to be more
|
||||||
flexible. You can migrate the blur settings to use
|
flexible. You can migrate the blur settings to use
|
||||||
[opt-services.picom.settings](#opt-services.picom.settings) instead.
|
[services.picom.settings](#opt-services.picom.settings) instead.
|
||||||
|
|
||||||
- The `services.compton` module has been removed. It was deprecated in
|
- The `services.compton` module has been removed. It was deprecated in
|
||||||
release 20.03. Use `services.picom` instead.
|
release 20.03. Use `services.picom` instead.
|
||||||
|
@ -93,9 +93,9 @@ The state version in this release includes the changes below. These
|
||||||
changes are only active if the `home.stateVersion` option is set to
|
changes are only active if the `home.stateVersion` option is set to
|
||||||
\"22.11\" or later.
|
\"22.11\" or later.
|
||||||
|
|
||||||
- The [opt-services.mpd.musicDirectory](#opt-services.mpd.musicDirectory) option now defaults to
|
- The [services.mpd.musicDirectory](#opt-services.mpd.musicDirectory) option now defaults to
|
||||||
the value of [opt-xdg.userDirs.music](#opt-xdg.userDirs.music) if
|
the value of [xdg.userDirs.music](#opt-xdg.userDirs.music) if
|
||||||
[opt-xdg.userDirs.enable](#opt-xdg.userDirs.enable) is enabled. Otherwise it is
|
[xdg.userDirs.enable](#opt-xdg.userDirs.enable) is enabled. Otherwise it is
|
||||||
undefined and must be specified in the user configuration.
|
undefined and must be specified in the user configuration.
|
||||||
|
|
||||||
- The activation script now resets `PATH` before running. Before, the
|
- The activation script now resets `PATH` before running. Before, the
|
||||||
|
|
|
@ -47,13 +47,13 @@ changes are only active if the `home.stateVersion` option is set to
|
||||||
|
|
||||||
- The options
|
- The options
|
||||||
|
|
||||||
- [opt-xsession.windowManager.i3.config.window.titlebar](#opt-xsession.windowManager.i3.config.window.titlebar)
|
- [xsession.windowManager.i3.config.window.titlebar](#opt-xsession.windowManager.i3.config.window.titlebar)
|
||||||
|
|
||||||
- [opt-xsession.windowManager.i3.config.floating.titlebar](#opt-xsession.windowManager.i3.config.floating.titlebar)
|
- [xsession.windowManager.i3.config.floating.titlebar](#opt-xsession.windowManager.i3.config.floating.titlebar)
|
||||||
|
|
||||||
- [opt-wayland.windowManager.sway.config.window.titlebar](#opt-wayland.windowManager.sway.config.window.titlebar)
|
- [wayland.windowManager.sway.config.window.titlebar](#opt-wayland.windowManager.sway.config.window.titlebar)
|
||||||
|
|
||||||
- [opt-wayland.windowManager.sway.config.floating.titlebar](#opt-wayland.windowManager.sway.config.floating.titlebar)
|
- [wayland.windowManager.sway.config.floating.titlebar](#opt-wayland.windowManager.sway.config.floating.titlebar)
|
||||||
|
|
||||||
now default to `true` which is consistent with the default values
|
now default to `true` which is consistent with the default values
|
||||||
for those options used by `i3` and `sway`.
|
for those options used by `i3` and `sway`.
|
||||||
|
|
|
@ -6,8 +6,8 @@ The 23.11 release branch became stable in November, 2023.
|
||||||
|
|
||||||
This release has the following notable changes:
|
This release has the following notable changes:
|
||||||
|
|
||||||
- When using [opt-programs.fish.enable](#opt-programs.fish.enable), the setup code for
|
- When using [programs.fish.enable](#opt-programs.fish.enable), the setup code for
|
||||||
[opt-home.sessionVariables](#opt-home.sessionVariables) is now translated with
|
[home.sessionVariables](#opt-home.sessionVariables) is now translated with
|
||||||
[babelfish](https://github.com/bouk/babelfish). This should result
|
[babelfish](https://github.com/bouk/babelfish). This should result
|
||||||
in significantly faster shell startup times but could theoretically
|
in significantly faster shell startup times but could theoretically
|
||||||
break if you have very complex bash expressions in a session
|
break if you have very complex bash expressions in a session
|
||||||
|
|
Loading…
Reference in a new issue