@set EDITION 0.43
@set VERSION 3.68 Beta
-@set UPDATED 24 May 1993
+@set UPDATED 26 May 1993
@set UPDATE-MONTH May 1993
@c finalout
@cindex @code{--makefile}
If you want to use a nonstandard name for your makefile, you can specify
the makefile name with the @samp{-f} or @samp{--file} option. The
-arguments @w{@samp{-f @var{name}}} or @w{@samp{--file @var{name}}} tell
+arguments @w{@samp{-f @var{name}}} or @w{@samp{--file=@var{name}}} tell
@code{make} to read the file @var{name} as the makefile. If you use
more than one @samp{-f} or @samp{--file} option, you can specify several
makefiles. All the makefiles are effectively concatenated in the order
sub-@code{make}
(@pxref{Variables/Recursion, ,Communicating Variables to a Sub-@code{make}}).
+Variable names are case-sensitive. The names @samp{foo}, @samp{FOO},
+and @samp{Foo} all refer to different variables.
+
It is traditional to use upper case letters in variable names, but we
recommend using lower case letters for variable names that serve internal
purposes in the makefile, and reserving upper case for parameters that
are up to date already; but execute no commands in either case. In other
words, neither compilation nor output will occur.
-@item -W
-@itemx --what-if
-@itemx --assume-new
-@itemx --new-file
+@item -W @var{file}
+@itemx --what-if=@var{file}
+@itemx --assume-new=@var{file}
+@itemx --new-file=@var{file}
@cindex @code{--what-if}
@cindex @code{-W}
@cindex @code{--assume-new}
@item -C @var{dir}
@cindex @code{-C}
-@itemx --directory @var{dir}
+@itemx --directory=@var{dir}
@cindex @code{--directory}
Change to directory @var{dir} before reading the makefiles. If multiple
@samp{-C} options are specified, each is interpreted relative to the
@item -f @var{file}
@cindex @code{-f}
-@itemx --file @var{file}
+@itemx --file=@var{file}
@cindex @code{--file}
-@itemx --makefile @var{file}
+@itemx --makefile=@var{file}
@cindex @code{--makefile}
Read the file named @var{file} as a makefile.
@xref{Makefiles, ,Writing Makefiles}.
@item -I @var{dir}
@cindex @code{-I}
-@itemx --include-dir @var{dir}
+@itemx --include-dir=@var{dir}
@cindex @code{--include-dir}
Specifies a directory @var{dir} to search for included makefiles.
@xref{Include, ,Including Other Makefiles}. If several @samp{-I}
@item -j [@var{jobs}]
@cindex @code{-j}
-@itemx --jobs [@var{jobs}]
+@itemx --jobs=[@var{jobs}]
@cindex @code{--jobs}
Specifies the number of jobs (commands) to run simultaneously. With no
argument, @code{make} runs as many jobs simultaneously as possible. If
@item -l [@var{load}]
@cindex @code{-l}
-@itemx --load-average [@var{load}]
+@itemx --load-average[=@var{load}]
@cindex @code{--load-average}
-@itemx --max-load [@var{load}]
+@itemx --max-load[=@var{load}]
@cindex @code{--max-load}
Specifies that no new jobs (commands) should be started if there are
others jobs running and the load average is at least @var{load} (a
@item -o @var{file}
@cindex @code{-o}
-@itemx --old-file @var{file}
+@itemx --old-file=@var{file}
@cindex @code{--old-file}
-@itemx --assume-old @var{file}
+@itemx --assume-old=@var{file}
@cindex @code{--assume-old}
Do not remake the file @var{file} even if it is older than its
dependencies, and do not remake anything on account of changes in
@item -W @var{file}
@cindex @code{-W}
-@itemx --what-if @var{file}
+@itemx --what-if=@var{file}
@cindex @code{--what-if}
-@itemx --new-file @var{file}
+@itemx --new-file=@var{file}
@cindex @code{--new-file}
-@itemx --assume-new @var{file}
+@itemx --assume-new=@var{file}
@cindex @code{--assume-new}
Pretend that the target @var{file} has just been modified. When used
with the @samp{-n} flag, this shows you what would happen if you were
attaches to every file made by this pattern rule. These unvarying
dependencies are useful occasionally.
-@c !!! The following sentence should be rewritten. --bob
-@c rewritten by roland; does it win now?
A pattern rule need not have any dependencies that contain @samp{%}, or
in fact any dependencies at all. Such a rule is effectively a general
wildcard. It provides a way to make any file that matches the target