07/10: doc: Mention value /var to localstatedir option.

[guix-commits]

civodul pushed a commit to branch master
in repository guix.

commit 0758a70cc008171f31c848128deca9803536fe60
Author: zimoun <address@hidden>
Date:   Wed Nov 6 19:35:54 2019 +0100

    doc: Mention value /var to localstatedir option.
    
    * README (Installing Guix from Guix): Mention value /var to localstatedir 
option.
    * doc/contributing.texi (Building from Git): Likewise.
    * doc/guix.texi (Requirements): Likewise.
    
    Signed-off-by: Ludovic Courtès <address@hidden>
---
 README                | 3 ++-
 doc/contributing.texi | 3 ++-
 doc/guix.texi         | 5 +++--
 3 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/README b/README
index 02d6f71..7121358 100644
--- a/README
+++ b/README
@@ -63,7 +63,8 @@ To do so:
   - Re-run the 'configure' script passing it the option
     '--localstatedir=/somewhere', where '/somewhere' is the 'localstatedir'
     value of the currently installed Guix (failing to do that would lead the
-    new Guix to consider the store to be empty!).
+    new Guix to consider the store to be empty!).  We recommend to use the
+    value '/var'.
 
   - Run "make", "make check", and "make install".
 
diff --git a/doc/contributing.texi b/doc/contributing.texi
index 655c828..ee72b2f 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -94,7 +94,8 @@ more information.
 Then, run @command{./configure} as usual.  Make sure to pass
 @code{--localstatedir=@var{directory}} where @var{directory} is the
 @code{localstatedir} value used by your current installation (@pxref{The
-Store}, for information about this).
+Store}, for information about this).  We recommend to use the value
+@code{/var}.
 
 Finally, you have to invoke @code{make check} to run tests
 (@pxref{Running the Test Suite}).  If anything
diff --git a/doc/guix.texi b/doc/guix.texi
index 27cb31d..aaad6e3 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -792,8 +792,9 @@ When configuring Guix on a system that already has a Guix 
installation,
 be sure to specify the same state directory as the existing installation
 using the @code{--localstatedir} option of the @command{configure}
 script (@pxref{Directory Variables, @code{localstatedir},, standards,
-GNU Coding Standards}).  The @command{configure} script protects against
-unintended misconfiguration of @var{localstatedir} so you do not
+GNU Coding Standards}).  Usually, this @var{localstatedir} option is
+set to the value @file{/var}.  The @command{configure} script protects
+against unintended misconfiguration of @var{localstatedir} so you do not
 inadvertently corrupt your store (@pxref{The Store}).
 
 @node Running the Test Suite