summary refs log tree commit diff
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)
downloadguix-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