From patchwork Thu Jun 20 16:13:55 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: swedebugia X-Patchwork-Id: 14359 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 030D517123; Thu, 20 Jun 2019 17:25:06 +0100 (BST) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_DKIM_INVALID, URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.0 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTP id 724FF17120 for ; Thu, 20 Jun 2019 17:25:05 +0100 (BST) Received: from localhost ([::1]:50194 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hdzry-0007i7-4Z for patchwork@mira.cbaines.net; Thu, 20 Jun 2019 12:25:02 -0400 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 X-Loop: help-debbugs@gnu.org Subject: [bug#36311] doc: Add subsection and note about environment variables. Resent-From: swedebugia Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 20 Jun 2019 16:18:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 36311 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: To: 36311@debbugs.gnu.org X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.156104744915023 (code B ref -1); Thu, 20 Jun 2019 16:18:01 +0000 Received: (at submit) by debbugs.gnu.org; 20 Jun 2019 16:17:29 +0000 Received: from localhost ([127.0.0.1]:49175 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hdzke-0003uE-RQ for submit@debbugs.gnu.org; Thu, 20 Jun 2019 12:17:29 -0400 Received: from lists.gnu.org ([209.51.188.17]:41808) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hdzkb-0003u5-QH for submit@debbugs.gnu.org; Thu, 20 Jun 2019 12:17:27 -0400 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) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1561047239; bh=EF04leGQ2wA9aBYZa6UuarZum414+9cmA1Gb8Qf09LU=; h=To:From:Subject:Date:From; b=ZAPqV4v2tLf0gZsnEOTgpe3C7+E8wcLqKOsDo8KzrCtkhTOQp6patPjRcXsfky1Pw NDDaq+c52oBOqwqkDKCodXVrG1YQP0rEjSF9zhHTw28VexrOYj3TJYmLgvk/JhlQsh QhEP10bKghDL0cL3NpBj8av3mcC1gt6bvjJZ2IPA= X-Riseup-User-ID: 2BFEBBACCF016E86B45878DD00CCF6C83B5FE4E4439BD5F0B2771FD27EC26454 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-Language: en-US X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: "Guix-patches" X-getmail-retrieved-from-mailbox: Patches 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