summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2013-01-11 16:16:36 +0100
committerLudovic Courtès <ludo@gnu.org>2013-01-11 16:16:36 +0100
commitb22a12fda7d0afc1640982fed37eda435cb3da38 (patch)
treeab8a7879654deb7afea7eb7ddcfb36f5acc00d82
parent01e354eb83299d00ddd6ba4beb73bac8130beeae (diff)
downloadgnu-guix-b22a12fda7d0afc1640982fed37eda435cb3da38.tar
gnu-guix-b22a12fda7d0afc1640982fed37eda435cb3da38.tar.gz
doc: Mention store sharing with Nix; update `package' example.
* doc/guix.texi: Set @documentlanguage. (Installation): Add reference to `INSTALL' and `README'. (Requirements): Mention store sharing with Nix. (Defining Packages): Update example to include `use-modules' clauses and to use (guix licenses).
-rw-r--r--doc/guix.texi22
1 files changed, 21 insertions, 1 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 2af0c88133..663c73fc38 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -4,6 +4,7 @@
@c %**start of header
@setfilename guix.info
@documentencoding UTF-8
+@documentlanguage en
@settitle GNU Guix Reference Manual
@c %**end of header
@@ -138,6 +139,10 @@ The remainder of this manual describes them.
This section describes the software requirements of Guix, as well as how
to install it and get ready to use it.
+The build procedure for Guix is the same as for other GNU software, and
+are not covered here. Please see the files @file{README} and
+@file{INSTALL} in the Guix source tree for additional details.
+
@menu
* Requirements:: Software needed to build and run Guix.
* Setting Up the Daemon:: Preparing the build daemon's environment.
@@ -167,6 +172,16 @@ When a working installation of the Nix package manager is available, you
can instead configure Guix with @code{--disable-daemon}. In that case,
@url{http://nixos.org/nix/, Nix} replaces the three dependencies above.
+Guix is compatible with Nix, so it is possible to share the same store
+between both. To do so, you must pass @command{configure} not only the
+same @code{--with-store-dir} value, but also the same
+@code{--localstatedir} value (the latter is essential because it
+specifies where the database that store meta-data about the store is
+located, among other things.) The default values are
+@code{--with-store-dir=/nix/store} and @code{--localstatedir=/nix/var}.
+Note that @code{--disable-daemon} is orthogonal and is not required if
+your goal is to share the same store as Nix.
+
@node Setting Up the Daemon
@section Setting Up the Daemon
@@ -595,6 +610,11 @@ example, the package definition, or @dfn{recipe}, for the GNU Hello
package looks like this:
@example
+(use-modules (guix packages)
+ (guix download)
+ (guix build-system gnu)
+ (guix licenses))
+
(define hello
(package
(name "hello")
@@ -610,7 +630,7 @@ package looks like this:
(synopsis "GNU Hello")
(description "Yeah...")
(home-page "http://www.gnu.org/software/hello/")
- (license "GPLv3+")))
+ (license gpl3+)))
@end example
@noindent