mirrors/make
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/make.git synced 2024-11-24 12:19:02 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

* doc/make.texi: GNUMAKEFLAGS is only read from the environment

Browse source
This commit is contained in:
Paul Smith 2024-09-02 14:53:44 -04:00
parent 0267eb64fa
commit 7dc23aff30
1 changed files with 11 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
doc/make.texi
View file

@ -5262,16 +5262,17 @@ itself. For instance, the @samp{-t}, @samp{-n}, and @samp{-q} options, if
put in one of these variables, could have disastrous consequences and would
certainly have at least surprising and probably annoying effects.
If you'd like to run other implementations of @code{make} in addition
to GNU @code{make}, and hence do not want to add GNU
@code{make}-specific flags to the @code{MAKEFLAGS} variable, you can
add them to the @code{GNUMAKEFLAGS} variable instead. This variable
is parsed just before @code{MAKEFLAGS}, in the same way as
@code{MAKEFLAGS}. When @code{make} constructs @code{MAKEFLAGS} to
pass to a recursive @code{make} it will include all flags, even those
taken from @code{GNUMAKEFLAGS}. As a result, after parsing
@code{GNUMAKEFLAGS} GNU @code{make} sets this variable to the empty
string to avoid duplicating flags during recursion.
If you'd like to run other implementations of @code{make} in addition to GNU
Make, and hence do not want to add GNU Make-specific flags to your
@code{MAKEFLAGS} environment variable, you can add them to the
@code{GNUMAKEFLAGS} environment variable instead. This is parsed just before
@code{MAKEFLAGS}, in the same way as @code{MAKEFLAGS}. When @code{make}
constructs @code{MAKEFLAGS} to pass to a recursive @code{make} it will include
all flags, even those taken from @code{GNUMAKEFLAGS}. As a result, after
parsing @code{GNUMAKEFLAGS} GNU Make sets this variable to the empty string to
avoid duplicating flags during recursion. Only @code{GNUMAKEFLAGS}
environment variables are treated specially: setting the @code{make} variable
@code{GNUMAKEFLAGS} has no effect.
It's best to use @code{GNUMAKEFLAGS} only with flags which won't
materially change the behavior of your makefiles. If your makefiles