From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:470:142:3::10]:44543) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hmyl6-0003KR-4r for guix-patches@gnu.org; Mon, 15 Jul 2019 07:03:05 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hmyl4-0002V1-Vv for guix-patches@gnu.org; Mon, 15 Jul 2019 07:03:04 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:37777) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hmyl4-0002Ux-RG for guix-patches@gnu.org; Mon, 15 Jul 2019 07:03:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hmyl4-0002yw-Ki for guix-patches@gnu.org; Mon, 15 Jul 2019 07:03:02 -0400 Subject: [bug#36311] doc: Add subsection and note about environment variables. Resent-Message-ID: From: swedebugia References: Message-ID: <46ddf909-ff9f-4d40-b229-e594bf06eeaf@riseup.net> Date: Mon, 15 Jul 2019 13:01:56 +0200 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit 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 On 2019-06-20 18:13, swedebugia wrote: > > -- > Cheers Swedebugia > > 0001-doc-Add-subsection-and-note-about-environment-variab.patch > > 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 Anyone up for reviewing? -- Cheers Swedebugia