me
/
guix
Archived
1
0
Fork 0

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.
master
Ludovic Courtès 2021-03-17 10:35:27 +01:00
parent bc3896db25
commit 0571aa7abf
No known key found for this signature in database
GPG Key ID: 090B11993D9AEBB5
1 changed files with 11 additions and 2 deletions

View File

@ -2751,7 +2751,11 @@ you can go ahead and install it (run this command as a regular user,
guix install emacs guix install emacs
@end example @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 probably noticed that Guix downloaded pre-built binaries; or, if you
explicitly chose to @emph{not} use pre-built binaries, then probably explicitly chose to @emph{not} use pre-built binaries, then probably
Guix is still building software (@pxref{Substitutes}, for more info). 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 removing packages
@cindex package installation @cindex package installation
@cindex package removal @cindex package removal
@cindex profile
The @command{guix package} command is the tool that allows users to The @command{guix package} command is the tool that allows users to
install, upgrade, and remove packages, as well as rolling back 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 and works with normal user privileges (@pxref{Features}). Its syntax
is: is:
@ -3386,6 +3394,7 @@ variable, even though, taken individually, neither @file{foo} nor
@file{bar} would lead to that recommendation. @file{bar} would lead to that recommendation.
@cindex profile, choosing
@item --profile=@var{profile} @item --profile=@var{profile}
@itemx -p @var{profile} @itemx -p @var{profile}
Use @var{profile} instead of the user's default profile. Use @var{profile} instead of the user's default profile.