summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2014-11-10 15:11:35 +0100
committerLudovic Courtès <ludo@gnu.org>2014-11-10 15:11:35 +0100
commitf5fd4fd237624316a35ee60c587a3d207f08b2a4 (patch)
tree591f244ee844a4987860190525d5a3e1044283de /doc
parent0c4b00d8519a2d93e7c35af263850847fcbe0e58 (diff)
downloadpatches-f5fd4fd237624316a35ee60c587a3d207f08b2a4.tar
patches-f5fd4fd237624316a35ee60c587a3d207f08b2a4.tar.gz
doc: Mention 'guix environment' in "Features"; add index entries.
* doc/guix.texi (Features): Add paragraph about 'guix environment'. (Build Systems): Add @cindex. (Invoking guix environment): Ditto.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 2ebf56f111..c7f72d76d1 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -694,6 +694,12 @@ downloads it and unpacks it;
otherwise, it builds the package from source, locally
(@pxref{Substitutes}).
+Control over the build environment is a feature that is also useful for
+developers. The @command{guix environment} command allows developers of
+a package to quickly set up the right development environment for their
+package, without having to manually install the package's dependencies
+in their profile (@pxref{Invoking guix environment}).
+
@node Invoking guix package
@section Invoking @command{guix package}
@@ -1576,6 +1582,7 @@ Build systems are @code{<build-system>} objects. The interface to
create and manipulate them is provided by the @code{(guix build-system)}
module, and actual build systems are exported by specific modules.
+@cindex bag (low-level package representation)
Under the hood, build systems first compile package objects to
@dfn{bags}. A @dfn{bag} is like a package, but with less
ornamentation---in other words, a bag is a lower-level representation of
@@ -2894,6 +2901,7 @@ and exit.
@node Invoking guix environment
@section Invoking @command{guix environment}
+@cindex reproducible build environments
The purpose of @command{guix environment} is to assist hackers in
creating reproducible development environments without polluting their
package profile. The @command{guix environment} tool takes one or more