mirror of
https://github.com/nix-community/home-manager
synced 2024-07-07 13:53:27 +02:00
80ac72bf03
The `optionsDocBook` function is deprecated in nixpkgs since nixos-23.11. This commit updates the manual and manpages to use commonmark formatted documentation instead of the deprecated docbook format.
37 lines
928 B
Markdown
37 lines
928 B
Markdown
# Keeping your \~ safe from harm {#sec-usage-dotfiles}
|
|
|
|
To configure programs and services Home Manager must write various
|
|
things to your home directory. To prevent overwriting any existing files
|
|
when switching to a new generation, Home Manager will attempt to detect
|
|
collisions between existing files and generated files. If any such
|
|
collision is detected the activation will terminate before changing
|
|
anything on your computer.
|
|
|
|
For example, suppose you have a wonderful, painstakingly created
|
|
`~/.config/git/config` and add
|
|
|
|
``` nix
|
|
{
|
|
# …
|
|
|
|
programs.git = {
|
|
enable = true;
|
|
userName = "Jane Doe";
|
|
userEmail = "jane.doe@example.org";
|
|
};
|
|
|
|
# …
|
|
}
|
|
```
|
|
|
|
to your configuration. Attempting to switch to the generation will then
|
|
result in
|
|
|
|
``` console
|
|
$ home-manager switch
|
|
…
|
|
Activating checkLinkTargets
|
|
Existing file '/home/jdoe/.config/git/config' is in the way
|
|
Please move the above files and try again
|
|
```
|