diff options
| author | lukem <lukem@NetBSD.org> | 1997-10-19 05:05:24 +0000 |
|---|---|---|
| committer | lukem <lukem@NetBSD.org> | 1997-10-19 05:05:24 +0000 |
| commit | 6d1c625f54047c94c8ea6f2f7050cd258cfb403c (patch) | |
| tree | 2fa7b61294360f85f19e1cc24c03c4c4211e6583 /usr.bin/make/make.1 | |
| parent | 7c81c8f378d0f6d324039451f1cb953d6e56918b (diff) | |
fix up .Nm usage
Diffstat (limited to 'usr.bin/make/make.1')
| -rw-r--r-- | usr.bin/make/make.1 | 74 |
1 files changed, 37 insertions, 37 deletions
diff --git a/usr.bin/make/make.1 b/usr.bin/make/make.1 index ff223e50e49..4651791ce07 100644 --- a/usr.bin/make/make.1 +++ b/usr.bin/make/make.1 @@ -1,4 +1,4 @@ -.\" $NetBSD: make.1,v 1.24 1997/10/12 05:51:47 mikel Exp $ +.\" $NetBSD: make.1,v 1.25 1997/10/19 05:05:24 lukem Exp $ .\" .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. @@ -40,7 +40,7 @@ .Nm make .Nd maintain program dependencies .Sh SYNOPSIS -.Nm make +.Nm .Op Fl Beiknqrst .Op Fl D Ar variable .Op Fl d Ar flags @@ -54,7 +54,7 @@ .Op Ar variable=value .Op Ar target ... .Sh DESCRIPTION -.Nm Make +.Nm 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. @@ -71,7 +71,7 @@ exists, it is read (see .Pp This manual page is intended as a reference document only. For a more thorough description of -.Nm make +.Nm and makefiles, please refer to .%T "Make \- A Tutorial" . .Pp @@ -86,7 +86,7 @@ Define to be 1, in the global context. .It Fl d Ar flags Turn on debugging, and specify which portions of -.Nm make +.Nm are to print debugging information. .Ar Flags is one or more of the following: @@ -143,7 +143,7 @@ Equivalent to specifying before each command line in the makefile. .It Fl j Ar max_jobs Specify the maximum number of jobs that -.Nm make +.Nm may have running at any one time. Turns compatibility mode off, unless the .Ar B flag is also specified. @@ -176,7 +176,7 @@ Rather than re-building a target as specified in the makefile, create it or update its modification time to make it appear up-to-date. .It Fl V Ar variable Print -.Nm make Ns 's +.Nm "" Ns 's idea of the value of .Ar variable , in the global context. @@ -215,7 +215,7 @@ those of any of its sources. Sources for a target accumulate over dependency lines when this operator is used. The target is removed if -.Nm make +.Nm is interrupted. .It Ic \&! Targets are always re-created, but not until all sources have been @@ -223,7 +223,7 @@ examined and re-created as necessary. Sources for a target accumulate over dependency lines when this operator is used. The target is removed if -.Nm make +.Nm is interrupted. .It Ic \&:: If no sources are specified, the target is always re-created. @@ -232,7 +232,7 @@ been modified more recently than the target. Sources for a target do not accumulate over dependency lines when this operator is used. The target will not be removed if -.Nm make +.Nm is interrupted. .El .Pp @@ -327,7 +327,7 @@ are: .Bl -tag -width Ds .It Environment variables Variables defined as part of -.Nm make Ns 's +.Nm "" Ns 's environment. .It Global variables Variables defined in the makefile or in included makefiles. @@ -392,7 +392,7 @@ and .Ql Va .MEMBER . .Pp In addition, -.Nm make +.Nm sets or knows about the following variables: .Bl -tag -width MAKEFLAGS .It Va \&$ @@ -404,12 +404,12 @@ expands to a single dollar sign. .It Va .MAKE The name that -.Nm make +.Nm was executed with .Pq Va argv[0] .It Va .CURDIR A path to the directory where -.Nm make +.Nm was executed. .It Va .OBJDIR A path to the directory where the targets are built. @@ -418,19 +418,19 @@ The environment variable .Ql Ev MAKEFLAGS may contain anything that may be specified on -.Nm make Ns 's +.Nm "" Ns 's command line. Anything specified on -.Nm make Ns 's +.Nm "" Ns 's command line is appended to the .Ql Ev MAKEFLAGS variable which is then entered into the environment for all programs which -.Nm make +.Nm executes. .It Ev PWD Alternate path to the current directory. -.Nm make +.Nm normally sets .Ql Va .CURDIR to the canonical path given by @@ -438,7 +438,7 @@ to the canonical path given by However, if the environment variable .Ql Ev PWD is set and gives a path to the current directory, then -.Nm make +.Nm sets .Ql Va .CURDIR to the value of @@ -448,7 +448,7 @@ instead. is set to the value of .Ql Va .OBJDIR for all programs which -.Nm make +.Nm executes. .El .Pp @@ -486,7 +486,7 @@ the rest of the modifier. .It Cm Q Quotes every shell meta-character in the variable, so that it can be passed safely through recursive invocations of -.Nm make . +.Nm "" . .It Cm R Replaces each word in the variable with everything but its suffix. .Sm off @@ -595,7 +595,7 @@ to be replaced in .Sh INCLUDE STATEMENTS, CONDITIONALS AND FOR LOOPS Makefile inclusion, conditional structures and for loops reminiscent of the C programming language are provided in -.Nm make . +.Nm "" . All such structures are identified by a line beginning with a single dot .Pq Ql \&. @@ -716,7 +716,7 @@ of higher precedence than .El .Pp As in C, -.Nm make +.Nm will only evaluate a conditional as far as is necessary to determine its value. Parentheses may be used to change the order of evaluation. @@ -737,7 +737,7 @@ has been defined. .It Ic make Takes a target name as an argument and evaluates to true if the target was specified as part of -.Nm make Ns 's +.Nm "" Ns 's command line or was declared the default target (either implicitly or explicitly, see .Va .MAIN ) @@ -771,7 +771,7 @@ If no relational operator is given, it is assumed that the expanded variable is being compared against 0. .Pp When -.Nm make +.Nm is evaluating one of these conditional expression, and it encounters a word it doesn't recognize, either the ``make'' or ``defined'' expression is applied to it, depending on the form of the conditional. @@ -840,21 +840,21 @@ or .Fl t options were specified. Normally used to mark recursive -.Nm make Ns 's . +.Nm "" Ns 's . .It Ic .NOTMAIN Normally -.Nm make +.Nm selects the first target it encounters as the default target to be built if no target was specified. This source prevents this target from being selected. .It Ic .OPTIONAL If a target is marked with this attribute and -.Nm make +.Nm can't figure out how to create it, it will ignore this fact and assume the file isn't needed or already exists. .It Ic .PRECIOUS When -.Nm make +.Nm is interrupted, it removes any partially made targets. This source prevents the target from being removed. .It Ic .SILENT @@ -863,7 +863,7 @@ as if they all were preceded by an at sign .Pq Ql @ . .It Ic .USE Turn the target into -.Nm make Ns 's +.Nm "" Ns 's version of a macro. When the target is used as a source for another target, the other target acquires the commands, sources, and attributes (except for @@ -893,7 +893,7 @@ This is sort of a .Ic .USE rule for any target (that was used only as a source) that -.Nm make +.Nm can't figure out any other way to create. Only the shell script is used. The @@ -914,15 +914,15 @@ If no sources are specified, this is the equivalent of specifying the option. .It Ic .INTERRUPT If -.Nm make +.Nm is interrupted, the commands for this target will be executed. .It Ic .MAIN If no target is specified when -.Nm make +.Nm is invoked, this target will be built. .It Ic .MAKEFLAGS This target provides a way to specify flags for -.Nm make +.Nm when the makefile is used. The flags are as if typed to the shell, though the .Fl f @@ -979,10 +979,10 @@ attribute is applied to every command in the file. .It Ic .SUFFIXES Each source specifies a suffix to -.Nm make . +.Nm "" . If no sources are specified, any previous specified suffices are deleted. .Sh ENVIRONMENT -.Nm Make +.Nm utilizes the following environment variables, if they exist: .Ev MACHINE , .Ev MAKE , @@ -1007,6 +1007,6 @@ system makefile directory .Xr mkdep 1 .Sh HISTORY A -.Nm make +.Nm command appeared in .At v7 . |
