>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