05/05: doc: "Invoking guix refresh" links to '--with-latest'.

[guix-commits]

civodul pushed a commit to branch master
in repository guix.

commit 0d8cea4f247272a36c307276253f014f271f1b56
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Fri Mar 26 00:03:22 2021 +0100

    doc: "Invoking guix refresh" links to '--with-latest'.
    
    * doc/guix.texi (Invoking guix refresh): Reword intro and Link to
    '--with-latest'.
---
 doc/guix.texi | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 4333faf..c23d044 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -11567,10 +11567,13 @@ is welcome here (@pxref{Contributing}).
 @section Invoking @command{guix refresh}
 
 @cindex @command {guix refresh}
-The primary audience of the @command{guix refresh} command is developers
-of the GNU software distribution.  By default, it reports any packages
-provided by the distribution that are outdated compared to the latest
-upstream version, like this:
+The primary audience of the @command{guix refresh} command is packagers.
+As a user, you may be interested in the @option{--with-latest} option,
+which can bring you package update superpowers built upon @command{guix
+refresh} (@pxref{Package Transformation Options,
+@option{--with-latest}}).  By default, @command{guix refresh} reports
+any packages provided by the distribution that are outdated compared to
+the latest upstream version, like this:
 
 @example
 $ guix refresh