From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([209.51.188.92]:36881) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hdzlG-0002f0-On for guix-patches@gnu.org; Thu, 20 Jun 2019 12:18:09 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hdzlD-0006Er-ES for guix-patches@gnu.org; Thu, 20 Jun 2019 12:18:06 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:35632) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hdzlC-0006DG-5V for guix-patches@gnu.org; Thu, 20 Jun 2019 12:18:03 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hdzlB-0003vE-VZ for guix-patches@gnu.org; Thu, 20 Jun 2019 12:18:02 -0400 Subject: [bug#36311] doc: Add subsection and note about environment variables. Resent-Message-ID: Received: from eggs.gnu.org ([209.51.188.92]:36566) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hdzka-0002An-Bn for guix-patches@gnu.org; Thu, 20 Jun 2019 12:17:25 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hdzhI-0001qa-IN for guix-patches@gnu.org; Thu, 20 Jun 2019 12:14:01 -0400 Received: from mx1.riseup.net ([198.252.153.129]:48652) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hdzhI-0001pK-5A for guix-patches@gnu.org; Thu, 20 Jun 2019 12:14:00 -0400 Received: from capuchin.riseup.net (capuchin-pn.riseup.net [10.0.1.176]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client CN "*.riseup.net", Issuer "COMODO RSA Domain Validation Secure Server CA" (verified OK)) by mx1.riseup.net (Postfix) with ESMTPS id 212E01A30E3 for ; Thu, 20 Jun 2019 09:13:59 -0700 (PDT) Received: from [127.0.0.1] (localhost [127.0.0.1]) by capuchin.riseup.net (Postfix) with ESMTPSA id 7C06B120984 for ; Thu, 20 Jun 2019 09:13:58 -0700 (PDT) From: swedebugia Message-ID: Date: Thu, 20 Jun 2019 18:13:55 +0200 MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="------------C442C8E472733CB3F7CDE324" Content-Language: en-US List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+kyle=kyleam.com@gnu.org Sender: "Guix-patches" To: 36311@debbugs.gnu.org This is a multi-part message in MIME format. --------------C442C8E472733CB3F7CDE324 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit -- Cheers Swedebugia --------------C442C8E472733CB3F7CDE324 Content-Type: text/x-patch; name="0001-doc-Add-subsection-and-note-about-environment-variab.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename*0="0001-doc-Add-subsection-and-note-about-environment-variab.pa"; filename*1="tch" >From f7507682af3b4072596e36321b5ec240e7ab3a10 Mon Sep 17 00:00:00 2001 From: swedebugia Date: Thu, 20 Jun 2019 18:02:16 +0200 Subject: [PATCH] doc: Add subsection and note about environment variables. * doc/guix.texi (Binary Installation and Application Setup): Clarify the importance of correct environment variables. --- doc/guix.texi | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/doc/guix.texi b/doc/guix.texi index 65c3b8a7f..470157669 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -601,7 +601,9 @@ where @command{guix pull} will install updates (@pxref{Invoking guix pull}): ~root/.config/guix/current @end example -Source @file{etc/profile} to augment @code{PATH} and other relevant +@c This is explained further in @node Application Setup - Importance of +@c environment variables +Source @file{etc/profile} from @file{~.bash_profile} to augment @code{PATH} and other relevant environment variables: @example @@ -1575,6 +1577,20 @@ When using Guix on top of GNU/Linux distribution other than Guix System---a so-called @dfn{foreign distro}---a few additional steps are needed to get everything in place. Here are some of them. +@subsection Importance of environment variables +@cindex environment variables +Environment variables in the correct place are essential to the correct +operation of guix in a foreign system. + +Following the installation we recommend putting all environment variables into + @file{~.bash_profile} to make sure they are only executed when your login to + a shell (ie. open up a virtual terminal). + +If you use bash and put them into @file{.bashrc} you will end up with errors +because this file is executed by bash EVERY time a new environment is entered +(e.g. when entering a pure environment with @command{guix environment guix +--pure} and contaminate the environment). + @subsection Locales @anchor{locales-and-locpath} -- 2.19.2 --------------C442C8E472733CB3F7CDE324--