svn commit: r287904 - in head: share/man/man5 tools/build/options

[Bryan Drewery]

Author: bdrewery
Date: Thu Sep 17 05:01:04 2015
New Revision: 287904
URL: https://svnweb.freebsd.org/changeset/base/287904

Log:
  Document NO_SILENT for META_MODE.
  
  Reword and add some formatting as well.

Modified:
  head/share/man/man5/src.conf.5
  head/tools/build/options/WITH_META_MODE

Modified: head/share/man/man5/src.conf.5
==============================================================================
--- head/share/man/man5/src.conf.5	Thu Sep 17 04:54:49 2015	(r287903)
+++ head/share/man/man5/src.conf.5	Thu Sep 17 05:01:04 2015	(r287904)
@@ -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 debuggi
 .\" 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

Modified: head/tools/build/options/WITH_META_MODE
==============================================================================
--- head/tools/build/options/WITH_META_MODE	Thu Sep 17 04:54:49 2015	(r287903)
+++ head/tools/build/options/WITH_META_MODE	Thu Sep 17 05:01:04 2015	(r287904)
@@ -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