From 38e16b49073dd9ea81c3320a84708c4b4d7c60e6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ludovic=20Court=C3=A8s?= <ludo@gnu.org>
Date: Tue, 6 Oct 2015 23:35:50 +0200
Subject: [PATCH] doc: Clarify how to run 'guix refresh -u'.

* doc/guix.texi (Invoking guix refresh): Mention ./pre-inst-env.
---
 doc/guix.texi | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 6a3765f56a..6da7281566 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}):
+
+@example
+$ ./pre-inst-env guix refresh -s non-core
+@end example
+
 @xref{Defining Packages}, for more information on package definitions.
 
 @item --select=[@var{subset}]
@@ -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