This pattern rule was unwisely hidden in `src/libstore/local.mk`. Now it is properly in `mk/` and we reuse it for the profile docs too.
1.2 KiB
1.2 KiB
R""(
Description
nix profile allows you to create and manage Nix profiles. A Nix
profile is a set of packages that can be installed and upgraded
independently from each other. Nix profiles are versioned, allowing
them to be rolled back easily.
Files
)""
#include "doc/files/profiles.md.gen.hh"
R""(
Profile compatibility
Warning
Once you have used
nix profileyou can no longer usenix-envwithout first deleting$XDG_STATE_HOME/nix/profiles/profile
Once you installed a package with nix profile, you get the following error message when using nix-env:
$ nix-env -f '<nixpkgs>' -iA 'hello'
error: nix-env
profile '/home/alice/.local/state/nix/profiles/profile' is incompatible with 'nix-env'; please use 'nix profile' instead
To migrate back to nix-env you can delete your current profile:
Warning
This will delete packages that have been installed before, so you may want to back up this information before running the command.
$ rm -rf "${XDG_STATE_HOME-$HOME/.local/state}/nix/profiles/profile"
)""