To make the NixOS module available for use you mu
your system configuration. This is most conveniently done by adding a
Home Manager channel. For example, if you are following Nixpkgs master
or an unstable channel, you can run
to your system configuration.nix file, which will introduce a new
NixOS option called home-manager.users whose type is an attribute
set that maps user names to Home Manager configurations.
For example, a NixOS configuration may include the lines
To make the NixOS module available for use you must # nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
-# nix-channel --update
and if you follow a Nixpkgs version 21.05 channel, you can run
to your nix-darwin configuration.nix file, which will introduce a
new NixOS option called home-manager whose type is an attribute set
that maps user names to Home Manager configurations.
For example, a nix-darwin configuration may include the lines
users.users.eve = {
@@ -144,7 +144,7 @@ error: A definition for option `programs.emacs.enable' is not of type `boolean'.
# You can update Home Manager without changing this value. See
# the Home Manager release notes for a list of state version
# changes in each release.
- home.stateVersion = "21.11";
+ home.stateVersion = "22.05";
# Let Home Manager install and manage itself.
programs.home-manager.enable = true;
@@ -170,7 +170,7 @@ error: A definition for option `programs.emacs.enable' is not of type `boolean'.
# You can update Home Manager without changing this value. See
# the Home Manager release notes for a list of state version
# changes in each release.
- home.stateVersion = "21.11";
+ home.stateVersion = "22.05";
# Let Home Manager install and manage itself.
programs.home-manager.enable = true;
diff --git a/options.html b/options.html
index 765aa372b..9c161be2b 100644
--- a/options.html
+++ b/options.html
@@ -722,7 +722,7 @@ Nixpkgs.
When this option is enabled and a mismatch is detected then a warning
will be printed when the user configuration is being built.
-
The set of packages to appear in the user environment.
Type: list of packages
Default:
[
@@ -1005,7 +1005,7 @@ settings are in effect and will therefore help avoid breaking
program configurations. Switching to a higher state version
typically requires performing some manual steps, such as data
conversion or moving files.
-
Type: one of "18.09", "19.03", "19.09", "20.03", "20.09", "21.03", "21.05", "21.11"
"$USER" for state version < 20.09,
undefined for state version ≥ 20.09
diff --git a/release-notes.html b/release-notes.html
index 69c22dccf..693752132 100644
--- a/release-notes.html
+++ b/release-notes.html
@@ -1,6 +1,11 @@
-Appendix E. Release Notes
This section lists the release notes for stable versions of Home Manager and the current unstable version.
E.1. Release 22.05
This is the current unstable branch and the information in this section is therefore not final.
E.1.1. Highlights
This release has the following notable changes:
+Nothing has happened.
+
E.1.2. State Version Changes
The state version in this release includes the changes below.
+These changes are only active if the home.stateVersion option is set to "22.05" or later.
+Nothing has happened.
+
E.2. Release 21.11
This is the current unstable branch and the information in this
+section is therefore not final.
E.2.1. Highlights
This release has the following notable changes:
All Home Manager modules are now loaded on all platforms. With this
change you will get a more descriptive error message if you attempt to
enable a module that is incompatible with the host platform.
@@ -24,14 +29,14 @@ Rofi version 1.7.0 removed many options that were used by the module and replace
Taskwarrior version 2.6.0 respects XDG Specification for the config file now.
Option programs.taskwarrior.config and friends now generate the config file at
$XDG_CONFIG_HOME/task/taskrc instead of ~/.taskrc.
-
E.1.2. State Version Changes
The state version in this release includes the changes below. These
+
E.2.2. State Version Changes
The state version in this release includes the changes below. These
changes are only active if the home.stateVersion option is set to
"21.11" or later.
The home.keyboard option now defaults to null, meaning that Home Manager won’t do any keyboard layout management. For example, setxkbmap won’t be run in X sessions.
The programs.pet.settings option no longer place its value inside a General attribute.
For example, is you before had
-
programs.pet.settings.editor = "nvim";
then you now need
programs.pet.settings.General.editor = "nvim";
E.2. Release 21.05
The 21.05 release branch became the stable branch in May, 2021.
E.2.1. Highlights
This release has the following notable changes:
+
programs.pet.settings.editor = "nvim";
then you now need
programs.pet.settings.General.editor = "nvim";
E.3. Release 21.05
The 21.05 release branch became the stable branch in May, 2021.
E.3.1. Highlights
This release has the following notable changes:
The programs.broot.verbs option is now a list rather than an
attribute set. To migrate, move the keys of the attrset into the list
items' invocation keys. For example,
@@ -148,14 +153,14 @@ options in programs.htop. To migrate, set the htop
highlight_megabytes = 1;
highlight_threads = 1;
};
-};
E.2.2. State Version Changes
The state version in this release includes the changes below. These
+};
E.3.2. State Version Changes
The state version in this release includes the changes below. These
changes are only active if the home.stateVersion option is set to
"21.05" or later.
The newsboat module now stores generated configuration in
$XDG_CONFIG_HOME/newsboat.
-
E.3. Release 20.09
The 20.09 release branch became the stable branch in late September, 2020.
E.3.1. Highlights
This release has the following notable changes:
+
E.4. Release 20.09
The 20.09 release branch became the stable branch in late September, 2020.
E.4.1. Highlights
This release has the following notable changes:
Nothing has happened.
-
E.3.2. State Version Changes
The state version in this release includes the changes below. These
+
E.4.2. State Version Changes
The state version in this release includes the changes below. These
changes are only active if the home.stateVersion option is set to
"20.09" or later.
The options home.homeDirectory and home.username no
@@ -204,7 +209,7 @@ The options wayland.windowManager.sway.config.bars
binding_mode #2f343a #900000 #ffffff
}
-}
E.4. Release 20.03
The 20.03 release branch became the stable branch in April, 2020.
E.4.1. Highlights
This release has the following notable changes:
+}
E.5. Release 20.03
The 20.03 release branch became the stable branch in April, 2020.
E.5.1. Highlights
This release has the following notable changes:
Assigning a list to the home.file, xdg.configFile,
and xdg.dataFile options is now deprecated and will produce a
warning message if used. Specifically, if your configuration currently
@@ -260,7 +265,7 @@ configuration
user = "jd";
}
};
Support for the list form will be removed in Home Manager version
-20.09.
E.4.2. State Version Changes
The state version in this release includes the changes below. These
+20.09.
E.5.2. State Version Changes
The state version in this release includes the changes below. These
changes are only active if the home.stateVersion option is set to
"20.03" or later.
The 19.09 release branch became the stable branch in October, 2019.
E.5.1. Highlights
This release has the following notable changes:
+
E.6. Release 19.09
The 19.09 release branch became the stable branch in October, 2019.
E.6.1. Highlights
This release has the following notable changes:
The programs.firefox.enableGoogleTalk and
programs.firefox.enableIcedTea options are now deprecated
and will only work if Firefox ESR 52.x is used.
@@ -280,7 +285,7 @@ The programs.firefox.enableGoogleTalk and
The home-manager tool now provides an uninstall sub-command that
can be used to uninstall Home Manager, if used in the standalone
mode. That is, not as a NixOS module.
-
E.5.2. State Version Changes
The state version in this release includes the changes below. These
+
E.6.2. State Version Changes
The state version in this release includes the changes below. These
changes are only active if the home.stateVersion option is set to
"19.09" or later.
The 19.03 release branch became the stable branch in April, 2019.
E.6.1. Highlights
This release has the following notable changes:
+
E.7. Release 19.03
The 19.03 release branch became the stable branch in April, 2019.
E.7.1. Highlights
This release has the following notable changes:
The home.file.<name>.source option now allows source files to be
hidden, that is, having a name starting with the . character. It
also allows the source file name to contain characters not typically
@@ -306,10 +311,10 @@ encounter errors.
“defined multiple times” then you need to use the
mkForce
function. For example,
We had to make this change because the old merging was causing too
-many confusing situations for people.
E.6.2. State Version Changes
The state version in this release includes the changes below. These
+many confusing situations for people.
E.7.2. State Version Changes
The state version in this release includes the changes below. These
changes are only active if the home.stateVersion option is set
to “19.03” or later.
The 18.09 release branch became the stable branch in September, 2018.
\ No newline at end of file
+
E.8. Release 18.09
The 18.09 release branch became the stable branch in September, 2018.
\ No newline at end of file
diff --git a/tools.html b/tools.html
index 4f7f863d3..f938159bc 100644
--- a/tools.html
+++ b/tools.html
@@ -1,6 +1,6 @@
-Appendix D. Tools
This command updates the user environment so that it corresponds to the
configuration specified in ~/.config/nixpkgs/home.nix or ~/.config/nixpkgs/flake.nix.
@@ -151,7 +151,7 @@
available for immediate garbage collection.
-
Options
+
Options
The tool accepts the options
-A attrPath
@@ -259,15 +259,15 @@
--verbose
Activates verbose output.
-
Files
+
Files
~/.local/share/home-manager/news-read-ids
Identifiers of news items that have been shown. Can be deleted to reset
the read news indicator.
-