summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--make.texinfo44
1 files changed, 36 insertions, 8 deletions
diff --git a/make.texinfo b/make.texinfo
index 727dd75..da7fa94 100644
--- a/make.texinfo
+++ b/make.texinfo
@@ -6,7 +6,13 @@
$Header$
$Log$
-Revision 1.4 1988/04/23 18:28:02 roland
+Revision 1.5 1988/04/23 22:01:48 roland
+* Added paragraph about reporting bugs.
+* Documented -v (print version info) flag.
+* Corrected a couple typos (probably made a couple more :-).
+* Given to RMS for beta-testing.
+
+Revision 1.4 88/04/23 18:28:02 roland
* Changed RCS stuff slightly (added a keyword).
* Changed date from February to April, 1988.
* Given to RMS for beta-testing.
@@ -101,6 +107,13 @@ recompile them. This manual describes the GNU implementation of
@code{make}.
GNU @code{make} was implemented by Richard Stallman and Roland McGrath.
+If you have problems with @code{make} or think you've found a bug,
+please report it to Roland McGrath; he will probably do something about
+it. Please include the version of @code{make} you are using (the command
+@code{make -v -f /dev/null} will tell you this) and a small makefile that
+reproduces the bug. Send electronic mail to Internet address
+@samp{roland@rtsg.lbl.gov} or @samp{roland@wheaties.ai.mit.edu}.
+Questions and suggestions are also welcome.@refill
Our examples show C programs, since they are most common, but you can use
@code{make} with any programming language whose compiler can be run with a
@@ -1536,11 +1549,11 @@ directory as it is entered and exited. For example, if @code{make -w} is
run in the directory @file{/u/gnu/make}, @code{make} will print a line of
the form
@example
-#### Entering /u/gnu/make ####
+make: Entering directory `/u/gnu/make'.
@end example
before doing anything else, and a line of the form
@example
-#### Exiting /u/gnu/make ####
+make: Leaving directory `/u/gnu/make'.
@end example
after finishing with the makefile.
@@ -2776,10 +2789,17 @@ targets to be considered are already up to date.
It is an error to use more than one of these three flags in the same
invocation of @code{make}.
+If you are not at all interested in what @code{make} @emph{would} do,
+but rather in some other information about @code{make}, there are two
+are options: the command line @code{make -p -f /dev/null} will print the
+information in @code{make}'s database of variables, rules, directories
+and files and @code{make -v -f /dev/null} will print information about
+what version of GNU @code{make} you are using. @xref{Options}.@refill
+
@node Overriding, Testing, Instead of Execution, Running
@section Overriding Variables
-You can override the value of a variable using an arguments to @code{make}
+You can override the value of a variable using an argument to @code{make}
that contains a @samp{=}. The argument @samp{@var{v}=@var{x}} (or
@samp{@var{v}:=@var{x}}; @pxref{Flavors}) sets the value of the variable
@var{v} to @var{x}.
@@ -2925,7 +2945,9 @@ are ignored. @xref{Avoid Compilation}.
@item -p
Print the data base (rules and variable values) that results from
reading the makefiles; then execute as usual or as otherwise
-specified.
+specified. This also prints the version information given by
+the @samp{-v} switch (see below). To print the data base without
+trying to remake any files, use @code{make -p -f /dev/null}.
@item -q
``Question mode''. Do not run any commands, or print anything; just
@@ -2944,7 +2966,8 @@ Silent operation; do not print the commands as they are executed.
@item -S
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}. @xref{Recursion}.
+from the top-level @code{make} via @code{MAKEFLAGS} (@pxref{Recursion})
+or if you set @samp{-k} in @code{MAKEFLAGS} in your environment.@refill
@item -t
Touch files (mark them up to date without really changing them)
@@ -2952,11 +2975,16 @@ instead of running their commands. This is used to pretend (to fool
future invocations of @code{make}) that the commands were done.
@xref{Instead of Execution}.
+@item -v
+Print the version of the @code{make} program plus a copyright,
+list of authors and notice of (non)warranty (short).
+After this information is printed, processing continues normally.
+To get just the version information, use @code{make -v -f /dev/null}.
+
@item -w
Print a message containing the working directory both before and after
executing the makefile; this is useful for tracking down errors from builds
-of large directory trees.
-@xref{Recursion}.
+of large directory trees. @xref{Recursion}.
@end table
@node Implicit, Archives, Running, Top