Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/usr.bin/make make.1: replace redundant .Ql with .Sq
details: https://anonhg.NetBSD.org/src/rev/4aeb06ec4105
branches: trunk
changeset: 368456:4aeb06ec4105
user: rillig <rillig%NetBSD.org@localhost>
date: Tue Jul 12 22:45:05 2022 +0000
description:
make.1: replace redundant .Ql with .Sq
diffstat:
usr.bin/make/make.1 | 236 ++++++++++++++++++++++++++--------------------------
1 files changed, 118 insertions(+), 118 deletions(-)
diffs (truncated from 689 to 300 lines):
diff -r 3cfc4f4aae6f -r 4aeb06ec4105 usr.bin/make/make.1
--- a/usr.bin/make/make.1 Tue Jul 12 17:45:11 2022 +0000
+++ b/usr.bin/make/make.1 Tue Jul 12 22:45:05 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: make.1,v 1.310 2022/07/12 17:45:11 rillig Exp $
+.\" $NetBSD: make.1,v 1.311 2022/07/12 22:45:05 rillig Exp $
.\"
.\" Copyright (c) 1990, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -61,12 +61,12 @@
makefile option is given,
.Nm
will try to open
-.Ql Pa makefile
+.Sq Pa makefile
then
-.Ql Pa Makefile
+.Sq Pa Makefile
in order to find the specifications.
If the file
-.Ql Pa .depend
+.Sq Pa .depend
exists, it is read (see
.Xr mkdep 1 ) .
.Pp
@@ -229,11 +229,11 @@
makefiles.
.It Fl f Ar makefile
Specify a makefile to read instead of the default
-.Ql Pa makefile .
+.Sq Pa makefile .
If
.Ar makefile
is
-.Ql Fl ,
+.Sq Fl ,
standard input is read.
Multiple makefiles may be specified, and are read in the order specified.
.It Fl I Ar directory
@@ -244,7 +244,7 @@
.It Fl i
Ignore non-zero exit of shell commands in the makefile.
Equivalent to specifying
-.Ql Fl
+.Sq Fl
before each command line in the makefile.
.It Fl J Ar private
This option should
@@ -319,7 +319,7 @@
Display the commands that would have been executed, but do not
actually execute them unless the target depends on the .MAKE special
source (see below) or the command is prefixed with
-.Ql Ic + .
+.Sq Ic + .
.It Fl N
Display the commands which would have been executed, but do not
actually execute any of them; useful for debugging top-level makefiles
@@ -336,7 +336,7 @@
.It Fl s
Do not echo any commands as they are executed.
Equivalent to specifying
-.Ql Ic @
+.Sq Ic @
before each command line in the makefile.
.It Fl T Ar tracefile
When used with the
@@ -493,7 +493,7 @@
default only one of these rules may be followed by a creation
script.
If the
-.Ql Ic \&::
+.Sq Ic \&::
operator is used, however, all rules may include scripts and the
scripts are executed in the order found.
.Pp
@@ -505,23 +505,23 @@
.\" normally ignores it.
.\" However, the tab at the beginning of the following line is removed.
If the first characters of the command are any combination of
-.Ql Ic @ ,
-.Ql Ic + ,
+.Sq Ic @ ,
+.Sq Ic + ,
or
-.Ql Ic \- ,
+.Sq Ic \- ,
the command is treated specially.
A
-.Ql Ic @
+.Sq Ic @
causes the command not to be echoed before it is executed.
A
-.Ql Ic +
+.Sq Ic +
causes the command to be executed even when
.Fl n
is given.
This is similar to the effect of the .MAKE special source,
except that the effect can be limited to a single line of a script.
A
-.Ql Ic \-
+.Sq Ic \-
in compatibility mode
causes any non-zero exit status of the command line to be ignored.
.Pp
@@ -538,11 +538,11 @@
.Nm
will attempt direct execution.
If a line starts with
-.Ql Ic \-
+.Sq Ic \-
and the shell has ErrCtl enabled then failure of the command line
will be ignored as in compatibility mode.
Otherwise
-.Ql Ic \-
+.Sq Ic \-
affects the entire job;
the script will stop at the first command line that fails,
but the target will not be deemed to have failed.
@@ -576,14 +576,14 @@
will
.Xr chdir 2
to
-.Ql Va .OBJDIR
+.Sq Va .OBJDIR
before executing any targets, each child process
starts with that as its current working directory.
.Sh VARIABLE ASSIGNMENTS
Variables in make behave much like macros in the C preprocessor.
.Pp
Variable assignments have the form
-.Ql Ar NAME No Ar op No Ar value ,
+.Sq Ar NAME No Ar op No Ar value ,
where:
.Bl -tag -width Ds
.It Ar NAME
@@ -743,34 +743,34 @@
.Bl -tag -width ".ARCHIVE" -offset indent
.It Va .ALLSRC
The list of all sources for this target; also known as
-.Ql Va \&> .
+.Sq Va \&> .
.It Va .ARCHIVE
The name of the archive file; also known as
-.Ql Va \&! .
+.Sq Va \&! .
.It Va .IMPSRC
In suffix-transformation rules, the name/path of the source from which the
target is to be transformed (the
.Dq implied
source); also known as
-.Ql Va \&< .
+.Sq Va \&< .
It is not defined in explicit rules.
.It Va .MEMBER
The name of the archive member; also known as
-.Ql Va % .
+.Sq Va % .
.It Va .OODATE
The list of sources for this target that were deemed out-of-date; also
known as
-.Ql Va \&? .
+.Sq Va \&? .
.It Va .PREFIX
The file prefix of the target, containing only the file portion, no suffix
or preceding directory components; also known as
-.Ql Va * .
+.Sq Va * .
The suffix must be one of the known suffixes declared with
.Ic .SUFFIXES
or it will not be recognized.
.It Va .TARGET
The name of the target; also known as
-.Ql Va @ .
+.Sq Va @ .
For compatibility with other makes this is an alias for
.Ic .ARCHIVE
in archive member rules.
@@ -778,13 +778,13 @@
.Pp
The shorter forms
.Ql ( Va > ,
-.Ql Va \&! ,
-.Ql Va < ,
-.Ql Va % ,
-.Ql Va \&? ,
-.Ql Va * ,
+.Sq Va \&! ,
+.Sq Va < ,
+.Sq Va % ,
+.Sq Va \&? ,
+.Sq Va * ,
and
-.Ql Va @ )
+.Sq Va @ )
are permitted for backward
compatibility with historical makefiles and legacy POSIX make and are
not recommended.
@@ -794,7 +794,7 @@
or
.Ql F ,
e.g.\&
-.Ql Va $(@D) ,
+.Sq Va $(@D) ,
are legacy forms equivalent to using the
.Ql :H
and
@@ -807,11 +807,11 @@
Four of the local variables may be used in sources on dependency lines
because they expand to the proper value for each target on the line.
These variables are
-.Ql Va .TARGET ,
-.Ql Va .PREFIX ,
-.Ql Va .ARCHIVE ,
+.Sq Va .TARGET ,
+.Sq Va .PREFIX ,
+.Sq Va .ARCHIVE ,
and
-.Ql Va .MEMBER .
+.Sq Va .MEMBER .
.Ss Additional built-in variables
In addition,
.Nm
@@ -826,7 +826,7 @@
.Nm
was executed.
Refer to the description of
-.Ql Ev PWD
+.Sq Ev PWD
for more details.
.It Va .INCLUDEDFROMDIR
The directory of the file this Makefile was included from.
@@ -849,7 +849,7 @@
and cannot be confused with the special target with the same name.
.It Va .MAKE.DEPENDFILE
Names the makefile (default
-.Ql Pa .depend )
+.Sq Pa .depend )
from which generated dependencies are read.
.It Va .MAKE.EXPAND_VARIABLES
A boolean that controls the default behavior of the
@@ -891,7 +891,7 @@
treated as normal sources.
.It Ev MAKEFLAGS
The environment variable
-.Ql Ev MAKEFLAGS
+.Sq Ev MAKEFLAGS
may contain anything that
may be specified on
.Nm Ns 's
@@ -899,7 +899,7 @@
Anything specified on
.Nm Ns 's
command line is appended to the
-.Ql Ev MAKEFLAGS
+.Sq Ev MAKEFLAGS
variable which is then
entered into the environment for all programs which
.Nm
@@ -918,8 +918,8 @@
.It Va .MAKE.MAKEFILE_PREFERENCE
The ordered list of makefile names
(default
-.Ql Pa makefile ,
-.Ql Pa Makefile )
+.Sq Pa makefile ,
+.Sq Pa Makefile )
that
.Nm
will look for.
@@ -954,7 +954,7 @@
Normally
.Nm
will not create .meta files in
-.Ql Va .CURDIR .
+.Sq Va .CURDIR .
This can be overridden by setting
.Va bf
to a value which represents True.
@@ -1021,7 +1021,7 @@
Provides a list of path prefixes that should be ignored;
because the contents are expected to change over time.
The default list includes:
-.Ql Pa /dev /etc /proc /tmp /var/run /var/tmp
+.Sq Pa /dev /etc /proc /tmp /var/run /var/tmp
.It Va .MAKE.META.IGNORE_PATTERNS
Provides a list of patterns to match against pathnames.
Ignore any that match.
@@ -1035,16 +1035,16 @@
.It Va .MAKEOVERRIDES
This variable is used to record the names of variables assigned to
on the command line, so that they may be exported as part of
-.Ql Ev MAKEFLAGS .
+.Sq Ev MAKEFLAGS .
This behavior can be disabled by assigning an empty value to
-.Ql Va .MAKEOVERRIDES
+.Sq Va .MAKEOVERRIDES
within a makefile.
Extra variables can be exported from a makefile
by appending their names to
Home |
Main Index |
Thread Index |
Old Index