06/07: doc: Mention .bashrc vs. .bash_profile for 'guix environment'.

[Ludovic Courtès]

civodul pushed a commit to branch wip-environment
in repository guix.

commit 3e54697b01252e391fcfa489696432ce6c24a6eb
Author: Ludovic Courtès <address@hidden>
Date:   Wed Jul 1 14:01:02 2015 +0200

    doc: Mention .bashrc vs. .bash_profile for 'guix environment'.
    
    * doc/guix.texi (Invoking guix environment): Add footnote about .bashrc
      vs. .bash_profile.
---
 doc/guix.texi |   10 +++++++++-
 1 files changed, 9 insertions(+), 1 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 119c2d9..a35ea2f 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -4136,7 +4136,15 @@ version of the environment that @command{guix 
environment} was run in.
 It contains the necessary search paths for building the given package
 added to the existing environment variables.  To create a ``pure''
 environment in which the original environment variables have been unset,
-use the @code{--pure} option.
+use the @code{--pure} address@hidden sometimes wrongfully augment
+environment variables such as @code{PATH} in their @file{~/.bashrc}
+file.  As a consequence, when @code{guix environment} launches it, Bash
+may read @file{~/.bashrc}, thereby introducing ``impurities'' in these
+environment variables.  It is an error to define such environment
+variables in @file{.bashrc}; instead, they should be defined in
address@hidden, which is sourced only by log-in shells.
address@hidden Startup Files,,, bash, The GNU Bash Reference Manual}, for
+details on Bash start-up files.}.
 
 Additionally, more than one package may be specified, in which case the
 union of the inputs for the given packages are used.  For example, the