aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2021-03-17 10:35:27 +0100
committerLudovic Courtès <ludo@gnu.org>2021-03-17 12:03:23 +0100
commit0571aa7abf262f617add727ac03e3bf63d41ae6d (patch)
tree57649b444cf6ac6720998f4fef3526c3982bad5c
parentbc3896db25c788c181c7bcd65754e7cd378e9d9f (diff)
downloadguix-0571aa7abf262f617add727ac03e3bf63d41ae6d.tar
guix-0571aa7abf262f617add727ac03e3bf63d41ae6d.tar.gz
doc: Define the term "profile".
Fixes <https://bugs.gnu.org/46803>. Reported by Luis Felipe <luis.felipe.la@protonmail.com>. * doc/guix.texi (Getting Started): Introduce the term "profile". (Invoking guix package): Likewise.
-rw-r--r--doc/guix.texi13
1 files changed, 11 insertions, 2 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 410670e639..7882937911 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -2751,7 +2751,11 @@ you can go ahead and install it (run this command as a regular user,
guix install emacs
@end example
-You've installed your first package, congrats! In the process, you've
+@cindex profile
+You've installed your first package, congrats! The package is now
+visible in your default @dfn{profile}, @file{$HOME/.guix-profile}---a
+profile is a directory containing installed packages.
+In the process, you've
probably noticed that Guix downloaded pre-built binaries; or, if you
explicitly chose to @emph{not} use pre-built binaries, then probably
Guix is still building software (@pxref{Substitutes}, for more info).
@@ -3059,9 +3063,13 @@ retaining precise @dfn{provenance tracking} of the software.
@cindex removing packages
@cindex package installation
@cindex package removal
+@cindex profile
The @command{guix package} command is the tool that allows users to
install, upgrade, and remove packages, as well as rolling back to
-previous configurations. It operates only on the user's own profile,
+previous configurations. These operations work on a user
+@dfn{profile}---a directory of installed packages. Each user has a
+default profile in @file{$HOME/.guix-profile}.
+The command operates only on the user's own profile,
and works with normal user privileges (@pxref{Features}). Its syntax
is:
@@ -3386,6 +3394,7 @@ variable, even though, taken individually, neither @file{foo} nor
@file{bar} would lead to that recommendation.
+@cindex profile, choosing
@item --profile=@var{profile}
@itemx -p @var{profile}
Use @var{profile} instead of the user's default profile.