diff options
| -rw-r--r-- | usr.bin/make/make.1 | 44 |
1 files changed, 24 insertions, 20 deletions
diff --git a/usr.bin/make/make.1 b/usr.bin/make/make.1 index 8150a5079cd..a33e9696d7a 100644 --- a/usr.bin/make/make.1 +++ b/usr.bin/make/make.1 @@ -1,4 +1,5 @@ -.\" $OpenBSD: make.1,v 1.39 2001/03/29 17:15:47 aaron Exp $ +.\" $OpenBSD: make.1,v 1.40 2001/05/03 14:00:58 espie Exp $ +.\" $OpenPackages$ .\" $NetBSD: make.1,v 1.18 1997/03/10 21:19:53 christos Exp $ .\" .\" Copyright (c) 1990, 1993 @@ -60,16 +61,16 @@ is a program designed to simplify the maintenance of other programs. Its input is a list of specifications as to the files upon which programs and other files depend. If the file -.Pa BSDmakefile +.Ql Pa BSDmakefile exists, it is read for this list of specifications. If it does not exist, the files -.Pa makefile +.Ql Pa makefile and -.Pa Makefile +.Ql Pa Makefile are tried in order. If the file -.Pa .depend -exists, it is read (see +.Ql Pa .depend +exists, it is read in addition to the makefile (see .Xr mkdep 1) . .Pp This manual page is intended as a reference document only. @@ -89,7 +90,7 @@ is used. .It Fl D Ar variable Define .Ar variable -to be 1, in the global context. +to be 1. .It Fl d Ar flags Turn on debugging, and specify which portions of .Nm @@ -107,7 +108,7 @@ Print debugging information about conditional evaluation. .It Ar d Print debugging information about directory searching and caching. .It Ar f -Print debugging information about the execution of for loops. +Print debugging information about the expansion of for loops. .It Ar "g1" Print the input graph before making anything. .It Ar "g2" @@ -115,6 +116,10 @@ Print the input graph after making everything, or before exiting on error. .It Ar j Print debugging information about running multiple shells. +.It Ar l +Print commands in Makefile targets regardless of whether or not they are +prefixed by @. +Also known as loud behavior. .It Ar m Print debugging information about making targets, including modification dates. @@ -130,9 +135,9 @@ Specify that environment variables override macro assignments within makefiles. .It Fl f Ar makefile Specify a makefile to read instead of the default -.Pa makefile +.Ql Pa makefile and -.Pa Makefile . +.Ql Pa Makefile . If .Ar makefile is @@ -160,7 +165,9 @@ flag is also specified. Continue processing after errors are encountered, but only on those targets that do not depend on the target whose creation caused the error. .It Fl m Ar directory -Specify a directory in which to search for sys.mk and makefiles included +Specify a directory in which to search for +.Pa sys.mk +and makefiles included via the <...> style. Multiple directories can be added to form a search path. This path will override the default system include path: @@ -179,8 +186,8 @@ This option has no effect unless .Fl j is used too. .It Fl q -Do not execute any commands, but exit 0 if the specified targets are -up-to-date and 1, otherwise. +Do not execute any commands, but exit with status 0 if the specified targets +are up-to-date, and 1 otherwise. .It Fl r Do not use the built-in rules specified in the system makefile. .It Fl S @@ -190,7 +197,7 @@ This is needed to negate the .Fl k option during recursive builds. .It Fl s -Do not echo any commands as they are executed. +Do not echo commands as they are executed. Equivalent to specifying .Ql Ic @ before each command line in the makefile. @@ -201,8 +208,7 @@ or update its modification time to make it appear up-to-date. Print .Nm make Ns 's idea of the value of -.Ar variable , -in the global context. +.Ar variable . Do not build any targets. Multiple instances of this option may be specified; the variables will be printed one per line, @@ -232,7 +238,7 @@ on the sources and are usually created from them. The exact relationship between the target and the source is determined by the operator that separates them. -The three operators are as follows: +The operators are as follows: .Bl -tag -width flag .It Ic \&: A target is considered out-of-date if its modification time is less than @@ -507,7 +513,7 @@ Its contents are stored in .Nm make Ns 's .Va .MAKEFLAGS variable. -Any flag or variable setting specified on +Anything specified on .Nm make Ns 's command line is appended to the .Va .MAKEFLAGS @@ -1247,8 +1253,6 @@ When handling pre-BSD 4.4 archives, may erroneously mark archive members as out of date if the archive name was truncated. .Pp -Variable handling is somewhat inefficient. -.Pp The handling of ; and other special characters in tests may be utterly bogus. For instance, in |