Document NO_SILENT for META_MODE.

Reword and add some formatting as well.

diff --git a/share/man/man5/src.conf.5 b/share/man/man5/src.conf.5
index ee339cf870f38131e666b9c4507820588bf990b4..731f85b75cb45699169de233ec72b4e629982d82 100644 (file)
--- 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 284708 2015-06-22 20:21:57Z sjg
 .\" $FreeBSD$
-.Dd August 16, 2015
+.Dd September 16, 2015
 .Dt SRC.CONF 5
 .Os
 .Sh NAME
@@ -883,11 +883,17 @@ The meta files can be useful for debugging.
 .\" from FreeBSD: head/tools/build/options/WITH_META_MODE 284708 2015-06-22 20:21:57Z sjg
 Enable building in meta mode.
 .Pp
-The build is driven by dirdeps.mk using DIRDEPS stored in
+The build is driven by dirdeps.mk using
+.Va DIRDEPS
+stored in
 Makefile.depend files found in each directory.
 .Pp
 The build can be started from anywhere, and behaves the same.
-The initial instance of make recursively reads DIRDEPS from Makefile.depend
+The initial instance of
+.Xr make 1 
+recursively reads
+.Va DIRDEPS
+from Makefile.depend
 computing a graph of tree dependencies from the current origin.
 See http://www.crufty.net/help/sjg/dirdeps.htm
 .Pp
@@ -898,8 +904,13 @@ the command line,
 as well as any command output.
 If
 .Xr filemon 4
-is available the meta file will also capture a record of syscalls
-used to produce the target.
+is available the meta file will also capture a record of files
+used to produce the target by tracking syscalls.
+.Pp
+The build will hide commands ran unless
+.Va NO_SILENT
+is defined.
+.Pp
 When set, it also enforces the following options:
 .Pp
 .Bl -item -compact

diff --git a/tools/build/options/WITH_META_MODE b/tools/build/options/WITH_META_MODE
index 16e79ae1c511d6fd8aea07b9ce0fd542c8956b86..b255777956bcac691d285ac7a55efcf7615732ad 100644 (file)
--- a/tools/build/options/WITH_META_MODE
+++ b/tools/build/options/WITH_META_MODE
@@ -1,11 +1,17 @@
 .\" $FreeBSD$
 Enable building in meta mode.
 .Pp
-The build is driven by dirdeps.mk using DIRDEPS stored in
+The build is driven by dirdeps.mk using
+.Va DIRDEPS
+stored in
 Makefile.depend files found in each directory.
 .Pp
 The build can be started from anywhere, and behaves the same.
-The initial instance of make recursively reads DIRDEPS from Makefile.depend
+The initial instance of
+.Xr make 1 
+recursively reads
+.Va DIRDEPS
+from Makefile.depend
 computing a graph of tree dependencies from the current origin.
 See http://www.crufty.net/help/sjg/dirdeps.htm
 .Pp
@@ -16,5 +22,10 @@ the command line,
 as well as any command output.
 If
 .Xr filemon 4
-is available the meta file will also capture a record of syscalls
-used to produce the target.
+is available the meta file will also capture a record of files
+used to produce the target by tracking syscalls.
+.Pp
+The build will hide commands ran unless
+.Va NO_SILENT
+is defined.
+.Pp