summaryrefslogtreecommitdiff
path: root/make.texinfo
diff options
context:
space:
mode:
authorRoland McGrath <roland@redhat.com>1992-05-11 05:31:18 +0000
committerRoland McGrath <roland@redhat.com>1992-05-11 05:31:18 +0000
commit81db471695ed6b46fd60f34040bf20fc35ad5c30 (patch)
tree75f9c21b0ae136d19ac55aae0cb2ec0c1a52470a /make.texinfo
parenteb5d80d39a8f9bc49b9c2a87620d914c986bfc7e (diff)
downloadgunmake-81db471695ed6b46fd60f34040bf20fc35ad5c30.tar.gz
Formerly make.texinfo.~21~
Diffstat (limited to 'make.texinfo')
-rw-r--r--make.texinfo69
1 files changed, 50 insertions, 19 deletions
diff --git a/make.texinfo b/make.texinfo
index 9994f13..5e65b39 100644
--- a/make.texinfo
+++ b/make.texinfo
@@ -19,7 +19,7 @@ automatically which pieces of a large program need to be recompiled,
and issues the commands to recompile them.
@c !!set edition, date, version
-This is Edition 0.33 Beta, last updated 4 May 1992,
+This is Edition 0.33 Beta, last updated 11 May 1992,
of @cite{The GNU Make Manual}, for @code{make}, Version 3.63 Beta.
Copyright (C) 1988, 1989, 1990, 1991, 1992 Free Software Foundation, Inc.
@@ -94,7 +94,7 @@ large program need to be recompiled, and issues the commands to
recompile them.@refill
This is Edition 0.33 Beta of the @cite{GNU Make Manual},
-last updated 4 May 1992,
+last updated 11 May 1992,
for @code{make} Version 3.63 Beta.@refill
This manual describes @code{make} and contains the following chapters:@refill
@@ -4685,6 +4685,7 @@ Here is a table of all the options @code{make} understands:
These options are ignored for compatibility with other versions of @code{make}.
@item -C @var{dir}
+@itemx --directory @var{dir}
Change to directory @var{dir} before reading the makefiles. If multiple
@samp{-C} options are specified, each is interpreted relative to the
previous one: @samp{-C / -C etc} is equivalent to @samp{-C /etc}.
@@ -4692,6 +4693,7 @@ This is typically used with recursive invocations of @code{make}
(@pxref{Recursion, ,Recursive Use of @code{make}}).
@item -d
+@itemx --debug
Print debugging information in addition to normal processing. The
debugging information says which files are being considered for
remaking, which file-times are being compared and with what results,
@@ -4700,54 +4702,71 @@ considered and which are applied---everything interesting about how
@code{make} decides what to do.
@item -e
+@item --environment-ovverides
Give variables taken from the environment precedence
over variables from makefiles. @xref{Environment, ,Variables from the Environment}.
@item -f @var{file}
+@item --file @var{file}
+@item --makefile @var{file}
Use file @var{file} as a makefile. @xref{Makefiles, ,Writing Makefiles}.
@item -i
+@itemx --ignore-errors
Ignore all errors in commands executed to remake files.
@xref{Errors, ,Errors in Commands}.
@item -I @var{dir}
+@item --include-dir @var{dir}
Specifies a directory @var{dir} to search for included makefiles.
-@xref{Include, ,Including Other Makefiles}. If several @samp{-I} options are used to specify several
-directories, the directories are searched in the order specified. Unlike
-the arguments to other flags of @code{make}, directories given with
-@samp{-I} flags may come directly after the flag: @samp{-I@var{dir}} is
-allowed, as well as @samp{-I @var{dir}}. This syntax is allowed for
-compatibility with the C preprocessor's @samp{-I} flag.@refill
+@xref{Include, ,Including Other Makefiles}. If several @samp{-I}
+options are used to specify several directories, the directories are
+searched in the order specified. Unlike the arguments to other flags of
+@code{make}, directories given with @samp{-I} flags may come directly
+after the flag: @samp{-I@var{dir}} is allowed, as well as @samp{-I
+@var{dir}}. This syntax is allowed for compatibility with the C
+preprocessor's @samp{-I} flag.@refill
@item -j @var{jobs}
-Specifies the number of jobs (commands) to run simultaneously. If
-there is more than one @samp{-j} option, the last one is effective.
-@xref{Execution, ,Command Execution}, for more information on how commands are run.
+@itemx --jobs @var{jobs}
+Specifies the number of jobs (commands) to run simultaneously. If there
+is more than one @samp{-j} option, the last one is effective.
+@xref{Execution, ,Command Execution}, for more information on how
+commands are run.@refill
@item -k
+@itemx --keep-going
Continue as much as possible after an error. While the target that
failed, and those that depend on it, cannot be remade, the other
dependencies of these targets can be processed all the same.
@xref{Testing, ,Testing the Compilation of a Program}.
-@item -l @var{load}
-@item -l
+@item -l [@var{load}]
+@itemx --load-average [@var{load}]
+@itemx --max-load [@var{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
floating-point number). With no argument, removes a previous load
limit. @xref{Parallel, ,Parallel Execution}.
@item -n
+@itemx --just-print
+@itemx --dry-run
+@itemx --recon
Print the commands that would be executed, but do not execute them.
@xref{Instead of Execution, ,Instead of Executing the Commands}.
@item -o @var{file}
+@itemx --old-file @var{file}
+@itemx --assume-old @var{file}
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
@var{file}. Essentially the file is treated as very old and its rules
-are ignored. @xref{Avoiding Compilation, ,Avoiding Recompilation of Some Files}.
+are ignored. @xref{Avoiding Compilation, ,Avoiding Recompilation of
+Some Files}.@refill
@item -p
+@itemx --print-data-base
Print the data base (rules and variable values) that results from
reading the makefiles; then execute as usual or as otherwise
specified. This also prints the version information given by
@@ -4755,32 +4774,40 @@ the @samp{-v} switch (see below). To print the data base without
trying to remake any files, use @samp{make -p -f /dev/null}.
@item -q
+@itemx --question
``Question mode''. Do not run any commands, or print anything; just
-return an exit status that is zero if the specified targets are
-already up to date, nonzero otherwise. @xref{Instead of Execution, ,Instead of Executing the Commands}.
+return an exit status that is zero if the specified targets are already
+up to date, nonzero otherwise. @xref{Instead of Execution, ,Instead of
+Executing the Commands}.@refill
@item -r
-Eliminate use of the built-in implicit rules (@pxref{Implicit Rules, ,Using Implicit Rules}).
-Also clear out the default list of suffixes for suffix rules
-(@pxref{Suffix Rules, ,Old-Fashioned Suffix Rules}).
+@itemx --no-builtin-rules
+Eliminate use of the built-in implicit rules (@pxref{Implicit Rules,
+,Using Implicit Rules}). Also clear out the default list of suffixes
+for suffix rules (@pxref{Suffix Rules, ,Old-Fashioned Suffix Rules}).@refill
@item -s
+@itemx --silent
+@itemx --quiet
Silent operation; do not print the commands as they are executed.
@xref{Echoing, ,Command Echoing}.
@item -S
+@itemx --no-keep-going
Cancel the effect of the @samp{-k} option. This is never necessary
except in a recursive @code{make} where @samp{-k} might be inherited
from the top-level @code{make} via @code{MAKEFLAGS} (@pxref{Recursion, ,Recursive Use of @code{make}})
or if you set @samp{-k} in @code{MAKEFLAGS} in your environment.@refill
@item -t
+@itemx --touch
Touch files (mark them up to date without really changing them)
instead of running their commands. This is used to pretend that the
commands were done, in order to fool future invocations of
@code{make}. @xref{Instead of Execution, ,Instead of Executing the Commands}.
@item -v
+@itemx --version
Print the version of the @code{make} program plus a copyright, a list
of authors and a notice that there is no warranty. After this
information is printed, processing continues normally. To get this
@@ -4788,12 +4815,16 @@ information without doing anything else, use @samp{make -v -f
/dev/null}.
@item -w
+@itemx --print-directory
Print a message containing the working directory both before and after
executing the makefile. This may be useful for tracking down errors
from complicated nests of recursive @code{make} commands.
@xref{Recursion, ,Recursive Use of @code{make}}.
@item -W @var{file}
+@itemx --what-if @var{file}
+@itemx --new @var{file}
+@itemx --assume-new @var{file}
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
to modify that file. Without @samp{-n}, it is almost the same as