From f5fd4fd237624316a35ee60c587a3d207f08b2a4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ludovic=20Court=C3=A8s?= Date: Mon, 10 Nov 2014 15:11:35 +0100 Subject: [PATCH] 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. --- doc/guix.texi | 8 ++++++++ 1 file changed, 8 insertions(+) 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{} 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