From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jookia <166291@gmail.com> Subject: [PATCH] doc: Explain --localstatedir some more. Date: Thu, 10 Mar 2016 07:35:53 +1100 Message-ID: <56e089f1.cf0b1c0a.16f31.1c9a@mx.google.com> Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:46485) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from <166291@gmail.com>) id 1adkt4-0004BX-VO for guix-devel@gnu.org; Wed, 09 Mar 2016 15:39:19 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from <166291@gmail.com>) id 1adkt0-0006Vy-Ut for guix-devel@gnu.org; Wed, 09 Mar 2016 15:39:18 -0500 Received: from mail-wm0-x22c.google.com ([2a00:1450:400c:c09::22c]:37787) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <166291@gmail.com>) id 1adkt0-0006Vu-Nu for guix-devel@gnu.org; Wed, 09 Mar 2016 15:39:14 -0500 Received: by mail-wm0-x22c.google.com with SMTP id p65so2250179wmp.0 for ; Wed, 09 Mar 2016 12:39:14 -0800 (PST) Received: from localhost (tor-exit.squirrel.theremailer.net. [94.103.175.86]) by smtp.gmail.com with ESMTPSA id 198sm279864wml.22.2016.03.09.12.39.12 for (version=TLSv1/SSLv3 cipher=OTHER); Wed, 09 Mar 2016 12:39:13 -0800 (PST) List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: guix-devel@gnu.org This should hopefully stop people from running in to issues when building Guix from source as they have in the past. * doc/guix.texi (Requirements): Add explanation of the localstatedir flag. Discuss how to keep compatibility with binary installation and the package. --- doc/guix.texi | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 0e8e5ad..94323ff 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -16,8 +16,9 @@ Copyright @copyright{} 2013 Nikita Karetnikov@* Copyright @copyright{} 2015, 2016 Mathieu Lirzin@* Copyright @copyright{} 2014 Pierre-Antoine Rault@* Copyright @copyright{} 2015 Taylan Ulrich Bayırlı/Kammer@* -Copyright @copyright{} 2015, 2016 Leo Famulari -Copyright @copyright{} 2016 Ben Woodcroft +Copyright @copyright{} 2015, 2016 Leo Famulari@* +Copyright @copyright{} 2016 Ben Woodcroft@* +Copyright @copyright{} 2016 Jookia Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or @@ -514,6 +515,18 @@ manager} is available, you can instead configure Guix with @code{--disable-daemon}. In that case, Nix replaces the three dependencies above. +Tradionally Guix stores its state in @var{localstatedir} as most GNU +applications do. In certain situations you may want to change this setting, +by passing the @code{--localstatedir=@var{path}} flag to @command{configure}. + +The binary installation of Guix and the package of Guix both use @code{/var} as +their @var{localstatedir} path. If you wish to have compatibility with one of +these versions of Guix installed or you plan to install, passing +@code{--localstatedir=/var} to @command{configure} will allow your compiled Guix +to share state. Be warned that sharing the same Guix store (usually located at +@code{/gnu}) with different sets of state could cause issues such as garbage +collecting store entries that are alive in one Guix's state but not the other's. + Guix is compatible with Nix, so it is possible to share the same store between both. To do so, you must pass @command{configure} not only the same @code{--with-store-dir} value, but also the same -- 2.7.0