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

Formerly make.texinfo.~95~

Browse source
This commit is contained in:
Roland McGrath 1993-05-26 18:41:58 +00:00
parent 0246a6dc63
commit 8a5a2b9b8d
1 changed files with 21 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
make.texinfo
View file

@ -9,7 +9,7 @@
@set EDITION 0.43 @set EDITION 0.43
@set VERSION 3.68 Beta @set VERSION 3.68 Beta
@set UPDATED 24 May 1993 @set UPDATED 26 May 1993
@set UPDATE-MONTH May 1993 @set UPDATE-MONTH May 1993
@c finalout @c finalout
@ -1039,7 +1039,7 @@ implicit rules. @xref{Implicit Rules, ,Using Implicit Rules}.
@cindex @code{--makefile} @cindex @code{--makefile}
If you want to use a nonstandard name for your makefile, you can specify 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 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 @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 more than one @samp{-f} or @samp{--file} option, you can specify several
makefiles. All the makefiles are effectively concatenated in the order makefiles. All the makefiles are effectively concatenated in the order
@ -3526,6 +3526,9 @@ future, and with some shells they cannot be passed through the environment to a
sub-@code{make} sub-@code{make}
(@pxref{Variables/Recursion, ,Communicating Variables to a 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 It is traditional to use upper case letters in variable names, but we
recommend using lower case letters for variable names that serve internal recommend using lower case letters for variable names that serve internal
purposes in the makefile, and reserving upper case for parameters that purposes in the makefile, and reserving upper case for parameters that
@ -5649,10 +5652,10 @@ the targets but does not really change their contents.
are up to date already; but execute no commands in either case. In other are up to date already; but execute no commands in either case. In other
words, neither compilation nor output will occur. words, neither compilation nor output will occur.
@item -W @item -W @var{file}
@itemx --what-if @itemx --what-if=@var{file}
@itemx --assume-new @itemx --assume-new=@var{file}
@itemx --new-file @itemx --new-file=@var{file}
@cindex @code{--what-if} @cindex @code{--what-if}
@cindex @code{-W} @cindex @code{-W}
@cindex @code{--assume-new} @cindex @code{--assume-new}
@ -5875,7 +5878,7 @@ These options are ignored for compatibility with other versions of @code{make}.
@item -C @var{dir} @item -C @var{dir}
@cindex @code{-C} @cindex @code{-C}
@itemx --directory @var{dir} @itemx --directory=@var{dir}
@cindex @code{--directory} @cindex @code{--directory}
Change to directory @var{dir} before reading the makefiles. If multiple Change to directory @var{dir} before reading the makefiles. If multiple
@samp{-C} options are specified, each is interpreted relative to the @samp{-C} options are specified, each is interpreted relative to the
@ -5906,9 +5909,9 @@ over variables from makefiles.
@item -f @var{file} @item -f @var{file}
@cindex @code{-f} @cindex @code{-f}
@itemx --file @var{file} @itemx --file=@var{file}
@cindex @code{--file} @cindex @code{--file}
@itemx --makefile @var{file} @itemx --makefile=@var{file}
@cindex @code{--makefile} @cindex @code{--makefile}
Read the file named @var{file} as a makefile. Read the file named @var{file} as a makefile.
@xref{Makefiles, ,Writing Makefiles}. @xref{Makefiles, ,Writing Makefiles}.
@ -5930,7 +5933,7 @@ Ignore all errors in commands executed to remake files.
@item -I @var{dir} @item -I @var{dir}
@cindex @code{-I} @cindex @code{-I}
@itemx --include-dir @var{dir} @itemx --include-dir=@var{dir}
@cindex @code{--include-dir} @cindex @code{--include-dir}
Specifies a directory @var{dir} to search for included makefiles. Specifies a directory @var{dir} to search for included makefiles.
@xref{Include, ,Including Other Makefiles}. If several @samp{-I} @xref{Include, ,Including Other Makefiles}. If several @samp{-I}
@ -5939,7 +5942,7 @@ searched in the order specified.
@item -j [@var{jobs}] @item -j [@var{jobs}]
@cindex @code{-j} @cindex @code{-j}
@itemx --jobs [@var{jobs}] @itemx --jobs=[@var{jobs}]
@cindex @code{--jobs} @cindex @code{--jobs}
Specifies the number of jobs (commands) to run simultaneously. With no Specifies the number of jobs (commands) to run simultaneously. With no
argument, @code{make} runs as many jobs simultaneously as possible. If argument, @code{make} runs as many jobs simultaneously as possible. If
@ -5958,9 +5961,9 @@ dependencies of these targets can be processed all the same.
@item -l [@var{load}] @item -l [@var{load}]
@cindex @code{-l} @cindex @code{-l}
@itemx --load-average [@var{load}] @itemx --load-average[=@var{load}]
@cindex @code{--load-average} @cindex @code{--load-average}
@itemx --max-load [@var{load}] @itemx --max-load[=@var{load}]
@cindex @code{--max-load} @cindex @code{--max-load}
Specifies that no new jobs (commands) should be started if there are 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 others jobs running and the load average is at least @var{load} (a
@ -5982,9 +5985,9 @@ Print the commands that would be executed, but do not execute them.
@item -o @var{file} @item -o @var{file}
@cindex @code{-o} @cindex @code{-o}
@itemx --old-file @var{file} @itemx --old-file=@var{file}
@cindex @code{--old-file} @cindex @code{--old-file}
@itemx --assume-old @var{file} @itemx --assume-old=@var{file}
@cindex @code{--assume-old} @cindex @code{--assume-old}
Do not remake the file @var{file} even if it is older than its 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 dependencies, and do not remake anything on account of changes in
@ -6085,11 +6088,11 @@ but you do not want to see the extra messages.
@item -W @var{file} @item -W @var{file}
@cindex @code{-W} @cindex @code{-W}
@itemx --what-if @var{file} @itemx --what-if=@var{file}
@cindex @code{--what-if} @cindex @code{--what-if}
@itemx --new-file @var{file} @itemx --new-file=@var{file}
@cindex @code{--new-file} @cindex @code{--new-file}
@itemx --assume-new @var{file} @itemx --assume-new=@var{file}
@cindex @code{--assume-new} @cindex @code{--assume-new}
Pretend that the target @var{file} has just been modified. When used 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 with the @samp{-n} flag, this shows you what would happen if you were
@ -6859,8 +6862,6 @@ There may also be dependencies that do not use @samp{%}; such a dependency
attaches to every file made by this pattern rule. These unvarying attaches to every file made by this pattern rule. These unvarying
dependencies are useful occasionally. 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 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 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 wildcard. It provides a way to make any file that matches the target