summaryrefslogtreecommitdiffstats
path: root/contrib/bmake/bmake.1
diff options
context:
space:
mode:
authorsjg <sjg@FreeBSD.org>2013-08-02 06:25:28 +0000
committersjg <sjg@FreeBSD.org>2013-08-02 06:25:28 +0000
commitff765cb371f120bb1d6e648a2418a7c9e3f223b2 (patch)
tree8ceaf694b47a0d2b1022393bf58a564bda1b20a2 /contrib/bmake/bmake.1
parent1c55a6beb9a550795753418366eee2961aae82db (diff)
downloadFreeBSD-src-ff765cb371f120bb1d6e648a2418a7c9e3f223b2.zip
FreeBSD-src-ff765cb371f120bb1d6e648a2418a7c9e3f223b2.tar.gz
Merge bmake-20130730
Main feature of interest is .MAKE.JOB.PREFIX= to suppress --- job --- tokens.
Diffstat (limited to 'contrib/bmake/bmake.1')
-rw-r--r--contrib/bmake/bmake.129
1 files changed, 23 insertions, 6 deletions
diff --git a/contrib/bmake/bmake.1 b/contrib/bmake/bmake.1
index 2403eae..021a94a 100644
--- a/contrib/bmake/bmake.1
+++ b/contrib/bmake/bmake.1
@@ -1,4 +1,4 @@
-.\" $NetBSD: make.1,v 1.213 2013/03/31 05:49:51 sjg Exp $
+.\" $NetBSD: make.1,v 1.220 2013/07/30 19:09:57 sjg Exp $
.\"
.\" Copyright (c) 1990, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" from: @(#)make.1 8.4 (Berkeley) 3/19/94
.\"
-.Dd March 30, 2013
+.Dd July 30, 2013
.Dt MAKE 1
.Os
.Sh NAME
@@ -37,7 +37,7 @@
.Nd maintain program dependencies
.Sh SYNOPSIS
.Nm
-.Op Fl BeikNnqrstWX
+.Op Fl BeikNnqrstWwX
.Op Fl C Ar directory
.Op Fl D Ar variable
.Op Fl d Ar flags
@@ -209,6 +209,8 @@ Force the
option to print raw values of variables.
.It Ar v
Print debugging information about variable assignment.
+.It Ar w
+Print entering and leaving directory messages, pre and post processing.
.It Ar x
Run shell commands with
.Fl x
@@ -743,6 +745,9 @@ then output for each target is prefixed with a token
.Ql --- target ---
the first part of which can be controlled via
.Va .MAKE.JOB.PREFIX .
+If
+.Va .MAKE.JOB.PREFIX
+is empty, no token is printed.
.br
For example:
.Li .MAKE.JOB.PREFIX=${.newline}---${.MAKE:T}[${.MAKE.PID}]
@@ -856,6 +861,11 @@ In "meta" mode, this variable contains a list of all the meta files
used (updated or not).
This list can be used to process the meta files to extract dependency
information.
+.It Va .MAKE.META.IGNORE_PATHS
+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
.It Va .MAKE.META.PREFIX
Defines the message printed for each meta file updated in "meta verbose" mode.
The default value is:
@@ -877,7 +887,7 @@ is modified.
.It Va .MAKE.PATH_FILEMON
If
.Nm
-was built with
+was built with
.Xr filemon 4
support, this is set to the path of the device node.
This allows makefiles to test for this support.
@@ -1298,7 +1308,7 @@ should start and end with a period.
For example.
.Dl ${LINKS:@.LINK.@${LN} ${TARGET} ${.LINK.}@}
.Pp
-However a single character varaiable is often more readable:
+However a single character variable is often more readable:
.Dl ${MAKE_PRINT_VAR_ON_ERROR:@v@$v='${$v}'${.newline}@}
.It Cm \&:U Ns Ar newval
If the variable is undefined
@@ -1321,7 +1331,7 @@ The path of the node which has the same name as the variable
is the value.
If no such node exists or its path is null, then the
name of the variable is used.
-In order for this modifier to work, the name (node) must at least have
+In order for this modifier to work, the name (node) must at least have
appeared on the rhs of a dependency.
.Sm off
.It Cm \&:\&! Ar cmd Cm \&!
@@ -2115,6 +2125,13 @@ for Sprite at Berkeley.
It was designed to be a parallel distributed make running jobs on different
machines using a daemon called
.Dq customs .
+.Pp
+Historically the target/dependency
+.Dq FRC
+has been used to FoRCe rebuilding (since the target/dependency
+does not exist... unless someone creates an
+.Dq FRC
+file).
.Sh BUGS
The
make
OpenPOWER on IntegriCloud