From 6798a8e485281f855c0777d3f952b4e02953cfd2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ludovic=20Court=C3=A8s?= Date: Wed, 23 Jan 2013 16:45:36 +0100 Subject: 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 . --- doc/guix.texi | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) (limited to 'doc') 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} -- cgit v1.2.3