From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from eggs.gnu.org ([2001:470:142:3::10]:51088)
 by lists.gnu.org with esmtp (Exim 4.86_2)
 (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1hmzE8-000852-DD
 for guix-patches@gnu.org; Mon, 15 Jul 2019 07:33:05 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1hmzE7-0005LH-1a
 for guix-patches@gnu.org; Mon, 15 Jul 2019 07:33:04 -0400
Received: from debbugs.gnu.org ([209.51.188.43]:37882)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
 id 1hmzE6-0005Kx-Ta
 for guix-patches@gnu.org; Mon, 15 Jul 2019 07:33:02 -0400
Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
 (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1hmzE6-00088O-CL
 for guix-patches@gnu.org; Mon, 15 Jul 2019 07:33:02 -0400
Subject: [bug#36311] doc: Add subsection and note about environment variables.
Resent-Message-ID: <handler.36311.B36311.156319036231243@debbugs.gnu.org>
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
References: <d564fea7-f3a5-3798-c186-a66c4c23f7a1@riseup.net>
 <46ddf909-ff9f-4d40-b229-e594bf06eeaf@riseup.net>
Date: Mon, 15 Jul 2019 13:32:09 +0200
In-Reply-To: <46ddf909-ff9f-4d40-b229-e594bf06eeaf@riseup.net>
 (swedebugia@riseup.net's message of "Mon, 15 Jul 2019 13:01:56 +0200")
Message-ID: <87wogjmt3a.fsf@nicolasgoaziou.fr>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
List-Id: <guix-patches.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-patches>,
 <mailto:guix-patches-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/guix-patches>
List-Post: <mailto:guix-patches@gnu.org>
List-Help: <mailto:guix-patches-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-patches>,
 <mailto:guix-patches-request@gnu.org?subject=subscribe>
Errors-To: guix-patches-bounces+kyle=kyleam.com@gnu.org
Sender: "Guix-patches" <guix-patches-bounces+kyle=kyleam.com@gnu.org>
To: swedebugia <swedebugia@riseup.net>
Cc: 36311@debbugs.gnu.org

Hello,

swedebugia <swedebugia@riseup.net> writes:

>> +Following the installation we recommend putting all environment variabl=
es into
>> + @file{~.bash_profile} to make sure they are only executed when your lo=
gin to
>> + a shell (ie. open up a virtual terminal).

I think @file{~/.bash_profile} is clearer.

Also "ie. open up=E2=80=A6" -> "i.e., open up=E2=80=A6" or "i.e.@: open up=
=E2=80=A6"

>> +If you use bash and put them into @file{.bashrc} you will end up with e=
rrors
>> +because this file is executed by bash EVERY time a new environment is e=
ntered

Maybe @emph{every}, since emphasizing with capitals is typographically
suboptimal.

>> +(e.g. when entering a pure environment with @command{guix environment g=
uix
>> +--pure} and contaminate the environment).

"e.g. when" -> "e.g., when" or "e.g.@: when".=20

See (info "Not Ending a Sentence") for more information.

Also, according to (info "@command"), it shoud be either @samp or @code.
After a cursory look, "guix.texi" seems to use "@code" for entire shell
command invocations.

HTH,

--=20
Nicolas Goaziou