summaryrefslogtreecommitdiff
path: root/usr.bin/make/make.1
diff options
context:
space:
mode:
authorlukem <lukem@NetBSD.org>1997-10-19 05:05:24 +0000
committerlukem <lukem@NetBSD.org>1997-10-19 05:05:24 +0000
commit6d1c625f54047c94c8ea6f2f7050cd258cfb403c (patch)
tree2fa7b61294360f85f19e1cc24c03c4c4211e6583 /usr.bin/make/make.1
parent7c81c8f378d0f6d324039451f1cb953d6e56918b (diff)
fix up .Nm usage
Diffstat (limited to 'usr.bin/make/make.1')
-rw-r--r--usr.bin/make/make.174
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 .