man/make.conf.5: Document shlex a bit, bug 309941

diff --git a/man/make.conf.5 b/man/make.conf.5
index 236fdf0c49eb170d4d09606f8e25b5cbbd16c12d..f83dd0392770ccf43fc69414cf3ca87b6cfc94b7 100644 (file)
--- 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