Using the Home Manager
======================

Installing a new Configuration
------------------------------

You should create a file that contains your home configuration. This file can
easily be kept in version control with git for instance. The file looks
like this:

```scm
(use-modules (home))

(home "/data/alice" '())
```

Home Reference
--------------

**Scheme Procedure**: (use-home-modules module-name ...)

Import home modules with name _module-name_. For instance,

```scm
(use-home-modules openbox hexchat)
```

is equivalent to:

```scm
(use-modules (home openbox)
             (home hexchat))
```

**Scheme Procedure**: (home basedir inputs #:guix-symlink #:guix-config-symlink #:local-symlink #:cache-symlink))

Create a package that can then be installed with `guix package -f` from _inputs_
and essential configuration. _inputs_ must be a list of inputs, namely a list
of file-like objects. The resulting package is a union of all the inputs, with
the addition of a few essential symlinks.

By default, when no input is given, and no keyword argument is used, these
symlinks are created:

* `~/.guix-profile` → `${basedir}/.guix-profile`
* `~/.config/guix` → `${basedir}/.config/guix`
* `~/.local` → `${basedir}/.local`
* `~/.cache` → `${basedir}/.cache`

When the corresponding keyword argument is used, the associated path is used as
the target of the symbolic link.