summaryrefslogtreecommitdiff
path: root/usr.bin
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
parent7c81c8f378d0f6d324039451f1cb953d6e56918b (diff)
fix up .Nm usage
Diffstat (limited to 'usr.bin')
-rw-r--r--usr.bin/make/make.174
-rw-r--r--usr.bin/man/man.126
-rw-r--r--usr.bin/man/man.conf.58
3 files changed, 54 insertions, 54 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 .
diff --git a/usr.bin/man/man.1 b/usr.bin/man/man.1
index 6bb4ad79e42..637b2a857c6 100644
--- a/usr.bin/man/man.1
+++ b/usr.bin/man/man.1
@@ -38,7 +38,7 @@
.Nm man
.Nd display the on-line manual pages
.Sh SYNOPSIS
-.Nm man
+.Nm
.Op Fl achw
.Op Fl C Ar file
.Op Fl M Ar path
@@ -47,7 +47,7 @@
.Ar name Ar ...
.Sh DESCRIPTION
The
-.Nm man
+.Nm
utility
displays the
.Bx
@@ -82,7 +82,7 @@ Display only the
lines of the requested manual pages.
.It Fl M
Override the list of standard directories which
-.Nm man
+.Nm
searches for manual pages.
The supplied
.Ar path
@@ -91,11 +91,11 @@ This search path may also be set using the environment variable
.Ev MANPATH .
The subdirectories to be searched, and their search order,
is specified by the ``_subdir'' line in the
-.Nm man
+.Nm
configuration file.
.It Fl m
Augment the list of standard directories which
-.Nm man
+.Nm
searches for manual pages.
The supplied
.Ar path
@@ -108,11 +108,11 @@ option or the
environment variable.
The subdirectories to be searched, and their search order,
is specified by the ``_subdir'' line in the
-.Nm man
+.Nm
configuration file.
.It Fl w
List the pathnames of the manual pages which
-.Nm man
+.Nm
would display for the specified
.Ar section
and
@@ -123,10 +123,10 @@ combination.
The optional
.Ar section
argument restricts the directories that
-.Nm man
+.Nm
will search.
The
-.Nm man
+.Nm
configuration file (see
.Xr man.conf 5 )
specifies the possible
@@ -134,13 +134,13 @@ specifies the possible
values that are currently available.
If only a single argument is specified or if the first argument is
not a valid section,
-.Nm man
+.Nm
assumes that the argument is the name of a manual page to be displayed.
.Sh ENVIRONMENT
.Bl -tag -width MANPATHX
.It Ev MACHINE
As some manual pages are intended only for specific architectures,
-.Nm man
+.Nm
searches any subdirectories,
with the same name as the current architecture,
in every directory which it searches.
@@ -151,7 +151,7 @@ variable
to the name of a specific architecture.
.It Ev MANPATH
The standard search path used by
-.Nm man
+.Nm
may be overridden by specifying a path in the
.Ev MANPATH
environment
@@ -159,7 +159,7 @@ variable.
The format of the path is a colon (``:'') separated list of directories.
The subdirectories to be searched as well as their search order
is specified by the ``_subdir'' line in the
-.Nm man
+.Nm
configuration file.
.It Ev PAGER
Any value of the environment variable
diff --git a/usr.bin/man/man.conf.5 b/usr.bin/man/man.conf.5
index 353a30236fb..2d1495be057 100644
--- a/usr.bin/man/man.conf.5
+++ b/usr.bin/man/man.conf.5
@@ -46,14 +46,14 @@ and
.Xr whatis 1
commands
search for manual pages or their database files as specified by the
-.Nm man.conf
+.Nm
file.
Manual pages are normally expected to be preformatted (see
.Xr nroff 1 )
and named with a trailing ``.0''.
.Pp
The
-.Nm man.conf
+.Nm
file contains two types of lines.
.Pp
The first type of line is a ``section'' line, which contains a
@@ -74,7 +74,7 @@ Before searching any directory for a manual page, the
command always searches the subdirectory with the same name
as the current machine type, if it exists.
No specification of these subdirectories is necessary in the
-.Nm man.conf
+.Nm
file.
.Pp
Section names are unrestricted except for the reserved words specified
@@ -140,7 +140,7 @@ Empty lines or lines whose first non-whitespace character is a hash
mark (``#'') are ignored.
.Sh EXAMPLES
Given the following
-.Nm man.conf
+.Nm
file:
.Bd -literal -offset indent
_version BSD.2