diff options
| author | Ludovic Courtès <ludo@gnu.org> | 2013-01-23 16:45:36 +0100 |
|---|---|---|
| committer | Ludovic Courtès <ludo@gnu.org> | 2013-01-23 23:33:09 +0100 |
| commit | 6798a8e485281f855c0777d3f952b4e02953cfd2 (patch) | |
| tree | 414650c51aea46768825d1102017b9211922dfe6 /doc/guix.texi | |
| parent | 6e4da6ead1f0496cee60b28ea8e27a90258d34af (diff) | |
| download | gnu-guix-6798a8e485281f855c0777d3f952b4e02953cfd2.tar gnu-guix-6798a8e485281f855c0777d3f952b4e02953cfd2.tar.gz | |
doc: Clarify that `guix-build' really is for developers.
* doc/guix.texi (Invoking guix-build): Make it clear that `guix-build'
doesn't access the user's profile, and add cross-ref to `guix-package'.
Suggested by Nikita Karetnikov <nikita@karetnikov.org>.
Diffstat (limited to 'doc/guix.texi')
| -rw-r--r-- | doc/guix.texi | 10 |
1 files changed, 7 insertions, 3 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index f0d773d08e..e1ca095daa 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -982,8 +982,12 @@ space. @section Invoking @command{guix-build} The @command{guix-build} command builds packages or derivations and -their dependencies, and prints the resulting store paths. It is mainly -useful for distribution developers. The general syntax is: +their dependencies, and prints the resulting store paths. Note that it +does not modify the user's profile---this is the job of the +@command{guix-package} command (@pxref{Invoking guix-package}). Thus, +it is mainly useful for distribution developers. + +The general syntax is: @example guix-build @var{options} @var{package-or-derivation}@dots{} @@ -1015,7 +1019,7 @@ Build the packages' source derivations, rather than the packages themselves. For instance, @code{guix-build -S gcc} returns something like -@file{/nix/store/xxx-gcc-4.7.2.tar.bz2}, which is GCC's source tarball. +@file{/nix/store/@dots{}-gcc-4.7.2.tar.bz2}, which is GCC's source tarball. @item --system=@var{system} @itemx -s @var{system} |