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