1 files changed, 49 insertions, 24 deletions
diff --git a/share/man/man5/src.conf.5 b/share/man/man5/src.conf.5
index e638803..e9326f2 100644
--- a/share/man/man5/src.conf.5
+++ b/share/man/man5/src.conf.5
@@ -1,7 +1,7 @@
 .\" DO NOT EDIT-- this file is automatically generated.
 .\" from FreeBSD: head/tools/build/options/makeman 292283 2015-12-15 18:42:30Z bdrewery
 .\" $FreeBSD$
-.Dd April 11, 2016
+.Dd April 14, 2016
 .Dt SRC.CONF 5
 .Os
 .Sh NAME
@@ -473,12 +473,12 @@ executable binary and shared library.
 .\" from FreeBSD: head/tools/build/options/WITHOUT_DICT 156932 2006-03-21 07:50:50Z ru
 Set to not build the Webster dictionary files.
 .It Va WITH_DIRDEPS_BUILD
-.\" from FreeBSD: head/tools/build/options/WITH_DIRDEPS_BUILD 297843 2016-04-12 03:37:42Z bdrewery
-Enable building in meta mode.
-This is an experimental build feature.
+.\" from FreeBSD: head/tools/build/options/WITH_DIRDEPS_BUILD 298007 2016-04-14 22:00:49Z bdrewery
+This is an experimental build system.
 For details see
 http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm.
-.Pp
+Build commands can be seen from the top-level with:
+.Dl make show-valid-targets
 The build is driven by dirdeps.mk using
 .Va DIRDEPS
 stored in
@@ -498,20 +498,16 @@ and child directories.
 .Va NO_DIRDEPS_BELOW
 will skip building any dirdeps and only build the current directory.
 .Pp
-As each target is made
-.Xr make 1
-produces a meta file which is used to capture (and compare)
-the command line,
-as well as any command output.
-If
-.Xr filemon 4
-is available the meta file will also capture a record of files
-used to produce the target by tracking syscalls.
+This also utilizes the
+.Va WITH_META_MODE
+logic for incremental builds.
 .Pp
 The build will hide commands ran unless
 .Va NO_SILENT
 is defined.
 .Pp
+Note that there is currently no mass install feature for this.
+.Pp
 When set, it also enforces the following options:
 .Pp
 .Bl -item -compact
@@ -821,11 +817,14 @@ Set to not build
 .\" from FreeBSD: head/tools/build/options/WITHOUT_INET_SUPPORT 221266 2011-04-30 17:58:28Z bz
 Set to build libraries, programs, and kernel modules without IPv4 support.
 .It Va WITHOUT_INSTALLLIB
-.\" from FreeBSD: head/tools/build/options/WITHOUT_INSTALLLIB 174497 2007-12-09 21:56:21Z dougb
+.\" from FreeBSD: head/tools/build/options/WITHOUT_INSTALLLIB 297941 2016-04-13 21:01:58Z bdrewery
 Set this if you do not want to install optional libraries.
 For example when creating a
 .Xr nanobsd 8
 image.
+.Bf -symbolic
+The option does not work for build targets.
+.Ef
 .It Va WITH_INSTALL_AS_USER
 .\" from FreeBSD: head/tools/build/options/WITH_INSTALL_AS_USER 238021 2012-07-02 20:24:01Z marcel
 Set to make install targets succeed for non-root users by installing
@@ -1059,19 +1058,48 @@ Set to not build utilities for manual pages,
 .Xr manctl 8 ,
 and related support files.
 .It Va WITH_META_MODE
-.\" from FreeBSD: head/tools/build/options/WITH_META_MODE 297844 2016-04-12 03:40:13Z bdrewery
-Create meta files when not doing DIRDEPS_BUILD.
+.\" from FreeBSD: head/tools/build/options/WITH_META_MODE 298007 2016-04-14 22:00:49Z bdrewery
+Creates
+.Xr make 1
+meta files when building, which can provide a reliable incremental build when
+using
+.Xr filemon 4 .
+The meta file is created in the OBJDIR as
+.Pa target.meta .
+These meta files track the command ran, its output, and the current directory.
 When the
 .Xr filemon 4
-module is loaded, dependencies will be tracked for all commands.
-If any command, its dependencies, or files it generates are missing then
-the target will be considered out-of-date and rebuilt.
+module is loaded, any files used by the commands executed will be tracked as
+dependencies for the target in its meta file.
+The target will be considered out-of-date and rebuilt if any of the following
+are true compared to the last build:
+.Bl -bullet -compact
+.It
+The command to execute changes.
+.It
+The current working directory changes.
+.It
+The target's meta file is missing.
+.It
+[requires
+.Xr filemon 4 ]
+Files read, executed or linked to are newer than the target.
+.It
+[requires
+.Xr filemon 4 ]
+Files read, written, executed or linked are missing.
+.El
 The meta files can also be useful for debugging.
 .Pp
 The build will hide commands ran unless
 .Va NO_SILENT
 is defined.
 .Pp
+The build operates as it normally would otherwise.
+This option originally invoked a different build system but that was renamed
+to
+.Va WITH_DIRDEPS_BUILD .
+.Pp
 This must be set in the environment, make command line, or
 .Pa /etc/src-env.conf ,
 not
@@ -1435,13 +1463,10 @@ and
 Set to not build or install
 .Xr timed 8 .
 .It Va WITHOUT_TOOLCHAIN
-.\" from FreeBSD: head/tools/build/options/WITHOUT_TOOLCHAIN 273172 2014-10-16 15:55:13Z brooks
+.\" from FreeBSD: head/tools/build/options/WITHOUT_TOOLCHAIN 297939 2016-04-13 20:55:05Z bdrewery
 Set to not install header or
 programs used for program development,
 compilers, debuggers etc.
-.Bf -symbolic
-The option does not work for build targets.
-.Ef
 When set, it also enforces the following options:
 .Pp
 .Bl -item -compact