aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlexander Berntsen <alexander@plaimi.net>2013-08-11 23:32:42 +0200
committerZac Medico <zmedico@gentoo.org>2013-08-11 15:27:33 -0700
commitff54f5db6658c0bfecc7fe365d383c5879f20221 (patch)
tree9a51645b565e4e7bd656a1d08cd56062c8118571
parentCast uid/gid proxies to int for Python 3.4. (diff)
downloadportage-ff54f5db6658c0bfecc7fe365d383c5879f20221.tar.gz
portage-ff54f5db6658c0bfecc7fe365d383c5879f20221.tar.bz2
portage-ff54f5db6658c0bfecc7fe365d383c5879f20221.zip
man/make.conf.5: Document shlex a bit, bug 309941
-rw-r--r--man/make.conf.511
1 files changed, 10 insertions, 1 deletions
diff --git a/man/make.conf.5 b/man/make.conf.5
index 236fdf0c4..f83dd0392 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -4,7 +4,16 @@ make.conf \- custom settings for Portage
.SH "SYNOPSIS"
\fB/etc/make.conf\fR and \fB/etc/portage/make.conf\fR
.SH "DESCRIPTION"
-This file contains various variables that are used by Portage.
+
+This file contains various variables that are used by Portage. The file has a
+newline-delimited list of \fI<key>=<value>\fR pairs (see the default file for
+examples) which are accessible from the environment of ebuilds. It supports
+simple shell\-like expansion of the form \fIvar="${var}"\fR, the source
+keyword and variable substituton, but not some of the more advanced BASH
+features like arrays and special parameter expansions. For more details, see
+the Simple lexical analysis documentanion:
+\fLhttp://docs.python.org/3/library/shlex.html\fR.
+.br
Portage will check the currently\-defined environment variables
first for any settings. If no environment settings are found,
Portage then checks the make.conf files. Both /etc/make.conf and