03/03: doc: Document 'http_proxy'.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guix.

commit e0c941fefa0769bd834cee220a640ce5b9b0c3f6
Author: Ludovic Courtès <address@hidden>
Date:   Mon Jan 18 15:28:30 2016 +0100

    doc: Document 'http_proxy'.
    
    * doc/guix.texi (Build Environment Setup, Substitutes): Document
    'http_proxy'.
---
 doc/guix.texi |   13 +++++++++++++
 1 files changed, 13 insertions(+), 0 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index a7da452..592ec3c 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -634,6 +634,11 @@ This way, the value of @code{TMPDIR} does not leak inside 
build
 environments, which avoids discrepancies in cases where build processes
 capture the name of their build tree.
 
address@hidden http_proxy
+The daemon also honors the @code{http_proxy} environment variable for
+HTTP downloads it performs, be it for fixed-output derivations
+(@pxref{Derivations}) or for substitutes (@pxref{Substitutes}).
+
 If you are installing Guix as an unprivileged user, it is still possible
 to run @command{guix-daemon} provided you pass @code{--disable-chroot}.
 However, build processes will not be isolated from one another, and not
@@ -1685,6 +1690,14 @@ Guix ignores substitutes that are not signed, or that 
are not signed by
 one of the keys listed in the ACL.  It also detects and raises an error
 when attempting to use a substitute that has been tampered with.
 
address@hidden http_proxy
+Substitutes are downloaded over HTTP.  The @code{http_proxy} environment
+variable can be set in the environment of @command{guix-daemon} and is
+honored for downloads of substitutes.  Note that the value of
address@hidden in the environment where @command{guix build},
address@hidden package}, and other client commands are run has
address@hidden no effect}.
+
 The substitute mechanism can be disabled globally by running
 @code{guix-daemon} with @code{--no-substitutes} (@pxref{Invoking
 guix-daemon}).  It can also be disabled temporarily by passing the