From bca311ad23314b58c8cec080b9afefde070f537a Mon Sep 17 00:00:00 2001
From: bdrewery <bdrewery@FreeBSD.org>
Date: Thu, 17 Sep 2015 05:01:04 +0000
Subject: [PATCH] Document NO_SILENT for META_MODE.

Reword and add some formatting as well.
---
 share/man/man5/src.conf.5          | 21 ++++++++++++++++-----
 tools/build/options/WITH_META_MODE | 19 +++++++++++++++----
 2 files changed, 31 insertions(+), 9 deletions(-)

diff --git a/share/man/man5/src.conf.5 b/share/man/man5/src.conf.5
index ee339cf870f3..731f85b75cb4 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 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 16e79ae1c511..b255777956bc 100644
--- 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