04/05: doc: Clarify how to run 'guix refresh -u'.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guix.

commit 38e16b49073dd9ea81c3320a84708c4b4d7c60e6
Author: Ludovic Courtès <address@hidden>
Date:   Tue Oct 6 23:35:50 2015 +0200

    doc: Clarify how to run 'guix refresh -u'.
    
    * doc/guix.texi (Invoking guix refresh): Mention ./pre-inst-env.
---
 doc/guix.texi |   11 +++++++++--
 1 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 6a3765f..6da7281 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -4132,7 +4132,14 @@ The following options are supported:
 
 @item --update
 @itemx -u
-Update distribution source files (package recipes) in place.
+Update distribution source files (package recipes) in place.  This is
+usually run from a checkout of the Guix source tree (@pxref{Running
+Guix Before It Is Installed}):
+
address@hidden
+$ ./pre-inst-env guix refresh -s non-core
address@hidden example
+
 @xref{Defining Packages}, for more information on package definitions.
 
 @item address@hidden
@@ -4157,7 +4164,7 @@ In addition, @command{guix refresh} can be passed one or 
more package
 names, as in this example:
 
 @example
-guix refresh -u emacs idutils gcc-4.8.4
+$ ./pre-inst-env guix refresh -u emacs idutils gcc-4.8.4
 @end example
 
 @noindent