-*- mode: org -*-

[[https://www.gnu.org/software/guix/][GNU Guix]] (IPA: /ɡiːks/) is a purely functional package manager, and
associated free software distribution, for the [[https://www.gnu.org/gnu/gnu.html][GNU system]].  In addition
to standard package management features, Guix supports transactional
upgrades and roll-backs, unprivileged package management, per-user
profiles, and garbage collection.

It provides [[https://www.gnu.org/software/guile/][Guile]] Scheme APIs, including a high-level embedded
domain-specific languages (EDSLs) to describe how packages are to be
built and composed.

GNU Guix can be used on top of an already-installed GNU/Linux distribution, or
it can be used standalone (we call that “Guix System”).

Guix is based on the [[https://nixos.org/nix/][Nix]] package manager.


* Requirements

If you are building Guix from source, please see the manual for build
instructions and requirements, either by running:

  info -f doc/guix.info "Requirements"

or by checking the [[https://guix.gnu.org/manual/en/html_node/Requirements.html][web copy of the manual]].

* Installation

See the manual for the installation instructions, either by running

  info -f doc/guix.info "Installation"

or by checking the [[https://guix.gnu.org/manual/en/html_node/Installation.html][web copy of the manual]].

* Building from Git

For information on building Guix from a Git checkout, please see the relevant
section in the manual, either by running

  info -f doc/guix.info "Building from Git"

or by checking the [[https://guix.gnu.org/manual/en/html_node/Building-from-Git.html][web_copy of the manual]].

* How It Works

Guix does the high-level preparation of a /derivation/.  A derivation is
the promise of a build; it is stored as a text file under
=/gnu/store/xxx.drv=.  The (guix derivations) module provides the
`derivation' primitive, as well as higher-level wrappers such as
`build-expression->derivation'.

Guix does remote procedure calls<pre>
;; Per-directory local variables for GNU Emacs 23 and later.

((nil
  . ((fill-column . 78)
     (tab-width   .  8)
     (sentence-end-double-space . t)

     ;; For use with &apos;bug-reference-prog-mode&apos;.  Extra bug-reference
     ;; configuration should be done in your Emacs user configuration file;
     ;; refer to (info (guix) The Perfect Setup).
     (bug-reference-bug-regexp
      . &quot;\\(&lt;https?://\\bugs\\.gnu\\.org/\\([0-9]+\\)&gt;\\)&quot;)
     (bug-reference-url-format . &quot;https://issues.guix.gnu.org/%s&quot;)

     (eval . (add-to-list &apos;completion-ignored-extensions &quot;.go&quot;))

     ;; Emacs-Guix
     (eval . (setq-local guix-directory
                         (locate-dominating-file default-directory
                                                 &quot;.dir-locals.el&quot;)))

     ;; TempEl
     (eval . (with-eval-after-load
                 &apos;tempel
               (if (stringp tempel-path)
                   (setq tempel-path (list tempel-path)))
               (let ((guix-tempel-snippets
                      (concat
                       (expand-file-name
                        &quot;etc/snippets/tempel&quot;
                        (locate-dominating-file default-directory
                                                &quot;.dir-locals.el&quot;))
                       &quot;/*.eld&quot;)))
                 (unless (member guix-tempel-snippets tempel-path)
                   (add-to-list &apos;tempel-path guix-tempel-snippets)))))

     ;; YASnippet
     (eval . (with-eval-after-load
                 &apos;yasnippet
               (let ((guix-yasnippets
                      (expand-file-name
                       &quot;etc/snippets/yas&quot;
                       (locate-dominating-file default-directory
                                               &quot;.dir-locals.el&quot;))))
                 (unless (member guix-yasnippets yas-snippet-dirs)
                   (add-to-list &apos;yas-snippet-dirs guix-yasnippets)
                   (yas-reload-all)))))

     ;; Geiser
     ;; This allows automatically setting the `geiser-guile-load-path&apos;
     ;; variable when using various Guix checkouts (e.g., via git worktrees).
     (geiser-repl-per-project-p . t)))

 (c-mode          . ((c-file-style . &quot;gnu&quot;)))
 (scheme-mode
  .
  ((indent-tabs-mode . nil)
   (eval . (put &apos;eval-when &apos;scheme-indent-function 1))
   (eval . (put &apos;call-with-prompt &apos;scheme-indent-function 1))
   (eval . (put &apos;test-assert &apos;scheme-indent-function 1))
   (eval . (put &apos;test-assertm &apos;scheme-indent-function 1))
   (eval . (put &apos;test-equalm &apos;scheme-indent-function 1))
   (eval . (put &apos;test-equal &apos;scheme-indent-function 1))
   (eval . (put &apos;test-eq &apos;scheme-indent-function 1))
   (eval . (put &apos;call-with-input-string &apos;scheme-indent-functio