summary refs log tree commit diff
path: root/doc/guix.texi
diff options
context:
space:
mode:
authorChris Marusich <cmmarusich@gmail.com>2016-03-30 02:43:16 -0700
committerLudovic Courtès <ludo@gnu.org>2016-03-30 23:39:47 +0200
commit8a46205b418605bcbd64b12426239f10c2113ff4 (patch)
treebe98db66cc9d1844cbe1af7cd7213549ecb626d0 /doc/guix.texi
parent12af303f4736b19679142047327e55898e18eb9d (diff)
downloadguix-8a46205b418605bcbd64b12426239f10c2113ff4.tar.gz
doc: Clarify how to use the '#:python' parameter.
* doc/guix.texi (Build Systems): Clearly distinguish between the package that
provides the Python interpreter for the build and the package that is to be
built.  Also, mention why one might want to use a specific Python version.

Signed-off-by: Ludovic Courtès <ludo@gnu.org>
Diffstat (limited to 'doc/guix.texi')
-rw-r--r--doc/guix.texi7
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 1a7f18871b..7a27ab3c5a 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -2854,8 +2854,11 @@ For packages that install stand-alone Python programs under @code{bin/},
 it takes care of wrapping these programs so that their @code{PYTHONPATH}
 environment variable points to all the Python libraries they depend on.
 
-Which Python package is used can be specified with the @code{#:python}
-parameter.
+Which Python package is used to perform the build can be specified with
+the @code{#:python} parameter.  This is a useful way to force a package
+to be built for a specific version of the Python interpreter, which
+might be necessary if the package is only compatible with a single
+interpreter version.
 @end defvr
 
 @defvr {Scheme Variable} perl-build-system