diff options
| author | Ludovic Courtès <ludo@gnu.org> | 2021-03-17 10:35:27 +0100 |
|---|---|---|
| committer | Ludovic Courtès <ludo@gnu.org> | 2021-03-17 12:03:23 +0100 |
| commit | 0571aa7abf262f617add727ac03e3bf63d41ae6d (patch) | |
| tree | 57649b444cf6ac6720998f4fef3526c3982bad5c | |
| parent | bc3896db25c788c181c7bcd65754e7cd378e9d9f (diff) | |
| download | guix-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.texi | 13 |
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. |