summaryrefslogtreecommitdiffstats
path: root/usr.bin/make/make.1
diff options
context:
space:
mode:
Diffstat (limited to 'usr.bin/make/make.1')
-rw-r--r--usr.bin/make/make.164
1 files changed, 33 insertions, 31 deletions
diff --git a/usr.bin/make/make.1 b/usr.bin/make/make.1
index 1d52291..f17ab88 100644
--- a/usr.bin/make/make.1
+++ b/usr.bin/make/make.1
@@ -32,7 +32,7 @@
.\" @(#)make.1 8.8 (Berkeley) 6/13/95
.\" $FreeBSD$
.\"
-.Dd March 4, 2008
+.Dd March 5, 2008
.Dt MAKE 1
.Os
.Sh NAME
@@ -648,7 +648,7 @@ last word in this variable.
.It Ev MAKEFLAGS
The environment variable
.Ev MAKEFLAGS
-may contain anything that
+may initially contain anything that
may be specified on
.Nm Ns 's
command line,
@@ -668,6 +668,29 @@ are appended to the
.Va .MAKEFLAGS
variable.
.Pp
+Whenever
+.Nm
+executes a program, it sets
+.Ev MAKEFLAGS
+in the program's environment to the current value of the
+.Va .MAKEFLAGS
+global variable.
+Thus, if
+.Ev MAKEFLAGS
+in
+.Nm Ns 's
+environment contains any
+.Fl f
+options, they will not be pushed down to child programs automatically.
+The
+.Nm
+utility effectively filters out
+.Fl f
+options from the environment and command line although it
+passes the rest of its options down to sub-makes via
+.Ev MAKEFLAGS
+by default.
+.Pp
When passing macro definitions and flag arguments in the
.Ev MAKEFLAGS
environment variable,
@@ -694,9 +717,15 @@ global variable, the makefile can alter the contents of the
environment variable made available for all programs which
.Nm
executes.
-(This includes adding
+This includes adding
.Fl f
-option(s).)
+option(s).
+The current value of
+.Va .MAKEFLAGS
+is just copied verbatim to
+.Ev MAKEFLAGS
+in the environment of child programs.
+.Pp
Note that any options entered to
.Va .MAKEFLAGS
neither affect the current instance of
@@ -718,33 +747,6 @@ children.
Compare with the
.Ic .MAKEFLAGS
special target below.
-.Pp
-To sum up what was said on
-.Fl f :
-It can appear in
-.Ev MAKEFLAGS
-and affect the current
-.Nm
-only if inherited from
-.Nm Ns 's
-initial environment.
-At the same time, a
-.Fl f
-option from
-.Nm Ns 's
-command line
-does affect
-.Nm ,
-but it is never transferred to
-.Va .MAKEFLAGS
-or pushed down to child programs such as sub-makes.
-Finally,
-.Fl f
-can appear in
-.Va .MAKEFLAGS
-only if added by the makefile itself;
-it will affect sub-makes only, via
-.Ev MAKEFLAGS .
.It Va MFLAGS
This variable is provided for backward compatibility and
contains all the options from the
OpenPOWER on IntegriCloud