CVS log for src/usr.bin/make/make.1

Up to [cvs.NetBSD.org] / src / usr.bin / make

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

make.1 clarify use of MAKEOBJDIRPREFIX

Note that MAKEOBJDIRPREFIX should be an absolute path.
Also that MAKEOBJDIRPREFIX and MAKEOBJDIR *can* be set
via makefile variables, but that care is needed to avoid
unwanted side effects.

make: allow -f .../Makefile

If the arg to -f or an entry in .MAKE.MAKEFILE_PREFERENCE
starts with ".../" look for the rest of the path in .CURDIR
and above.

Reviewed by: rillig

Only list the defaults for MAKEFILE_PREFERENCE once

make: add :tc to capitalize first letter of each word

This is very hard to do without :tc

Reviewed by: rillig

make: add .export-all

An explicit syntax for exporting all global variables is much safer
than allowing .export with no argument to do the same.

Add .export-all and have .export with no argument throw a warning saying
to use .export-all

Reviewed by: rillig

make: allow debugging the warning about .OBJDIR

When make complains about an unwritable .OBJDIR
it is not always obvious how we derrived that value.

If MAKE_DEBUG_OBJDIR_CHECK_WRITABLE is enabled call PrintOnError
so we can examine variables that are likely relevant.

Fix description of MAKE_OBJDIR_CHECK_WRITABLE in make.1

make: record exit status in GNode

SetErrorVars can now set .ERROR_EXIT which allows
a .ERROR target to ignore the case of .ERROR_EXIT == 6
which means failure happened elsewhere.

Reviewed by:

Note that in both :U and :D newval may be empty

Indicate that for :U newval is optional

Compat_RunCommand call Shell_Init is shellPath is NULL

Since .SHELL is potentially used in compat mode as well,
the man page description should not imply it is only used in jobs mode.

Remove path="sh" from shell-sh unit-test - and it would have detected
this bug.

Reviewed by: rillig

make: fix typo

Add .MAKE.JOBS.C to indicate wether -jC is supported

make: allow -j to compute a multiple of ncpu

If _SC_NPROCESSORS_ONLN is supported; and -j arg is a floating point
number or ends in 'C' compute .MAKE.JOBS as a multiple of _SC_NPROCESSORS_ONLN

Based on a suggestion from des at freebsd.org
Discussed with: rillig, christos

make.1: note that %s should only be used with :localtime

make.1: clean up wording, clarify scope of '!' in conditions

Make :mtime operate on each word in variable value.

Reviewed by: rillig

make: :mtime=error throw error on stat(2) failure

Sometimes we want fatal error if stat fails on the
presumed pathname.

make: add :mtime to provide mtime of file

The value of the variable is passed to stat(2)
and st_mtime is new value.
An optional arg can be used if stat(2) fails, otherwise
the current time is used.

See varmod-mtime.mk for usage examples.

make.1: lose the trailing blank lines

make: fix description of .PREFIX

For at least 20 years, the setting of .PREFIX in make
has not matched the documentation.
Since the documented behavior does not match reality or
POSIX make, fix the documentation.

In FindDepsRegularPath str_basename is applied to .PREFIX
this is wrong, but I was unable to verify fixing it
was benign in NetBSD build - my NetBSD box (7.2)
was unable to build known-good src with or without any patches.

For now just document the behavior more accurately.

Document unexplained *** Error code 6

make: some variables should be read-only

Make variables like .newline and .MAKE.{GID,PID,PPID,UID} read-only.

Reviewed by: rillig

make: .SYSPATH: to add dirs to sysIncPath

.SYSPATH: with no sources will clear sysIncPath
otherwise sources are added

Reviewed by: rillig

make: .[NO]READONLY for control of read-only variables

Reviewed by: rillig

