MFC r315788:

build(7): sort SEE ALSO section

tests(7) should be grouped in the man section 7 group, not the section 8 group.

MFC r285119,r292502,r295380:

r285119 (by jmmv):

Add support for TEST_METADATA

Allow Makefiles to define generic metadata settings that apply to all test
programs defined by a Makefile. The generic TEST_METADATA variable extends
the per-test program settings already supported via TEST_METADATA.<program>.

This feature will be useful to easily apply some settings to all programs
in a directory. In particular, Kyua 0.12 will support parallel execution
of test programs and a bunch of them will need to be tagged as is_exclusive
to indicate that they cannot be run in parallel with anything else due to
their side-effects. It will be reasonable to set this setting on whole
directories.

r292502:

Always expose LOCALBASE, not just when CROSS_TOOLCHAIN is defined

Instead of using which(1) to look for doxygen, look for it in <LOCALBASE>/bin .
$PATH gets mangled by make buildenv, etc so it's better to just be explicit
about the path if someone uses that for instance.

r295380:

Simplify running the FreeBSD test suite

Replace `make regress` (legacy test make target) and `make test` (incomplete
test make target added with the FreeBSD test suite) with make check as it's
consistent with other open source projects.

`make check` defaults to running tests from `.OBJDIR`, but can be overridden
with the `CHECKDIR` variable.

Add `make checkworld` target to simplify running the FreeBSD test suite from
`TESTSBASE` (i.e. the top-level tests directory), similar to buildworld.

Document `make check` and `make checkworld` in build(7).

Other minor changes:

- Rename intermediate file (`Kyuafile.auto`) to `Kyuafile` to simplify
`make check`.
- Remove terse warnings attached to `beforetest`/`aftertest`.
- Add kyua binary check to check target in suite.test.mk; error out if it's
not found

The MFC is [partly] contingent on other build related changes being MFCed.

X-MFC to: stable/10
Relnotes: yes

MFC r298759:

Clarify build(7) instructions for alternate object directory.

Bump .Dd per r276674

MFC r276483:

The variable used with install(1) for stripping should be STRIPBIN, not
STRIP_CMD

Reported by: lev

MFC r275908,r276309:

r275908:

Document STRIP_CMD in build(7) and note its importance with LOCAL_ITOOLS

Phabric: D1335
Reviewed by: brueffer
Sponsored by: EMC / Isilon Storage Division

r276309:

Bump .Dd for change done in r275908

Merge r267866 from head:
Drop references to updating over csup from build(7).

MFC r267599:

- Add a LOCAL_ITOOLS to allow adding additional tools required for the
installworld and distributeworld targets

PR: 179562

MFC r263812:

Update build(7) with LOCAL_* vars

Bump .Dd per r276674

MFC r276483:

The variable used with install(1) for stripping should be STRIPBIN, not
STRIP_CMD

Reported by: lev

MFC r275908,r276309:

r275908:

Document STRIP_CMD in build(7) and note its importance with LOCAL_ITOOLS

Phabric: D1335
Reviewed by: brueffer
Sponsored by: EMC / Isilon Storage Division

r276309:

Bump .Dd for change done in r275908

Merge r267866 from head:
Drop references to updating over csup from build(7).

MFC r267599:

- Add a LOCAL_ITOOLS to allow adding additional tools required for the
installworld and distributeworld targets

PR: 179562

MFC r263812:

Update build(7) with LOCAL_* vars