doc: Explain that '--profile' expects a file name.

* doc/guix.texi (Invoking guix package): Explain that the argument to
--profile is a file name.
This commit is contained in:
Ludovic Courtès 2019-09-23 12:26:59 +02:00
parent 9338cbdbe0
commit cb3ee1c507
No known key found for this signature in database
GPG key ID: 090B11993D9AEBB5

View file

@ -2918,6 +2918,25 @@ variable, even though, taken individually, neither @file{foo} nor
@itemx -p @var{profile}
Use @var{profile} instead of the user's default profile.
@var{profile} must be the name of a file that will be created upon
completion. Concretely, @var{profile} will be a mere symbolic link
(``symlink'') pointing to the actual profile where packages are
installed:
@example
$ guix install hello -p ~/code/my-profile
@dots{}
$ ~/code/my-profile/bin/hello
Hello, world!
@end example
All it takes to get rid of the profile is to remove this symlink and its
siblings that point to specific generations:
@example
$ rm ~/code/my-profile ~/code/my-profile-*-link
@end example
@cindex collisions, in a profile
@cindex colliding packages in profiles
@cindex profile collisions