diff --git a/index.html b/index.html index 90dcf2db0..1bdfcf298 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@ -
ca.desrt.dconf?+
ca.desrt.dconf?This manual will eventually describe how to install, use, and extend Home Manager.
@@ -245,7 +245,8 @@ The support is still experimental and may change in backwards incompatible ways.
Install Nix 2.4 or have it in nix-shell.
Enable experimental features nix-command and flakes.
-
Either set in nix.conf
experimental-features = nix-command flakes
or pass them to nix by
nix --experimental-features "nix-command flakes" your command
+
Either set in nix.conf
experimental-features = nix-command flakes
or pass them to nix and home-manager by
$ nix --extra-experimental-features "nix-command flakes" <sub-commands> +$ home-manager --extra-experimental-features "nix-command flakes" <sub-commands>
Prepare your Home Manager configuration (home.nix).
Unlike the channel-based setup,
home.nix will be evaluated when the flake is built,
@@ -296,12 +297,13 @@ The Home Manager library is exported by the flake under
Install Home Manager and apply the configuration by
$ nix build --no-link <flake-uri>#homeConfigurations.jdoe.activationPackage -$ "$(nix path-info <flake-uri>#homeConfigurations.jdoe.activationPackage)"/bin/activate
If flake.nix resides in ~/.config/nixpkgs,
+$ "$(nix path-info <flake-uri>#homeConfigurations.jdoe.activationPackage)"/bin/activate
Substitute <flake-uri> with the flake URI of the configuration flake.
+If flake.nix resides in ~/.config/nixpkgs,
<flake-uri> may be ~/.config/nixpkgs
as a Git tree or path:~/.config/nixpkgs if not.
Since the release 21.05,
building a flake-based configuration is as simple as
-
$ home-manager switch --flake 'flake-uri#jdoe'
once home-manager is installed.
Here, jdoe is a configuration specified in the flake file,
+
$ home-manager switch --flake '<flake-uri>#jdoe'
once home-manager is installed.
Here, jdoe is a configuration specified in the flake file,
and <flake-uri>#jdoe will be expanded to
<flake-uri>#homeConfigurations.jdoe.activationPackage
and be built by Nix.
The flake inputs are not upgraded automatically when switching. diff --git a/tools.html b/tools.html index fb8810e1c..f5747218e 100644 --- a/tools.html +++ b/tools.html @@ -1,6 +1,6 @@ -
home-manager +
home-manager — reconfigure a user environment
home-manager {
build
|
@@ -84,7 +84,7 @@
|
--verbose
}
- ]
This command updates the user environment so that it corresponds to the
configuration specified in ~/.config/nixpkgs/home.nix or ~/.config/nixpkgs/flake.nix.
@@ -153,7 +153,7 @@ available for immediate garbage collection.
-
The tool accepts the options
-A attrPath
@@ -265,15 +265,15 @@
--verbose
Activates verbose output. -