Pull up following revision(s) (requested by rillig in ticket #31):

	usr.bin/make/make.1: revision 1.351
	usr.bin/make/make.1: revision 1.352
	usr.bin/make/make.1: revision 1.353
	usr.bin/make/make.1: revision 1.354
	usr.bin/make/make.1: revision 1.355
	usr.bin/make/make.1: revision 1.356

make.1: reduce indentation of the long list of variable names

make.1: move description of .MAKE.MODE below the .MAKE.META block

make.1: use consistent markup for boolean flags

make.1: sort list of built-in variables

make.1: sync list of built-in variables with reality
Fixes PR 57029.

make.1: fix markup

make.1: bump date

make.1: fix markup

make.1: sync list of built-in variables with reality

Fixes PR 57029.

make.1: sort list of built-in variables

make.1: use consistent markup for boolean flags

make.1: move description of .MAKE.MODE below the .MAKE.META block

make.1: reduce indentation of the long list of variable names

make.1: clarify in which case an expression may omit braces

make.1: make horizontal and vertical spacing more consistent

make.1: clean up style, typography, accuracy

In a code example, replace the deprecated `pwd` with the preferred form
$$(pwd).

Shorten the paragraph about escaping a dollar in modifiers, as the
various escaping mechanisms are described in the section 'Expansion of
variables'.

Summarize the previously many cases of the ':from=to' modifier to be
simpler to understand, actually mention what the pattern matching
character '%' can match.

Describe the syntax of function call expressions in conditionals.
Previously, only the function names had been documented.

make(1): fix and simplify optional negation on conditional

make(1): use .Dl for one-line literal display

make.1: make typography more consistent

make.1: fix typography, especially spacing

make.1: fix style of ellipsis

In most places, '...' is not intended to be entered verbatim, instead it
is a placeholder, so don't use a fixed-width font for it.

make.1: remove extraneous .El, update date

make.1: split section on directives into several subsections

Directives such as .error or .undef are not conditionals.  Having these
directives mixed in a single list made it more difficult to see how the
directives relate.

make(1): add space before the punctuation argument

make.1: clean up and make the description more accurate

Most changes are editorial.  Notable exceptions are:

The ':Q' in MAKE_PRINT_VAR_ON_ERROR was wrongly added in the previous
commit.  As that variable does not produce a shell command, there is no
point in quoting the characters.

Since 2012.10.07.19.17.31, make doesn't complain anymore if a shell
command in compat mode expands to an empty string, which removes the
need to "keep make happy".

make.1: only use .Pa for actual pathnames

make.1: rewrite many details in a more precise way

make.1: clean up style, grammar, punctuation, improve clarity

make.1: remove redundant 'then' from conditional sentences.

make.1: use present tense in conditional sentences

These sentences are about general, timeless rules, rather than about
predictions about the future.

make.1: clarify interpretation of conditionals

String literals in quotes are never interpreted as numbers.

The operators '<', '<=', '>', '>=' are only allowed in numeric
comparisons.

Avoid the term 'C relational operators' since in C, the relational
operators exclude '==' and '!=', which are called equality operators
instead.

make: clean up handling of .break in .for loops

Move For_Break further up, as the functions in that file are sorted from
small to big.  The cast from size_t to unsigned int is required by lint.

In parse.c, move the code into a separate function to keep
ParseDirective small.  Its only job is to parse the directive and then
delegate to another function doing the actual work.

In the manual page, remove empty lines.

In the test, ensure that .break stops processing of the .for loop
immediately; anything after the .break is not processed anymore.
Replace ':=' with '=', as there is no need to evaluate '$i' early.
Check the expected value in the .mk file instead of the .exp file, to
keep the reading scope as small as possible.

make: add .break to terminate .for loop early

When .break is encountered within a .for loop
it causes immediate termination.

Outside of a .for loop .break causes a parse error.

Reviewed by: christos

make(1): mark up the variable expansion example

make(1): use .Dl for .MAKE.JOB.PREFIX examples

make(1): prettify .for index variable example

make(1): more .Va fixes

make(1): mark up FRC in BUGS

make(1): Use .Dq instead of literal ASCII quotes

make(1): Be consistent about using .Va for make variables

make.1: fix accidental removal of the directive 'export'

make(1): more .Ar fixes

make(1): ".../" in -m option description is literal ".../"

make(1): Consistent formatting for -i and -s descriptions.

make(1): Fix markup of the -d[flags] section.

The debug flags are literals, not syntactic variables (.Ar).
While here use .Dq for quoted words in the text.

make(1): Fix some obviously wrong uses of .Va

make.1: clean up formatting and grammar, be more accurate

make.1: not every '-' is a flag

make.1: fix markup for variable modifiers, add italic correction

make.1: fix markup for options, they are not arguments

make.1: fix ugly line break in PostScript output

make.1: fix markup

Not all square brackets are options, some are wildcards.

make.1: replace redundant .Ql with .Sq

make: describe variable assignment and evaluation more precisely

Variables in make are not "much like variables in the shell", they only
look that way.  Their behavior is more similar to C preprocessor macros.

The spaces around a variable value are removed when parsing the variable
assignment, not after evaluating it.

Before describing the variable assignment operators, introduce the
general syntax of a variable assignment.

Add a separate subsection "Expansion of variables", since assignment and
expansion are unrelated.  Illustrate how variable expansions look
instead of describing it in many words.

Describe how variables are expanded in conditionals, since that is
different from everywhere else.

make: allow to randomize build order of targets

In complex dependency structures, when a build fails, a probable cause
is a missing dependency declaration between some files.  In compat mode,
the build order is deterministic, in jobs mode, it is somewhat
deterministic.  To explore more edge cases, add the line ".MAKE.MODE +=
randomize-targets" somewhere in the makefile.

Fixes PR bin/45226 by riastradh.  Reviewed by christos.

make: only switch to POSIX mode if '.POSIX:' is the first line

https://pubs.opengroup.org/onlinepubs/9699919799/utilities/make.html
says that in order to make a makefile POSIX-conforming, its first
non-comment line must be the special dependency line '.POSIX:' without
any source dependencies.

Previously, make switched to POSIX mode even if such a line occurred
anywhere else, which was allowed by POSIX but was deep in the
"unspecified behavior" area.  For NetBSD make, there is no big
difference since it doesn't ship any <posix.mk> file, this change mainly
affects the bmake distribution.

Previously, makefiles that contain '.POSIX:' somewhere in the middle
could fail due to <posix.mk> resetting .SUFFIXES, among other things.

Suggested by Simon J. Gerraty, who also reviewed an earlier version of
this change.

Mention 'make -r' with .POSIX

Include posix.mk when .POSIX: first encountered

Since .POSIX: is required to be the first non-comment line
in a Makefile, including ${MAKE_POSIX_MK} or whatever _PATH_POSIX_MK is
set to at this point is equivalent to an extension of sys.mk

This is a minimal change that can allow a better approximation of
POSIX compliance

Reviewed by: rillig

make: fix mistakes, spelling and typos in comments and manual page

No binary change for -DNDEBUG.

Tweak description of local variable assignments

Document quirks of target local variable assignments

Allow local variable assignments in dependency lines

The variable is set in the context of the target.
This syntax has been supported by gmake for ~ever.
If necessary a makefile can set .MAKE.TARGET_LOCAL_VARIABLES=false
to disable this.

Expose GetBooleanExpr so parse.c can use it.

meta.c: add .MAKE.META.CMP_FILTER

On rare occasions it is useful to be able to filter command lines
before comparison.

Add .SUFFIXES as read-only variable.

References to ${.SUFFIXES} are handled dynamically in
ParseVarnameLong by calling Suff_NamesStr.

The variable cannot be set normally.

Reviewed by: rillig

Document :On modifiers in more detail.

make: fix typo in manual page, add more tests for the new ':On'

Add :On for numeric sort

Reviewed by: christos rillig

make: rename context and ctxt to scope

This continues the previous commit, in which VAR_GLOBAL, VAR_INTERNAL
and VAR_CMDLINE were renamed.

Renaming the variable 'ctxt' was trivial since that word is used nowhere
else.  In the comments though, each occurrence of the word 'context' had
to be checked individually since the word 'context' was not only used
for referring to a variable scope.  It is also used to distinguish
different situations where characters are escaped in a certain way
('parsing context') and in a few other expressions.

make(1): remove trailing whitespace in manual page

make(1): allow .undef to undefine multiple variables at once

Since make doesn't support variable names containing spaces, this edge
case is not enough reason to stop this feature.  Having multiple
variable names as arguments nicely aligns with other directives such as
.for and .export.

Add .MAKE.UID and .MAKE.GID

make(1): document the -S option

This option has been available at least since 1993-03-21, and for the
same time it has been undocumented.

Pass a writable flag to Main_SetObjdir to control writable check

For curdir and an explicit .OBJDIR target, we allow for
the directory to be read-only.
During InitObjdir we otherwise default to requiring objdir to be
writable - this can be controlled by env variable
MAKE_OBJDIR_CHECK_WRITABLE

Add unit-tests/objdir-writable

Reviewed by: christos rillig

make(1): fix manual page regarding numerical comparisons

Make uses double, not int, for comparing things.

make(1): fix manual page about the modifiers of the :C modifier

Add .SHELL as read-only variable

The .SHELL variable represents the shellPath used to run
scripts.

Reviewed by: rillig, christos

make(1): fix a few inconsistencies in the manual page

Also mention that make dependency operators must be uniform.

This wasn't previously documented, I think.

Rework the description of the :, !, and :: dependence operators to make sense.

Bump date.

Add -dL for LINT

When parsing variable assignments other than := and if
value contains '$' attempt Var_Subst the same as for :=,
if the value does not parse correctly, we get a fatal error
including file an line number.

This can greatly help with finding the cause of problems.

Reviewed by: christos

Add -dh for DEBUG_HASH

Allow tracking of max chain length, to see how well the hash
tables are working.
Pull the actual hash operation into a marco so it can be
easily changed - for experimenting.

The current hash, is pretty good.

Reviewed by: christos

Remove trailing whitespace.

make: add :Or for reverse sort

:Or is more efficient than :O:[-1..1]

Reviewed by: christos

document the SYSV ${VAR:old=new} corner cases.

Merge changes from current as of 20200406

Remove trailing whitespace.

Make delimiters in <file> and "file" literal.

Fix usage of angle-brackets and quotes in make(1) manpage

make(1) has commands .include <file> and .include "file",
but the manpage was (inconsistently) rendering <file> with
angle-brackets (e.g. in UTF8  ) and "file" with curly-quotes
in HTML output (but not text).

This is an attempt to fix that and output only literal <file>
and "file" as is actually required in the makefile.fileoutput,

https://reviews.freebsd.org/D21470

Submitted by Mateusz Piotrowski (FreeBSD)

Revert the filemon removal in bmake, as pointed out by maya we do care
about not introducing divergence with FreeBSD, and the cost of unused
is acceptable here.

Retire filemon, discussed on tech-kern@.

Sync with HEAD

make(1): minor grammar fixes in BUGS section

Sync with HEAD

Pull up following revision(s) (requested by christos in ticket #870):

	sys/lib/libgnuefi/Makefile.inc: revision 1.5
	external/mit/xorg/xorg-pkg-ver.mk: revision 1.9
	sys/arch/i386/stand/lib/Makefile.inc: revision 1.17
	sys/compat/common/Makefile.inc: revision 1.25
	usr.bin/make/unit-tests/varquote.exp: revision 1.1, 1.2
	sys/lib/libsa/Makefile.inc: revision 1.24
	usr.bin/make/var.c: revision 1.220
	sys/arch/ia64/stand/efi/libefi/Makefile.inc: revision 1.5
	sys/arch/hppa/spmath/Makefile.inc: revision 1.10
	usr.bin/make/unit-tests/varquote.mk: revision 1.1, 1.2
	usr.bin/make/unit-tests/Makefile: revision 1.53
	sys/lib/libkern/Makefile.inc: revision 1.45
	sys/arch/acorn32/stand/lib/Makefile.inc: revision 1.4
	sys/arch/m68k/fpsp/Makefile.inc: revision 1.21
	usr.bin/make/make.1: revision 1.273
	sys/lib/libz/Makefile.inc: revision 1.17

- Introduce :q modifier for make variables and make it double escape $'s so
  that passing variables to recursive makes with :q works as expected.
- Adjust makefiles that use recursive make to use :q

Discussed on tech-toolchain@

XXX: pullup 8

- Introduce :q modifier for make variables and make it double escape $'s so
  that passing variables to recursive makes with :q works as expected.
- Revert :Q to work as before.
- Adjust makefiles that use recursive make to use :q

Discussed on tech-toolchain@
XXX: pullup 8

Sync with HEAD.  77 conflicts resolved - all of them $NetBSD$

Fix bad markup.

Pull up following revision(s) (requested by jmcneill in ticket #113):
	usr.bin/make/main.c: 1.266-1.272
	usr.bin/make/make.1: revision 1.267
move some code out of the gigantic main function; no functional change.
--
-V: try to expand the variable again if the value contains a variable.
--
simplify
--
a variable that starts with \\ is not expanded.
--
Remove previous variable expansion code; sjg had already added the code to
do it. Note that the manual page already documents this behavior and does
not need to change:
        -dV -V VAR:     prints the raw variable
        -V VAR:         prints the expanded variable
--
make the code look like to 1.266
--
Add -v variable that always expands variables; restore -V the way it was.

Remove workaround for ancient HTML generation code.

Improve description of -V. Can probably be improved further.

Whitespace fixes.

Document what the magic variable .MAKE.EXPAND_VARIABLES actually does.

Add -v variable that always expands variables; restore -V the way it was.

Sync with HEAD

Sync with HEAD

Since we are avoiding VAR_INTERNAL, allow the variable :_ stores to
to be specified, also allows for multiple stages of modification to
be stashed.

Add :range and :_

:range	replaces var value with an integer sequence one per word
	in the current var value.

:_	stores the current var value in $_ so that it can be referred to
	later in the modifier series.

Reviewed by: christos

Allow providing a utc value to :{gm,local}time

Reviewed by: christos

Document .DELETE_ON_ERROR.

Whitespace.

Add .MAKE.META.IGNORE_FILTER to allow more complicated filtering of filemon data.

The filter is applied to paths Read or Excuted, and if it expands to
nothing, the entry is skipped.

For example; dirdeps.mk can set this to:

.MAKE.META.IGNORE_FILTER = M*/${.MAKE.DEPENDFILE_PREFIX}*

when checking if DIRDEPS_CACHE is up to date, where only Makefile.depend*
are of interest.

Set .ERROR_CMD if we can

Fix typo in width argument; end sentence with dot.

Refactor the logic for deciding when a .meta file is needed.

Both meta_create() and meta_oodate() now share meta_needed()
to indicate if a .meta file is needed.

This allows for deciding that missing .meta file is cause of out-of-date.
The new knob 'missing-meta' controlls this, and is off by default
since the side effect files of generators like yacc will typically need
.NOMETA to avoid problems.

This however makes it much easier for folk to switch back and forth
with meta mode (eg. FreeBSD's normal build can leverage meta mode for
improved reliablility without need to clean).

Also if .MAKE.MODE does not contain 'nofilemon', the knob
'missing-filemon' allows control as to whether missing filemon data
should cause the target to be out-of-date.
Again off by default.

Allow for ignoring paths that match a set of patterns.
This can be expensive, so use with caution.

Fix syntax

make $@ an alias for $! in archive member rules (compatibility with
other makes).

Spelling fixes.

Add a knob .MAKE.SAVE_DOLLARS to control the behavior of $$ during :=

If TRUE '$$' are not consumed (saved).
If FALSE '$$' becomes '$' just like normal expansion rules.

default is TRUE.

Reviewed by: christos

Add .export-literal to avoid the need for $$ dance when trying to put
unexpanded variables into environment.

Reviewed by: christos

It's 2016

Add support for .dinclude

Like .sinclude missing file will be ignored.
Like .depend stale dependencies will be ignored.
Allows better implementation of auto depend.

Reviewed by: christos
Requested by: Bryan Drewery at FreeBSD.

Drop trailing whitespace.

Document .OBJDIR target.

It's 2015.

Remove trailing whitespace.

Forgot to tweak date

jobs mode handles '-' very differently to compat mode, but this is not
reflected in make.1
Also fix handling to match the behavior described in the comment
of JobPrintCommand (only matters if shell sets hasErrCtl).

A better long term solution is needed since the current behavior
is sub-optimal wrt '-' and different from all other makes.

Reviewed by: christos

Small markup fixes:
* Use \e instead of \\ to represent a backslash;
* Dont' start a line with .SUFFIXES.

bump date; I think I'm done for tonight

Add some notes on compatibility with other make dialects.

I was originally intending to preserve some of Jarmo Jaakkola's notes
on POSIX make from the PR 49085 changes... but really there's no point
wandering into details about $? and such when the big picture is
"almost everything in this manual works only in BSD make".

Maybe the exact details can be stuffed into a chapter of the mythical
make reference manual if that ever gets (re)written.

Improve the documentation of rule-local variables. Cherry-picked from
the PR 49085 changes, with some adjustments by me.

Improvements pertaining to shell commands and chdir. Some of this
appeared in the PR 49085 changes, even though it's not actually
relevant there except tangentially. However, I've reworked most of
that for clarity and added some more.

Restore -r1.234 of make.1, which was an unrelated fix from sjg pertaining
to the docs for the -w option.

Revert the man page as well. (hi joerg)

Revert it to 20140823 (-r1.230), before the controversial commits,
which changed it a good deal.

Reduce pirate slang.

document commented out .INVISIBLE and .JOIN.

Enter/leave flag is -w not -dw

PR/46096: Jarmo Jaakkola: fix many problems with dependencies (PR 49086)

Quite extensive rewrite of the Suff module.  Some ripple effects into
Parse and Targ modules too.

Dependency searches in general were made to honor explicit rules so
implicit and explicit sources are no longer applied on targets that
do not invoke a transformation rule.

Archive member dependency search was rewritten.  Explicit rules now
work properly and $(.TARGET) is set correctly.  POSIX semantics for
lib(member.o) and .s1.a rules are supported.

.SUFFIXES list maintenance was rewritten so that scanning of existing
rules works when suffixes are added and that clearing the suffix list
removes single suffix rules too.  Transformation rule nodes are now
mixed with regular nodes so they are available as regular targets too
if needed (especially after the known suffixes are cleared).

The .NULL target was documented in the manual page, especially to
warn against using it when a single suffix rule would work.
A deprecation warning was also added to the manual and make also
warns the user if it encounters .NULL.

Search for suffix rules no longer allows the explicit dependencies
to override the selected transformation rule.  A check is made in
the search that the transformation that would be tried does not
already exist in the chain.  This prevents getting stuck in an infinite
loop under specific circumstances.  Local variables are now set
before node's children are expanded so dynamic sources work in
multi-stage transformations.  Make_HandleUse() no longer expands
the added children for transformation nodes, preventing triple
expansion and allowing the Suff module to properly postpone their
expansion until proper values are set for the local variables.

Directory prefix is no longer removed from $(.PREFIX) if the target
is found via directory search.

The last rule defined is now used instead of the first one (POSIX
requirement) in case a rule is defined multiple times.  Everything
defined in the first instance is undone, but things added "globally"
are honored.  To implement this, each node tracks attribute bits
which have been set by special targets (global) instead of special
sources (local).  They also track dependencies that were added by
a rule with commands (local) instead of rule with no commands (global).

New attribute, OP_FROM_SYS_MK is introduced.  It is set on all targets
found in system makefiles so that they are not eligible to become
the main target.  We cannot just set OP_NOTMAIN because it is one of
the attributes inherited from transformation and .USE rules and would
make any eligible target that uses a built-in inference rule ineligible.

The $(.IMPSRC) local variable now works like in gmake: it is set to
the first prerequisite for explicit rules.  For implicit rules it
is still the implied source.

The manual page is improved regarding the fixed features.  Test cases
for the fixed problems are added.

Other improvements in the Suff module include:
  - better debug messages for transformation rule search (length of
    the chain is now visualized by indentation)
  - Suff structures are created, destroyed and moved around by a set
    of maintenance functions so their reference counts are easier
    to track (this also gets rid of a lot of code duplication)
  - some unreasonably long functions were split into smaller ones
  - many local variables had their names changed to describe their
    purpose instead of their type

Bump date for previous.

PR/49085: Jarmo Jaakkola: fix several parsing errors

Don't exit from var.c:Var_Parse() before possible modifiers are handled
on D and F modified versions of local variables.  Properly expand $(?D)
and $(?F) too.

Make line continuations in rule's commands POSIX compliant.

Fix the syntax error caused by lib(member) as the last target before
a dependency operator.

Document the line continuation change in the manual page.  Also talk
more about the POSIX style local variables and their modifiers.

Add tests covering the fixed problems into d_posix.mk.  The test is
a known failure at the moment because of PR 49086 and PR 49092.

[XXX: unconverted tests]

Rebase to HEAD as of a few days ago.

sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs.  ("Protocol error: too many arguments")

Put .INCLUDEDFROM* in the right section

Emphasise the fact that the regexp and replacement in :C/// are
subjected to variable expansion before regexp parsing.  This was already
documented if you read carefully enough, but more emphasis would have
helped me to figure out why I needed three or four backslashes where I
expected to need only two.

Bump date for previous.

add .INCLUDEDFROM{FILE,DIR}

apostrophe's do not make plural's.

Remove trailing whitespace.

Explain that ${VAR:M*} will normalise the inter-word spacing.

The :C/// modifier takes an extendedregular expression.

Use Va markup to show that the "suffix" part of ".PATH.suffix"
is a placeholder, not a literal string.
Also bump date.

Document .PATH.suffix:. Noted by apb back in December of 2008
(that's how long my queue is...)

Allow an empty .MAKE.JOB.PREFIX to supress output of --- job --- tokens

More gmake compatibility:
1. add -w flag to print Entering and Leaving directory name the the beginning
   and the end of processing.
2. export MAKELEVEL=$((MAKELEVEL + 1)) only in the child environment.
3. when printing error messages, prefix them with the program name [$MAKELEVEL]
   for $MAKELEVEL > 0
4. if $MAKEFLAGS consists only of letters assume it is a set of flags (as
   allowed by posix), convert them to -f -l -a -g -s, so that they get parsed
   properly.
With those fixes gmake -> bmake -> gmake -> bmake etc. works as expected.

fix a typo

Remove trailing whitespace.

Add .MAKE.META.IGNORE_PATHS to facilitate local additions to the paths
which should be ignored by meta_oodate().

resync from head

improve wording

put a note on what FRC means.

Refine the effect of .OODATE on command comparison.
Rather than apply it to the whole script, just the current command line
is affected.   This allows a trick like ${.OODATE:M.NOMETA_CMP}
to cause command comparison to be supressed for one command only.

If built with filemon support, set .MAKE.PATH_FILEMON to _PATH_FILEMON
so that makefiles can test for it.

Add a .STALE special target that gets invoked when dependency files contain
stail entries.

resync with head

In SHELL COMMANDS section, provide some clues about different
behavior in jobs vs non-jobs mode.
Move the comment about when shell is skipped to this discussion
from COMPATABILITY.
Remove the incorrect statement about default mode being somehow
neither jobs mode or compat mode (it is compat mode).

Resync to 2012-11-19 00:00:00 UTC

sync with head

It is Sprite, not Sprint; pointed out by Todd Miller.

spelling

Document the fact that lack of shell meta chars in a command
results in direct exec in compat mode.

Add an s.

Add a knob to control whether -V fully expands a plain variable by default.
The default retains the traditional NetBSD behavior, but the knob
can be set so that FreeBSD can retain their expected behavior.
This is a compromise to be sure.

Add a debug flag -dV to override the above, so that regardless of
the knob setting, the raw value of a variable can be easily seen.

sync with head.

Restore previous behavior - supressing duplicate entries in
.MAKE.MAKEFILES - it is more efficient.

Fix some typos in/around ParseGmakeExport.
Remove the suppresssion of duplicate entries in .MAKE.MAKEFILES

sync with head

Remove unnecessary Bk/Ek pairs from SYNOPSIS.
No effective change except where I used the opportunity to sort options
and/or option descriptions.

document gmake export command

Fix description of 'silent' in .MAKE.MODE
Also document 'env' in that context.

Mention limits of :P

The :@ example gives the impression that we encourage the ODE
convention of naming loop variables like .LINK., when in fact
single char variables are far more common in NetBSD.

Fix xref to the PSD; PR 45568 from Petri Laakso.

sync with head

explain how to use .PARSEDIR and .PARSEFILE

In meta mode, we create .meta files for most targets.
These capture all the interesting data - useful for debugging.
In such cases there is no need to replicate commands in the build log.
Rather than run the entire build .SILENT, allow meta mode to set that flag
per target iff a .meta file is created.
Normal behavior is retained for targets where no .meta file is created,
ensuring that no build data is lost.

Make some dashes em-dashes (based on patch from Andrew O. Shadoura).
Note behavior of .META flag wrt out-of-date.

dependant -> dependent

fix bug in section .ORDER of make.1

Remove trailing whitespace.

Document what I wrote for PR/40115

Add .MAKE.META.BAILIWICK - to identify the scope of make's control.
meta_oodate: if a file that was written or linked within our bailiwick,
but outside of .OBJDIR is missing, add it to missingFiles.
If we get to the end of the .meta file without seeing it [re]moved,
then consider the target out-of-date.

Remove trailing whitespace.

Add :localtime and :gmtime which use value as format string for strftime.

Add the :hash modifier to compute a 32bit hash of an variable.
This uses MurmurHash3 to get a reasonable collission-free hash with
small code. The result is endian neutral.

Use curdirOk as the token

When .MAKE.MODE inlcudes 'meta'; 'curdir=true' enables creating .meta
files in .CURDIR - such as when running make in .OBJDIR with a generated
makefile.

Sync with HEAD

Fix rendering of :? example

Remove trailing spaces, add a few serial commas.

Bump date

Add meta.c which implements "meta" mode for make.
In this mode, a .meta file is created for each target, capturing
the expanded commands used, any command output, and if filemon(9)
is available, a record of system calls which are of interest.
Not enabled unless USE_META=yes is set when building make.
Also, if FILEMON_H exists, meta.c will be compiled to use filemon(9).

Document that suffix rules are not applied to PHONY targets, and also
document the .TARGETS builtin variable, which has existed since 4.4 days.
Bump date. Arises from discussion in PR 43502.

fix previous, the source isn't exactly crystal clear and there's a bug that
makes the behavior misleading.

Clarify $(.PREFIX) / $*. Bump date.

Whitespace.

Explain variable expansion better. Requested by Aleksey Cheusov

Bump date for previous.

Add .export-env which tells make to export a variable to the environment
but not to track it - as is done for .export
This allows the variable to be updated without affecting what was put
into the environment.
Older versions of make will simply treat this as .export

Drop trailing white space. Use .Oo / .Oc explicitly to annotate that the
empty content is intended.

PR: 42850
Reviewed by:

modmisc: since we apply an exists() test to $paths, be conservative
in what we expect.

Run the unit tests with -r -m / so that we do not fail if there
is no sys.mk present.

Add :tA to attempt to resolve to absoute path using realpath().

Sort a bit more.

Add:

.error "message"
.warning "message"
	based on FreeBSD implementation.
	add .info while were at it.

.ERROR:	a target to run on error.
	We pass the failing GNode to PrintOnError so it can set
	.ERROR_TARGET.

.MAKE.MAKEFILE_PREFERENCE
	As a means to control make's list of prefered makefile names.
	(Default: "makefile Makefile")

.MAKE.DEPENDFILE
	Names the file to read dependencies from
	(Default ".depend")

.MAKE.MODE
	Processed after all makefiles are read.
	Can put make into "compat" mode (more to come).

Fix:

compat.c: Error code should not be sent to debug_file.
Make_DoAllVar: use DONE_ALLSRC to avoid processing a node multiple times.
ReadMakefile: we can simply use doing_depend to control setting MAKEFILE.

\\ -> \e

New sentence, new line; remove trailing whitespace.

Add .unexport - the exact opposite of .export
and .unexport-env which unexport's all previously .export'd globals
as well as clearing environ[].
Allow's sys.mk near total controll.

Reviewed by: apb

Do not work around ancient groff limits with .Xo/.Xc.

Remove trailing whitespace.

Add example of how to use the ?: modifier properly.

Reviewed by: apb

Use .MAKE.LEVEL to track recursion.
The first instance of make will have .MAKE.LEVEL 0, which
can be handy for excluding rules which should not apply
in a sub-make.
gmake and freebsd's make have a similar mechanism, but each
uses a different variable to track it.  Since we cannot be
compatible with both, we allow the makefiles to cope if they want
by handling the export of .MAKE.LEVEL+1 in Var_Set().

Bump date

Add -C directory, same as gmake and freebsd make.

Missing ':' in .ORDER example

Whitespace fix.

Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html

Typo fix: many file -> many files.

Bump date for previous.

Honour the TMPDIR environment variable instead of always using /tmp
as a place to store temporary files.

Sort sections. Fix typo (last line).

Correct the definition of the :? modifier - in particular the modifier
applies to the variable name, not its value!
Remove the set of examples that were recently added that failed to
explain why some worked and some didn't.
Add a not to the compatability section about the change in .for loop
substitution post 5.0.
Add a BUGS section.
XXX the BUGS section needs more entries :-)

Pull up following revision(s) (requested by dholland in ticket #271):
	usr.bin/make/make.1: revision 1.151
Fix blatantly wrong exposition of .WAIT example.
PR bin/40372 from Gao Ya'nan.

Pull up following revision(s) (requested by dholland in ticket #1262):
	usr.bin/make/make.1: revision 1.151
Fix blatantly wrong exposition of .WAIT example.
PR bin/40372 from Gao Ya'nan.

Pull up following revision(s) (requested by dholland in ticket #1262):
	usr.bin/make/make.1: revision 1.151
Fix blatantly wrong exposition of .WAIT example.
PR bin/40372 from Gao Ya'nan.

Fix blatantly wrong exposition of .WAIT example.
PR bin/40372 from Gao Ya'nan.

Note that an unrecognised word in a .if is the same as in .ifdef and that
such a word has to be white-space separated.
From PR bin/30967 bin/37222 and maybe others!

Add some notes about recursive expansion and expansion of variable names.
Note that any of "${}()" in variable names will be griefsome!
Remove the example of using ::= to apply a modifier to a .for loop
variable as that is no longer necessary.
Remember to change the date :-)

explain compatibility mode better.

add debug flag for cwd.

Pull up following revision(s) (requested by christos in ticket #135):
	usr.bin/make/make.1: revision 1.146
I think ':' is called "colon", not "column" :)

Pull up following revision(s) (requested by christos in ticket #135):
	usr.bin/make/make.1: revision 1.145
PR/40026: Aleksej Saushev: make(1) doesn't document VPATH, document it.

I think ':' is called "colon", not "column" :)

PR/40026: Aleksej Saushev: make(1) doesn't document VPATH, document it.

Whitespace.

Update the modification date

Add some examples of how to use :?

Send debugging output to stderr by default, not to stderr.
If you really want debugging to stdout, specify "-dFstdout"
in MAKEFLAGS or on the command line.

Discussed in tech-userlevel.

Add missing dot before macro.

Always make the debugging output unbuffered; in addition, if debugging
is enabled but debugging output is not directed to stdout, then make
stdout line buffered.

Previously, the code to make debug output unbuffered applied only if
debugging to a file, not if debugging to stdout or stderr.  Making
stdout line buffered when debugging was suggested by Steven Bellovin.

Document how "-dF[+]filename" works.

Sync with wrstuden-revivesa-base-2.

Drop trailing whitespace. Use .Dq.

Clarify a bit .SUFFIXES and .IMPSRC.  Should fix PR#37822.

sync with HEAD

Implement -dl (aka LOUD) to override '@' at the start of script lines.
Based on supplied patch.

PR: 37202

sync with HEAD

Use .MAKE.MAKEFILES to track all the makefiles that have been read
so they can be used in dependency rules.

Add the ability to .export variables to the environment.

Add the ability to tweak the token output before targets in job mode.
Eg.
.MAKE.JOB.PREFIX=${.newline}---${.MAKE:T}[${.MAKE.PID}]
would produce
---make[1234] target ---

Sync w/ NetBSD-4-RC_1

A small word can sometimes express things clearer ...

Apply patch (requested by tron in ticket #696):
	usr.bin/make/compat.c		patch
	usr.bin/make/cond.c		patch
	usr.bin/make/dir.c		patch
	usr.bin/make/for.c		patch
	usr.bin/make/main.c		patch
	usr.bin/make/make.1		patch
	usr.bin/make/make.c		patch
	usr.bin/make/make.h		patch
	usr.bin/make/nonints.h		patch
	usr.bin/make/parse.c		patch
	usr.bin/make/str.c		patch
	usr.bin/make/targ.c		patch
	usr.bin/make/util.c		patch
	usr.bin/make/var.c		patch

Synchronize make(1) with HEAD branch to increase perfomance and
improve stability.

4 -> 4.0, since Nx does not accept all arguments without complaint.

Fix a typo. Use Nx.

Update information on .ORDER and .WAIT.
Document the -d-flags and -dFfilename.%d options.
Mention MAKEFLAGS at the top, reword to make it clear that makefile and
Makefile are only used if no -f makefile is given.

Fixed the bug reported in PR 33866, which is that the :Q operator does not
handle newlines correctly. Ok'ed by christos.

Sync with head.

Fix mispelling.

New sentence, new line.

Document an interesting kwirk in := handling of undefined variables.

Markup fixes.

Make ".WAIT" apply recursively to all children of nodes on the right
hand side of the .WAIT, except when the recursive interpretation would
cause a cycle in the dependency graph.

Discussed in tech-toolchain.  Reviewed by christos, sjg.

Fix typo.

Update man page and add test case for specifying modifiers via variable.
Also allow said variable to appear anywhere in the modifier list.

Make .NOTPARALLEL stop the job engine issuing more than one token (instead
of trying to de-jobify the make.
You can now put .NOTPARALLEL in a submake of a recursive make (where it is
using a job-token pipe from the outer make and have it only run a single job.
You can also specify .NOTPARRALEL in the root makefile of a large recursive
make and have the submakes run multiple commands.
Add some diagnostics printfs (enabled with -dp) to the parser.

Pull up revision 1.113 (requested by rpaulo in ticket #491):
Change "non-escaped" to "unescaped".
Reviewed by hubertf.

Pull up revision 1.110 (requested by rpaulo in ticket #491):
We now support comments until the end of a non-escaped line.
Ok'ed by hubertf.

Consistency. Use Pp instead of br.

Restore the rework from rev 1.115 and expand the description of .OBJDIR
to document the behaviour that is currently in use (the "./obj" and
"/usr/obj/`pwd`" behaviour).
Hopefully the existing .OBJDIR behaviour is clearer now.

Since the obj dir handling changes in the code have been
reverted, revert them in the man page too (i.e., revert v1.115).

Deprecate support for automagically setting the .OBJDIR to
	./obj.${MACHINE}
	./obj
	/usr/obj/${PWD}

The rules for the default .OBJDIR setting are now simplified to
(and documented as) trying the chdir to the following
(if the appropriate variable is defined):
	${MAKEOBJDIRPREFIX}${.CURDIR}
	${MAKEOBJDIR}
	${.CURDIR}

.OBJDIR can be overridden in the makefile.
<bsd.obj.mk> uses this to provide the "culled" .OBJDIR semantics
for NetBSD's /usr/src builds.

MAKEOBJDIRPREFIX & MAKEOBJDIR still can only be provided
in the environment or on make(1)'s command line.

Per discussion on tech-toolchain.
This should reduce a lot of lossage people have experienced over
the years with various .OBJDIR setups.

Fix an article, and drop trailing whitespace.

Change "non-escaped" to "unescaped".
Reviewed by hubertf.

Bump date for -jn, and add some formatting.

Add new debugging option '-dn' which will leave the scripts fed into make on
-j jobs in /tmp for debugging purposes. Add a note to the man page that
this could cause problems if run a lot (due to the number of files created)

Backout ticket 458, it causes PR toolchain/30536.

Pull up revision 1.110 (requested by rpaulo in ticket #458):
We now support comments until the end of a non-escaped line.
Ok'ed by hubertf.

We now support comments until the end of a non-escaped line.
Ok'ed by hubertf.

New sentence, new line; grammar improvements.

Add :Ox for random ordering, based on patch from
Mike M. Volokhov <mishka@apk.od.ua>

Now that dependencies in .BEGIN, .END, and .INTERRUPT work, allow them.

PR/9566: Arne H. Juul: Document special targets that do not obey dependencies.

In the case of :? modifier, variable can be an expression - say so.

Sort options in synopsis.

Pull up revision 1.103 (requested by sjg in ticket #282):
Add comma in enumerations; fix a sentence; plural needs no apostrophe.

Pull up revision 1.102 (requested by sjg in ticket #282):
Remove use of sh -e when running in compat mode.
Its not posix compliant and serves very little purpose.
With this change compat and jobs modes are consistent wrt how
they treat each line of a script.
Add support for the '+' command line prefix as required by posix.
Lines prefixed with '+' are executed even when -n is given.
[Actually posix says they should also be done for -q and -t]
PR:
Reviewed by: jmc

Add comma in enumerations; fix a sentence; plural needs no apostrophe.

Remove use of sh -e when running in compat mode.
Its not posix compliant and serves very little purpose.
With this change compat and jobs modes are consistent wrt how
they treat each line of a script.

Add support for the '+' command line prefix as required by posix.
Lines prefixed with '+' are executed even when -n is given.
[Actually posix says they should also be done for -q and -t]

PR:
Reviewed by: jmc

Bump date; uppercase POSIX.

Briefly document the posix command line order and add that this
is (unfortunately) not enforced.

Use more mdoc macros; new sentence, new line; bump date for previous.

add parent directory search for make as discussed on tech-toolchain.
 - new dir.c function: Dir_FindHereOrAbove:
      Search for a path in the current directory and then all the directories
      above it in turn until the path is found or we reach the root ("/").
 - add hooks to use it in main.c for -m and syspath (compiled in
      _PATH_DEFSYSPATH and $MAKESYSPATH).
 - updated man page

Document more SPECIAL SOURCES (aka ATTRIBUTES).
Improve description of variable modifiers.
In the variable list, be more specific referring to "environment variables"
rather than just relying upon the formatting difference between .Ev and .Va.

Bump date for previous; use macros for marking up
the dollar sign.

Note that variable expansion can occur within SYSV style = substitions.

Drop trailing spaces.

Add back 'on error' that got deleted by mistake.

Add a -Dg3 which outputs the 'input graph' only on error exit.
Lets you see the wood for the trees...

Add some subsections in the VARIABLE ASSIGNMENTS section.

In the "modifier description" list, show each modifier with the leading `:'.
Rationale: it's hard to search for modifiers without it, and we already do
the same thing in the -options and .makecommands lists.  I now find it much
easier to find the description for a modifier in the man page.

properly dottify .\" comments; this fixes output of [range] paragraph

Implement :[] modifier to allow picking a range of words out of a variable.
Also :tW and a W flag to :C and :S to allow treating value as a single word.
Add unit tests for the above, and fix some corner cases.
Based on patches supplied by Alan Barrett <apb@cequrux.com>

Add the 'e' debug flag (i.e., '-d e'):  when enabled, show the "target
failed" and "command failed" messages added recently.  These introduce
too much noise when debugging some kind of problems, specially in pkgsrc.

Document the '-d f' flag.

Whitespace nits.

Allow -V '${FOO}' to print the expanded version of FOO.
A side effect of adding and removing a -E option for the above is that
the cases in MainParseArgs are now ordered correctly?

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

Allow .SHELL: to control the shell used by compat mode too.
Add a shell spec for ksh - a nice portable posix shell.
Document .SHELL:

Bump date for tu addition; drop trailing space; sort a bit.

Add a :ts[c] modifier to allow controlling the separator used between
words in a variable expansion.  If 'c' is omitted no separator is used.

Misc mdoc fixes (mostly quoting).

New sentence, new line; bump date for last.

PR/10917: John Hawkinson: Document $MAKE and say which one we want to be using.

Bump date for last.

Added MAKESYSPATH environment variable as per jmmv's suggestion in
PR 18030

Add a -X option, which prevents make(1) from putting variables
set on the command line into the environment individually.  This
can be useful on systems which have a tight limit on the size
of the argument space.

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

"Utilize" has exactly the same meaning as "use," but it is more
difficult to read and understand. Most manuals of English style
therefore say that you should use "use".

Be more specific how to call arguments of modifiers.

Reviewed By: wiz

Tyop fixes

Bump date for .PATH description; begin sentence with upper case letter;
new sentence, new line.

Whenever we update .PATH, set the variable ${.PATH} to reflect the
search list that will be used.  Thus 'dot' and 'cur' will appear in
${.PATH} either at the start or end depending on .DOTLAST even though
they are not strictly in dirSearchPath.

When .CURDIR is assigned to - re-set the 'cur' Path.

Finally, when checking subdirs, look in 'dot' and 'cur' (first or last
depending on .DOTLAST) just as we do in other situations.

environment variables, not environmental variables

New sentence, new line.

Fix an Xr, add a comma and join two short lines. In short, minor changes :)

add missing Lt.

End some sentences with a dot. bin/17987 by Julio Merino.

clarify how :U works

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Edit -mdoc usage.

* There is no -indent option to .Bd or .Bl, although you would
  never know that from its frequent use in this tree. There is a
  "-offset indent" combination that makes sense, and you can certainly
  say "-width indent".

* Also, you can't markup the -width option argument, tho you CAN
  use a callable macro. So "-width Ar filename" doesn't make sense,
  but either "-width Ar" or "-width filename" does, as might something
  like "-width xxfilename" for a little extra space.

* There are a lot of needlessly complex hanging tag macros in man4 used
  to create simple item lists. Those should be simplified one of these
  days before someone copies and edits yet another man4 page.

Add `tu' and `tl' variable expansion modifiers, which transform the
value to uppercase and lowercase, respectively. From Kevin Neal from FreeBSD.

- Several paragraphs were indented one level further than needed.
- The endfor example needed some spacing readjustments.

outdent description of variable expansion modifiers

Whitespace/punctuation nits.

Add new make variable .ALLTARGETS, which lists all targets in the Makefile.
(Makes it possible to search the target list for particular things and
apply attributes to all the relevant targets.)

Sort list of make variables.

Fix typo in definition of PARSEFILE. It should refer to PARSEDIR (and not
itself twice) when describing the variables lifetime

Nit.

add .USEBEFORE Attribute

Simplify the exporting of VAR_CMD's via MAKEFLAGS.
We now just list the names of such variables in .MAKEOVERRIDES.
When we come to export MAKEFLAGS we quote the value of each exported variable
using :Q, using: ${.MAKEOVERRIDES:O:u:@v@$v=${$v:Q}@}
The :O:u suppresses duplicate names.
Also modifed Parse_DoVar to re-export MAKEFLAGS whenever .MAKEOVERRIDES
is assigned to so .MAKEOVERRIDES+= PATH will export PATH=${PATH:Q}
to the environment, while .MAKEOVERRIDES= will disable export of VAR_CMD's.

Mention .MAKEOVERRIDES

A number of semi-related changes.
1. make -dx turns on DEBUG_SHELL which causes sh -x to be used where
   possible.
2. PrintOnError() is now called when make is stopping due to an error.
   This routine reports the curdir and the value of any variables listed
   in MAKE_PRINT_VAR_ON_ERROR.
3. Variables set via command line, are propagated to child-makes via
   MAKEFLAGS.  This behaviour appears to be necessary for POSIX (according
   to the GNU folk anyway).
4. Do not reset MAKEFILE when reading ".depend" as this rather eliminates the
   usefulness of ${MAKEFILE}.
5. Added ${.newline} as a simple means of being able to include \n in the
   result of a :@ loop expansion.
6. Set ${MAKE_VERSION} if defined.  Need to come up with a useful value.

Reviewed: christos

Pull up revision 1.48 (via patch, requested by wiz):
  Correct getcwd reference, plus whitespace fixes.

getcwd lives in 3, not 2. Whitespace fixes.

Provide a new .if commands(<target>) primitive that returns true if the
target has commands associated with it.