01/02: doc: Suggest unpacking with --warning=no-timestamp.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guix.

commit 254b1c2e95bfbf5af351ebf65d620df04311d4f8
Author: Ludovic Courtès <address@hidden>
Date:   Wed Jul 22 23:34:25 2015 +0200

    doc: Suggest unpacking with --warning=no-timestamp.
    
    Suggested by Malcolm Cook <address@hidden>.
    
    * doc/guix.texi (Binary Installation): Suggest --warning=no-timestamp.
---
 doc/guix.texi |   17 ++++++++++-------
 1 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 09c7faf..b4003d8 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -300,7 +300,8 @@ As @code{root}, run:
 
 @example
 # cd /tmp
-# tar xf address@hidden@var{system}.tar.xz
+# tar --warning=no-timestamp -xf \
+     address@hidden@var{system}.tar.xz
 # mv var/guix /var/ && mv gnu /
 @end example
 
@@ -308,15 +309,17 @@ This creates @file{/gnu/store} (@pxref{The Store}) and 
@file{/var/guix}.
 The latter contains a ready-to-use profile for @code{root} (see next
 step.)
 
-Some versions of address@hidden raise a warning about ``implausibly old
-time stamps''.  This is because all the files in the archive have their
-modification time set to zero (which means January 1st, 1970.)  This is
-done on purpose to make sure the archive content is independent of its
-creation time, thus making it reproducible.
-
 Do @emph{not} unpack the tarball on a working Guix system since that
 would overwrite its own essential files.
 
+The @code{--warning=no-timestamp} option makes sure address@hidden does
+not emit warnings about ``implausibly old time stamps''.  These
+warnings, sometimes enabled by default, stem from the fact that all the
+files in the archive have their modification time set to zero (which
+means January 1st, 1970.)  This is done on purpose to make sure the
+archive content is independent of its creation time, thus making it
+reproducible.
+
 @item
 Make @code{root}'s profile available under @file{~/.guix-profile}: