doc: Explain that "guix import" and "guix refresh" may need GnuPG.

Fixes <https://bugs.gnu.org/36051>.
Reported by Jesse Gibbons <jgibbons2357@gmail.com>.

* doc/guix.texi (Invoking guix import, Invoking guix refresh): Mention
that GnuPG must be installed.
This commit is contained in:
Ludovic Courtès 2019-09-02 11:28:18 +02:00
parent eb98d5a83c
commit d34e9114e6
No known key found for this signature in database
GPG key ID: 090B11993D9AEBB5

View file

@ -8509,8 +8509,13 @@ guix import @var{importer} @var{options}@dots{}
@var{importer} specifies the source from which to import package @var{importer} specifies the source from which to import package
metadata, and @var{options} specifies a package identifier and other metadata, and @var{options} specifies a package identifier and other
options specific to @var{importer}. Currently, the available options specific to @var{importer}.
``importers'' are:
Some of the importers rely on the ability to run the @command{gpgv} command.
For these, GnuPG must be installed and in @code{$PATH}; run @code{guix install
gnupg} if needed.
Currently, the available ``importers'' are:
@table @code @table @code
@item gnu @item gnu
@ -8959,7 +8964,10 @@ update the version numbers and source tarball hashes of those package
recipes (@pxref{Defining Packages}). This is achieved by downloading recipes (@pxref{Defining Packages}). This is achieved by downloading
each package's latest source tarball and its associated OpenPGP each package's latest source tarball and its associated OpenPGP
signature, authenticating the downloaded tarball against its signature signature, authenticating the downloaded tarball against its signature
using @command{gpg}, and finally computing its hash. When the public using @command{gpgv}, and finally computing its hash---note that GnuPG must be
installed and in @code{$PATH}; run @code{guix install gnupg} if needed.
When the public
key used to sign the tarball is missing from the user's keyring, an key used to sign the tarball is missing from the user's keyring, an
attempt is made to automatically retrieve it from a public key server; attempt is made to automatically retrieve it from a public key server;
when this is successful, the key is added to the user's keyring; otherwise, when this is successful, the key is added to the user's keyring; otherwise,