summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2013-01-23 16:45:36 +0100
committerLudovic Courtès <ludo@gnu.org>2013-01-23 23:33:09 +0100
commit6798a8e485281f855c0777d3f952b4e02953cfd2 (patch)
tree414650c51aea46768825d1102017b9211922dfe6 /doc
parent6e4da6ead1f0496cee60b28ea8e27a90258d34af (diff)
downloadpatches-6798a8e485281f855c0777d3f952b4e02953cfd2.tar
patches-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')
-rw-r--r--doc/guix.texi10
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}